amazonka-ec2-2.0: Amazon Elastic Compute Cloud SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.EC2.DescribeBundleTasks

Description

Describes the specified bundle tasks or all of your bundle tasks.

Completed bundle tasks are listed for only a limited time. If your bundle task is no longer in the list, you can still register an AMI from it. Just use RegisterImage with the Amazon S3 bucket name and image manifest name you provided to the bundle task.

Synopsis

Creating a Request

data DescribeBundleTasks Source #

See: newDescribeBundleTasks smart constructor.

Constructors

DescribeBundleTasks' 

Fields

  • bundleIds :: Maybe [Text]

    The bundle task IDs.

    Default: Describes all your bundle tasks.

  • dryRun :: Maybe Bool

    Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

  • filters :: Maybe [Filter]

    The filters.

    • bundle-id - The ID of the bundle task.
    • error-code - If the task failed, the error code returned.
    • error-message - If the task failed, the error message returned.
    • instance-id - The ID of the instance.
    • progress - The level of task completion, as a percentage (for example, 20%).
    • s3-bucket - The Amazon S3 bucket to store the AMI.
    • s3-prefix - The beginning of the AMI name.
    • start-time - The time the task started (for example, 2013-09-15T17:15:20.000Z).
    • state - The state of the task (pending | waiting-for-shutdown | bundling | storing | cancelling | complete | failed).
    • update-time - The time of the most recent update for the task.

Instances

Instances details
ToHeaders DescribeBundleTasks Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

Methods

toHeaders :: DescribeBundleTasks -> [Header] #

ToPath DescribeBundleTasks Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

Methods

toPath :: DescribeBundleTasks -> ByteString #

ToQuery DescribeBundleTasks Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

Methods

toQuery :: DescribeBundleTasks -> QueryString #

AWSRequest DescribeBundleTasks Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

Associated Types

type AWSResponse DescribeBundleTasks #

Methods

request :: (Service -> Service) -> DescribeBundleTasks -> Request DescribeBundleTasks #

response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy DescribeBundleTasks -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse DescribeBundleTasks))) #

Generic DescribeBundleTasks Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

Associated Types

type Rep DescribeBundleTasks :: Type -> Type #

Methods

from :: DescribeBundleTasks -> Rep DescribeBundleTasks x #

to :: Rep DescribeBundleTasks x -> DescribeBundleTasks #

Read DescribeBundleTasks Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

Methods

readsPrec :: Int -> ReadS DescribeBundleTasks #

readList :: ReadS [DescribeBundleTasks] #

readPrec :: ReadPrec DescribeBundleTasks #

readListPrec :: ReadPrec [DescribeBundleTasks] #

Show DescribeBundleTasks Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

Methods

showsPrec :: Int -> DescribeBundleTasks -> ShowS #

show :: DescribeBundleTasks -> String #

showList :: [DescribeBundleTasks] -> ShowS #

NFData DescribeBundleTasks Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

Methods

rnf :: DescribeBundleTasks -> () #

Eq DescribeBundleTasks Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

Methods

(==) :: DescribeBundleTasks -> DescribeBundleTasks -> Bool #

(/=) :: DescribeBundleTasks -> DescribeBundleTasks -> Bool #

Hashable DescribeBundleTasks Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

Methods

hashWithSalt :: Int -> DescribeBundleTasks -> Int #

hash :: DescribeBundleTasks -> Int #

type AWSResponse DescribeBundleTasks Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

type AWSResponse DescribeBundleTasks = DescribeBundleTasksResponse
type Rep DescribeBundleTasks Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

type Rep DescribeBundleTasks = D1 ('MetaData "DescribeBundleTasks" "Amazonka.EC2.DescribeBundleTasks" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "DescribeBundleTasks'" 'PrefixI 'True) (S1 ('MetaSel ('Just "bundleIds") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])) :*: (S1 ('MetaSel ('Just "dryRun") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "filters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Filter])))))

newDescribeBundleTasks :: DescribeBundleTasks Source #

Create a value of DescribeBundleTasks with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:bundleIds:DescribeBundleTasks', describeBundleTasks_bundleIds - The bundle task IDs.

Default: Describes all your bundle tasks.

$sel:dryRun:DescribeBundleTasks', describeBundleTasks_dryRun - Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

