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.CreateStoreImageTask

Description

Stores an AMI as a single object in an Amazon S3 bucket.

To use this API, you must have the required permissions. For more information, see Permissions for storing and restoring AMIs using Amazon S3 in the Amazon EC2 User Guide.

For more information, see Store and restore an AMI using Amazon S3 in the Amazon EC2 User Guide.

Synopsis

Creating a Request

data CreateStoreImageTask Source #

See: newCreateStoreImageTask smart constructor.

Constructors

CreateStoreImageTask' 

Fields

  • 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.

  • s3ObjectTags :: Maybe [S3ObjectTag]

    The tags to apply to the AMI object that will be stored in the Amazon S3 bucket.

  • imageId :: Text

    The ID of the AMI.

  • bucket :: Text

    The name of the Amazon S3 bucket in which the AMI object will be stored. The bucket must be in the Region in which the request is being made. The AMI object appears in the bucket only after the upload task has completed.

Instances

Instances details
ToHeaders CreateStoreImageTask Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

Methods

toHeaders :: CreateStoreImageTask -> [Header] #

ToPath CreateStoreImageTask Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

Methods

toPath :: CreateStoreImageTask -> ByteString #

ToQuery CreateStoreImageTask Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

Methods

toQuery :: CreateStoreImageTask -> QueryString #

AWSRequest CreateStoreImageTask Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

Associated Types

type AWSResponse CreateStoreImageTask #

Methods

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

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

Generic CreateStoreImageTask Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

Associated Types

type Rep CreateStoreImageTask :: Type -> Type #

Methods

from :: CreateStoreImageTask -> Rep CreateStoreImageTask x #

to :: Rep CreateStoreImageTask x -> CreateStoreImageTask #

Read CreateStoreImageTask Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

Methods

readsPrec :: Int -> ReadS CreateStoreImageTask #

readList :: ReadS [CreateStoreImageTask] #

readPrec :: ReadPrec CreateStoreImageTask #

readListPrec :: ReadPrec [CreateStoreImageTask] #

Show CreateStoreImageTask Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

Methods

showsPrec :: Int -> CreateStoreImageTask -> ShowS #

show :: CreateStoreImageTask -> String #

showList :: [CreateStoreImageTask] -> ShowS #

NFData CreateStoreImageTask Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

Methods

rnf :: CreateStoreImageTask -> () #

Eq CreateStoreImageTask Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

Methods

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

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

Hashable CreateStoreImageTask Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

Methods

hashWithSalt :: Int -> CreateStoreImageTask -> Int #

hash :: CreateStoreImageTask -> Int #

type AWSResponse CreateStoreImageTask Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

type AWSResponse CreateStoreImageTask = CreateStoreImageTaskResponse
type Rep CreateStoreImageTask Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

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

newCreateStoreImageTask Source #

Arguments

:: Text

CreateStoreImageTask

-> Text

CreateStoreImageTask

-> CreateStoreImageTask 

Create a value of CreateStoreImageTask 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:dryRun:CreateStoreImageTask', createStoreImageTask_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:s3ObjectTags:CreateStoreImageTask', createStoreImageTask_s3ObjectTags - The tags to apply to the AMI object that will be stored in the Amazon S3 bucket.

CreateStoreImageTask, createStoreImageTask_imageId - The ID of the AMI.

CreateStoreImageTask, createStoreImageTask_bucket - The name of the Amazon S3 bucket in which the AMI object will be stored. The bucket must be in the Region in which the request is being made. The AMI object appears in the bucket only after the upload task has completed.

Request Lenses

createStoreImageTask_dryRun :: Lens' CreateStoreImageTask (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.

createStoreImageTask_s3ObjectTags :: Lens' CreateStoreImageTask (Maybe [S3ObjectTag]) Source #

The tags to apply to the AMI object that will be stored in the Amazon S3 bucket.

createStoreImageTask_imageId :: Lens' CreateStoreImageTask Text Source #

The ID of the AMI.

createStoreImageTask_bucket :: Lens' CreateStoreImageTask Text Source #

The name of the Amazon S3 bucket in which the AMI object will be stored. The bucket must be in the Region in which the request is being made. The AMI object appears in the bucket only after the upload task has completed.

Destructuring the Response

data CreateStoreImageTaskResponse Source #

See: newCreateStoreImageTaskResponse smart constructor.

Constructors

CreateStoreImageTaskResponse' 

Fields

Instances

Instances details
Generic CreateStoreImageTaskResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

Associated Types

type Rep CreateStoreImageTaskResponse :: Type -> Type #

Methods

from :: CreateStoreImageTaskResponse -> Rep CreateStoreImageTaskResponse x #

to :: Rep CreateStoreImageTaskResponse x -> CreateStoreImageTaskResponse #

Read CreateStoreImageTaskResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

Methods

readsPrec :: Int -> ReadS CreateStoreImageTaskResponse #

readList :: ReadS [CreateStoreImageTaskResponse] #

readPrec :: ReadPrec CreateStoreImageTaskResponse #

readListPrec :: ReadPrec [CreateStoreImageTaskResponse] #

Show CreateStoreImageTaskResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

Methods

showsPrec :: Int -> CreateStoreImageTaskResponse -> ShowS #

show :: CreateStoreImageTaskResponse -> String #

showList :: [CreateStoreImageTaskResponse] -> ShowS #

NFData CreateStoreImageTaskResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

Methods

rnf :: CreateStoreImageTaskResponse -> () #

Eq CreateStoreImageTaskResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

Methods

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

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

type Rep CreateStoreImageTaskResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateStoreImageTask

type Rep CreateStoreImageTaskResponse = D1 ('MetaData "CreateStoreImageTaskResponse" "Amazonka.EC2.CreateStoreImageTask" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "CreateStoreImageTaskResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "objectKey") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newCreateStoreImageTaskResponse Source #

Arguments

:: Int

$sel:httpStatus:CreateStoreImageTaskResponse'

-> CreateStoreImageTaskResponse 

Create a value of CreateStoreImageTaskResponse 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:objectKey:CreateStoreImageTaskResponse', createStoreImageTaskResponse_objectKey - The name of the stored AMI object in the S3 bucket.

$sel:httpStatus:CreateStoreImageTaskResponse', createStoreImageTaskResponse_httpStatus - The response's http status code.

Response Lenses

createStoreImageTaskResponse_objectKey :: Lens' CreateStoreImageTaskResponse (Maybe Text) Source #

The name of the stored AMI object in the S3 bucket.

createStoreImageTaskResponse_httpStatus :: Lens' CreateStoreImageTaskResponse Int Source #

The response's http status code.