libZSservicesZSamazonka-datasyncZSamazonka-datasync
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.DataSync.CreateLocationS3

Description

Creates an endpoint for an Amazon S3 bucket.

For more information, see Create an Amazon S3 location in the DataSync User Guide.

Synopsis

Creating a Request

data CreateLocationS3 Source #

CreateLocationS3Request

See: newCreateLocationS3 smart constructor.

Constructors

CreateLocationS3' 

Fields

  • agentArns :: Maybe (NonEmpty Text)

    If you are using DataSync on an Amazon Web Services Outpost, specify the Amazon Resource Names (ARNs) of the DataSync agents deployed on your Outpost. For more information about launching a DataSync agent on an Amazon Web Services Outpost, see Deploy your DataSync agent on Outposts.

  • s3StorageClass :: Maybe S3StorageClass

    The Amazon S3 storage class that you want to store your files in when this location is used as a task destination. For buckets in Amazon Web Services Regions, the storage class defaults to Standard. For buckets on Outposts, the storage class defaults to Amazon Web Services S3 Outposts.

    For more information about S3 storage classes, see Amazon S3 Storage Classes. Some storage classes have behaviors that can affect your S3 storage cost. For detailed information, see Considerations when working with S3 storage classes in DataSync.

  • subdirectory :: Maybe Text

    A subdirectory in the Amazon S3 bucket. This subdirectory in Amazon S3 is used to read data from the S3 source location or write data to the S3 destination.

  • tags :: Maybe [TagListEntry]

    The key-value pair that represents the tag that you want to add to the location. The value can be an empty string. We recommend using tags to name your resources.

  • s3BucketArn :: Text

    The ARN of the Amazon S3 bucket. If the bucket is on an Amazon Web Services Outpost, this must be an access point ARN.

  • s3Config :: S3Config
     

Instances

Instances details
Eq CreateLocationS3 Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

Read CreateLocationS3 Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

Show CreateLocationS3 Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

Generic CreateLocationS3 Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

Associated Types

type Rep CreateLocationS3 :: Type -> Type #

NFData CreateLocationS3 Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

Methods

rnf :: CreateLocationS3 -> () #

Hashable CreateLocationS3 Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

ToJSON CreateLocationS3 Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

AWSRequest CreateLocationS3 Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

Associated Types

type AWSResponse CreateLocationS3 #

ToHeaders CreateLocationS3 Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

ToPath CreateLocationS3 Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

ToQuery CreateLocationS3 Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

type Rep CreateLocationS3 Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

