/AWS1/CL_DSY=>CREATELOCATIONS3()
¶
About CreateLocationS3¶
Creates a transfer location for an Amazon S3 bucket. DataSync can use this location as a source or destination for transferring data.
Before you begin, make sure that you read the following topics:
For more information, see Configuring transfers with Amazon S3.
Method Signature¶
IMPORTING¶
Required arguments:¶
IV_S3BUCKETARN
TYPE /AWS1/DSYS3BUCKETARN
/AWS1/DSYS3BUCKETARN
¶
Specifies the ARN of the S3 bucket that you want to use as a location. (When creating your DataSync task later, you specify whether this location is a transfer source or destination.)
If your S3 bucket is located on an Outposts resource, you must specify an Amazon S3 access point. For more information, see Managing data access with Amazon S3 access points in the Amazon S3 User Guide.
IO_S3CONFIG
TYPE REF TO /AWS1/CL_DSYS3CONFIG
/AWS1/CL_DSYS3CONFIG
¶
S3Config
Optional arguments:¶
IV_SUBDIRECTORY
TYPE /AWS1/DSYS3SUBDIRECTORY
/AWS1/DSYS3SUBDIRECTORY
¶
Specifies a prefix in the S3 bucket that DataSync reads from or writes to (depending on whether the bucket is a source or destination location).
DataSync can't transfer objects with a prefix that begins with a slash (
/
) or includes//
,/./
, or/../
patterns. For example:
/photos
photos//2006/January
photos/./2006/February
photos/../2006/March
IV_S3STORAGECLASS
TYPE /AWS1/DSYS3STORAGECLASS
/AWS1/DSYS3STORAGECLASS
¶
Specifies the storage class that you want your objects to use when Amazon S3 is a transfer destination.
For buckets in Amazon Web Services Regions, the storage class defaults to
STANDARD
. For buckets on Outposts, the storage class defaults toOUTPOSTS
.For more information, see Storage class considerations with Amazon S3 transfers.
IT_AGENTARNS
TYPE /AWS1/CL_DSYAGENTARNLIST_W=>TT_AGENTARNLIST
TT_AGENTARNLIST
¶
(Amazon S3 on Outposts only) Specifies the Amazon Resource Name (ARN) of the DataSync agent on your Outpost.
For more information, see Deploy your DataSync agent on Outposts.
IT_TAGS
TYPE /AWS1/CL_DSYTAGLISTENTRY=>TT_INPUTTAGLIST
TT_INPUTTAGLIST
¶
Specifies labels that help you categorize, filter, and search for your Amazon Web Services resources. We recommend creating at least a name tag for your transfer location.