$sel:filters:DescribeBundleTasks', describeBundleTasks_filters - The filters.

  • bundle-id - The ID of the bundle task.
  • error-code - If the task failed, the error code returned.
  • error-message - If the task failed, the error message returned.
  • instance-id - The ID of the instance.
  • progress - The level of task completion, as a percentage (for example, 20%).
  • s3-bucket - The Amazon S3 bucket to store the AMI.
  • s3-prefix - The beginning of the AMI name.
  • start-time - The time the task started (for example, 2013-09-15T17:15:20.000Z).
  • state - The state of the task (pending | waiting-for-shutdown | bundling | storing | cancelling | complete | failed).
  • update-time - The time of the most recent update for the task.

Request Lenses

describeBundleTasks_bundleIds :: Lens' DescribeBundleTasks (Maybe [Text]) Source #

The bundle task IDs.

Default: Describes all your bundle tasks.

describeBundleTasks_dryRun :: Lens' DescribeBundleTasks (Maybe Bool) Source #

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

describeBundleTasks_filters :: Lens' DescribeBundleTasks (Maybe [Filter]) Source #

The filters.

  • bundle-id - The ID of the bundle task.
  • error-code - If the task failed, the error code returned.
  • error-message - If the task failed, the error message returned.
  • instance-id - The ID of the instance.
  • progress - The level of task completion, as a percentage (for example, 20%).
  • s3-bucket - The Amazon S3 bucket to store the AMI.
  • s3-prefix - The beginning of the AMI name.
  • start-time - The time the task started (for example, 2013-09-15T17:15:20.000Z).
  • state - The state of the task (pending | waiting-for-shutdown | bundling | storing | cancelling | complete | failed).
  • update-time - The time of the most recent update for the task.

Destructuring the Response

data DescribeBundleTasksResponse Source #

See: newDescribeBundleTasksResponse smart constructor.

Constructors

DescribeBundleTasksResponse' 

Fields

Instances

Instances details
Generic DescribeBundleTasksResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

Associated Types

type Rep DescribeBundleTasksResponse :: Type -> Type #

Methods

from :: DescribeBundleTasksResponse -> Rep DescribeBundleTasksResponse x #

to :: Rep DescribeBundleTasksResponse x -> DescribeBundleTasksResponse #

Read DescribeBundleTasksResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

Methods

readsPrec :: Int -> ReadS DescribeBundleTasksResponse #

readList :: ReadS [DescribeBundleTasksResponse] #

readPrec :: ReadPrec DescribeBundleTasksResponse #

readListPrec :: ReadPrec [DescribeBundleTasksResponse] #

Show DescribeBundleTasksResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

Methods

showsPrec :: Int -> DescribeBundleTasksResponse -> ShowS #

show :: DescribeBundleTasksResponse -> String #

showList :: [DescribeBundleTasksResponse] -> ShowS #

NFData DescribeBundleTasksResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

Methods

rnf :: DescribeBundleTasksResponse -> () #

Eq DescribeBundleTasksResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

Methods

(==) :: DescribeBundleTasksResponse -> DescribeBundleTasksResponse -> Bool #

(/=) :: DescribeBundleTasksResponse -> DescribeBundleTasksResponse -> Bool #

type Rep DescribeBundleTasksResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeBundleTasks

type Rep DescribeBundleTasksResponse = D1 ('MetaData "DescribeBundleTasksResponse" "Amazonka.EC2.DescribeBundleTasks" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "DescribeBundleTasksResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "bundleTasks") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [BundleTask])) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newDescribeBundleTasksResponse Source #

Arguments

:: Int

$sel:httpStatus:DescribeBundleTasksResponse'

-> DescribeBundleTasksResponse 

Create a value of DescribeBundleTasksResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:bundleTasks:DescribeBundleTasksResponse', describeBundleTasksResponse_bundleTasks - Information about the bundle tasks.

$sel:httpStatus:DescribeBundleTasksResponse', describeBundleTasksResponse_httpStatus - The response's http status code.

Response Lenses

describeBundleTasksResponse_bundleTasks :: Lens' DescribeBundleTasksResponse (Maybe [BundleTask]) Source #

Information about the bundle tasks.

describeBundleTasksResponse_httpStatus :: Lens' DescribeBundleTasksResponse Int Source #

The response's http status code.