type Rep CreateLocationS3 = D1 ('MetaData "CreateLocationS3" "Amazonka.DataSync.CreateLocationS3" "libZSservicesZSamazonka-datasyncZSamazonka-datasync" 'False) (C1 ('MetaCons "CreateLocationS3'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "agentArns") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (NonEmpty Text))) :*: (S1 ('MetaSel ('Just "s3StorageClass") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe S3StorageClass)) :*: S1 ('MetaSel ('Just "subdirectory") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: (S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [TagListEntry])) :*: (S1 ('MetaSel ('Just "s3BucketArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "s3Config") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 S3Config)))))
type AWSResponse CreateLocationS3 Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

newCreateLocationS3 Source #

Create a value of CreateLocationS3 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:agentArns:CreateLocationS3', createLocationS3_agentArns - If you are using DataSync on an Amazon Web Services Outpost, specify the Amazon Resource Names (ARNs) of the DataSync agents deployed on your Outpost. For more information about launching a DataSync agent on an Amazon Web Services Outpost, see Deploy your DataSync agent on Outposts.

$sel:s3StorageClass:CreateLocationS3', createLocationS3_s3StorageClass - The Amazon S3 storage class that you want to store your files in when this location is used as a task destination. For buckets in Amazon Web Services Regions, the storage class defaults to Standard. For buckets on Outposts, the storage class defaults to Amazon Web Services S3 Outposts.

For more information about S3 storage classes, see Amazon S3 Storage Classes. Some storage classes have behaviors that can affect your S3 storage cost. For detailed information, see Considerations when working with S3 storage classes in DataSync.

$sel:subdirectory:CreateLocationS3', createLocationS3_subdirectory - A subdirectory in the Amazon S3 bucket. This subdirectory in Amazon S3 is used to read data from the S3 source location or write data to the S3 destination.

$sel:tags:CreateLocationS3', createLocationS3_tags - The key-value pair that represents the tag that you want to add to the location. The value can be an empty string. We recommend using tags to name your resources.

$sel:s3BucketArn:CreateLocationS3', createLocationS3_s3BucketArn - The ARN of the Amazon S3 bucket. If the bucket is on an Amazon Web Services Outpost, this must be an access point ARN.

$sel:s3Config:CreateLocationS3', createLocationS3_s3Config - Undocumented member.

Request Lenses

createLocationS3_agentArns :: Lens' CreateLocationS3 (Maybe (NonEmpty Text)) Source #

If you are using DataSync on an Amazon Web Services Outpost, specify the Amazon Resource Names (ARNs) of the DataSync agents deployed on your Outpost. For more information about launching a DataSync agent on an Amazon Web Services Outpost, see Deploy your DataSync agent on Outposts.

createLocationS3_s3StorageClass :: Lens' CreateLocationS3 (Maybe S3StorageClass) Source #

The Amazon S3 storage class that you want to store your files in when this location is used as a task destination. For buckets in Amazon Web Services Regions, the storage class defaults to Standard. For buckets on Outposts, the storage class defaults to Amazon Web Services S3 Outposts.

For more information about S3 storage classes, see Amazon S3 Storage Classes. Some storage classes have behaviors that can affect your S3 storage cost. For detailed information, see Considerations when working with S3 storage classes in DataSync.

createLocationS3_subdirectory :: Lens' CreateLocationS3 (Maybe Text) Source #

A subdirectory in the Amazon S3 bucket. This subdirectory in Amazon S3 is used to read data from the S3 source location or write data to the S3 destination.

createLocationS3_tags :: Lens' CreateLocationS3 (Maybe [TagListEntry]) Source #

The key-value pair that represents the tag that you want to add to the location. The value can be an empty string. We recommend using tags to name your resources.

createLocationS3_s3BucketArn :: Lens' CreateLocationS3 Text Source #

The ARN of the Amazon S3 bucket. If the bucket is on an Amazon Web Services Outpost, this must be an access point ARN.

Destructuring the Response

data CreateLocationS3Response Source #

CreateLocationS3Response

See: newCreateLocationS3Response smart constructor.

Constructors

CreateLocationS3Response' 

Fields

Instances

Instances details
Eq CreateLocationS3Response Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

Read CreateLocationS3Response Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

Show CreateLocationS3Response Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

Generic CreateLocationS3Response Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

Associated Types

type Rep CreateLocationS3Response :: Type -> Type #

NFData CreateLocationS3Response Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

type Rep CreateLocationS3Response Source # 
Instance details

Defined in Amazonka.DataSync.CreateLocationS3

type Rep CreateLocationS3Response = D1 ('MetaData "CreateLocationS3Response" "Amazonka.DataSync.CreateLocationS3" "libZSservicesZSamazonka-datasyncZSamazonka-datasync" 'False) (C1 ('MetaCons "CreateLocationS3Response'" 'PrefixI 'True) (S1 ('MetaSel ('Just "locationArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newCreateLocationS3Response Source #

Create a value of CreateLocationS3Response 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:locationArn:CreateLocationS3Response', createLocationS3Response_locationArn - The Amazon Resource Name (ARN) of the source Amazon S3 bucket location that is created.

$sel:httpStatus:CreateLocationS3Response', createLocationS3Response_httpStatus - The response's http status code.

Response Lenses

createLocationS3Response_locationArn :: Lens' CreateLocationS3Response (Maybe Text) Source #

The Amazon Resource Name (ARN) of the source Amazon S3 bucket location that is created.