Note: You are viewing the documentation for an older major version of the AWS CLI (version 1).

AWS CLI version 2, the latest major version of AWS CLI, is now stable and recommended for general use. To view this page for the AWS CLI version 2, click here. For more information see the AWS CLI version 2 installation instructions and migration guide.

[ aws . datasync ]



Returns metadata, such as bucket name, about an Amazon S3 bucket location.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.


--location-arn <value>
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]


--location-arn (string)

The Amazon Resource Name (ARN) of the Amazon S3 bucket location to describe.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.


LocationArn -> (string)

The Amazon Resource Name (ARN) of the Amazon S3 bucket or access point.

LocationUri -> (string)

The URL of the Amazon S3 location that was described.

S3StorageClass -> (string)

The Amazon S3 storage class that you chose to store your files in when this location is used as a task destination. 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 .

S3Config -> (structure)

The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role used to access an Amazon S3 bucket.

For detailed information about using such a role, see Creating a Location for Amazon S3 in the DataSync User Guide .

BucketAccessRoleArn -> (string)

The ARN of the IAM role for accessing the S3 bucket.

AgentArns -> (list)

If you are using DataSync on an Amazon Web Services Outpost, the Amazon Resource Name (ARNs) of the EC2 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 .


CreationTime -> (timestamp)

The time that the Amazon S3 bucket location was created.