Amazon S3 examples using AWS CLI

To abort the specified multipart upload

The following abort-multipart-upload example aborts a multipart upload for the key multipart/01 in the bucket amzn-s3-demo-bucket.

aws s3api abort-multipart-upload \
    --bucket amzn-s3-demo-bucket \
    --key multipart/01 \
    --upload-id dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R

This command produces no output.

The upload ID required by this command is output by create-multipart-upload and can also be retrieved with list-multipart-uploads.

For more information, see Aborting a multipart upload in the Amazon S3 User Guide.

To complete a multipart upload

The following complete-multipart-upload example completes a multipart upload for the key multipart/01 in the bucket amzn-s3-demo-bucket.

aws s3api complete-multipart-upload \
    --multipart-upload file://mpustruct \
    --bucket amzn-s3-demo-bucket \
    --key 'multipart/01' \
    --upload-id dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R

The upload ID required by this command is output by create-multipart-upload and can also be retrieved with list-multipart-uploads.

The multipart upload option in the above command takes a JSON structure that describes the parts of the multipart upload that should be reassembled into the complete file. In this example, the file:// prefix is used to load the JSON structure from a file in the local folder named mpustruct.

Contents of mpustruct:

{
    "Parts": [
        {
            "ETag": "e868e0f4719e394144ef36531ee6824c",
            "PartNumber": 1
        },
        {
            "ETag": "6bb2b12753d66fe86da4998aa33fffb0",
            "PartNumber": 2
        },
        {
            "ETag": "d0a0112e841abec9c9ec83406f0159c8",
            "PartNumber": 3
        }
    ]
}

The ETag value for each part is upload is output each time you upload a part using the upload-part command and can also be retrieved by calling list-parts or calculated by taking the MD5 checksum of each part.

Output:

{
    "ETag": "\"3944a9f7a4faab7f78788ff6210f63f0-3\"",
    "Bucket": "amzn-s3-demo-bucket",
    "Location": "https://amzn-s3-demo-bucket.s3.amazonaws.com/multipart%2F01",
    "Key": "multipart/01"
}

For more information, see Uploading and copying objects using multipart upload in Amazon S3 in the Amazon S3 User Guide.

To copy an object

The following copy-object example copies an object from bucket-1 to amzn-s3-demo-bucket2.

aws s3api copy-object \
    --copy-source bucket-1/test.txt \
    --key test.txt \
    --bucket amzn-s3-demo-bucket2

Output:

{
    "CopyObjectResult": {
        "LastModified": "2015-11-10T01:07:25.000Z",
        "ETag": "\"589c8b79c230a6ecd5a7e1d040a9a030\""
    },
    "VersionId": "YdnYvTCVDqRRFA.NFJjy36p0hxifMlkA"
}

For more information, see Copying, moving, and renaming objects in the Amazon S3 User Guide.

Example 1: To copy a local file to S3

The following cp example copies a single file to a specified bucket and key.

aws s3 cp test.txt s3://amzn-s3-demo-bucket/test2.txt

Output:

upload: test.txt to s3://amzn-s3-demo-bucket/test2.txt

Example 2: To copy a local file to S3 with an expiration date

The following cp example copies a single file to a specified bucket and key that expires at the specified ISO 8601 timestamp.

aws s3 cp test.txt s3://amzn-s3-demo-bucket/test2.txt \
    --expires 2014-10-01T20:30:00Z

Output:

upload: test.txt to s3://amzn-s3-demo-bucket/test2.txt

Example 3: To copy a file from S3 to S3

The following cp example copies a single S3 object to a specified bucket and key.

aws s3 cp s3://amzn-s3-demo-bucket/test.txt s3://amzn-s3-demo-bucket/test2.txt

Output:

copy: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket/test2.txt

Example 4: To copy an S3 object to a local file

The following cp example copies a single object to a specified file locally.

aws s3 cp s3://amzn-s3-demo-bucket/test.txt test2.txt

Output:

download: s3://amzn-s3-demo-bucket/test.txt to test2.txt

Example 5: To copy an S3 object from one bucket to another

The following cp example copies a single object to a specified bucket while retaining its original name.

aws s3 cp s3://amzn-s3-demo-bucket/test.txt s3://amzn-s3-demo-bucket2/

Output:

copy: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket2/test.txt

Example 6: To recursively copy S3 objects to a local directory

The following cp example recursively copies all objects under a specified prefix and bucket to a specified directory when passed with the parameter --recursive. In this example, the bucket amzn-s3-demo-bucket has the objects test1.txt and test2.txt.

aws s3 cp s3://amzn-s3-demo-bucket . \
    --recursive

Output:

download: s3://amzn-s3-demo-bucket/test1.txt to test1.txt
download: s3://amzn-s3-demo-bucket/test2.txt to test2.txt

Example 7: To recursively copy local files to S3

The following cp example recursively copies all files under a specified directory to a specified bucket and prefix when passed with the parameter --recursive, while excluding some files by using an --exclude parameter. In this example, the directory myDir has the files test1.txt and test2.jpg.

aws s3 cp myDir s3://amzn-s3-demo-bucket/ \
    --recursive \
    --exclude "*.jpg"

Output:

upload: myDir/test1.txt to s3://amzn-s3-demo-bucket/test1.txt

Example 8: To recursively copy S3 objects to another bucket

The following cp example recursively copies all objects under a specified bucket to another bucket when passed with the parameter --recursive, while excluding some objects by using an --exclude parameter. In this example, the bucket amzn-s3-demo-bucket has the objects test1.txt and another/test1.txt.

aws s3 cp s3://amzn-s3-demo-bucket/ s3://amzn-s3-demo-bucket2/ \
    --recursive \
    --exclude "another/*"

Output:

copy: s3://amzn-s3-demo-bucket/test1.txt to s3://amzn-s3-demo-bucket2/test1.txt

You can combine --exclude and --include options to copy only objects that match a pattern, excluding all others.

aws s3 cp s3://amzn-s3-demo-bucket/logs/ s3://amzn-s3-demo-bucket2/logs/ \
    --recursive \
    --exclude "*" \
    --include "*.log"

Output:

copy: s3://amzn-s3-demo-bucket/logs/test/test.log to s3://amzn-s3-demo-bucket2/logs/test/test.log
copy: s3://amzn-s3-demo-bucket/logs/test3.log to s3://amzn-s3-demo-bucket2/logs/test3.log

Example 9: To set the Access Control List (ACL) while copying an S3 object

The following cp example copies a single object to a specified bucket and key while setting the ACL to public-read-write.

aws s3 cp s3://amzn-s3-demo-bucket/test.txt s3://amzn-s3-demo-bucket/test2.txt \
    --acl public-read-write

Output:

copy: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket/test2.txt

Note that if you're using the --acl option, ensure that any associated IAM policies include the "s3:PutObjectAcl" action.

aws iam get-user-policy \
    --user-name myuser \
    --policy-name mypolicy

Output:

{
    "UserName": "myuser",
    "PolicyName": "mypolicy",
    "PolicyDocument": {
        "Version":"2012-10-17",
        "Statement": [
            {
                "Action": [
                    "s3:PutObject",
                    "s3:PutObjectAcl"
                ],
                "Resource": [
                    "arn:aws:s3:::amzn-s3-demo-bucket/*"
                ],
                "Effect": "Allow",
                "Sid": "Stmt1234567891234"
            }
        ]
    }
}

Example 10: To grant permissions for an S3 object

The following cp example uses the --grants option to grant read access to all users identified by URI and full control to a specific user identified by their Canonical ID.

aws s3 cp file.txt s3://amzn-s3-demo-bucket/ \
    --grants read=uri=http://acs.amazonaws.com/groups/global/AllUsers full=id=79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be

Output:

upload: file.txt to s3://amzn-s3-demo-bucket/file.txt

Example 11: To upload a local file stream to S3

The following cp example uploads a local file stream from standard input to a specified bucket and key.

aws s3 cp - s3://amzn-s3-demo-bucket/stream.txt

This command produces no output.

PowerShell may alter the encoding of or add a CRLF to piped input.

Example 12: To upload a local file stream that is larger than 50GB to S3

The following cp example uploads a 51GB local file stream from standard input to a specified bucket and key. The --expected-size option must be provided, or the upload may fail when it reaches the default part limit of 10,000.

aws s3 cp - s3://amzn-s3-demo-bucket/stream.txt \
    --expected-size 54760833024

This command produces no output.

Example 13: To download an S3 object as a local file stream

The following cp example downloads an S3 object locally as a stream to standard output. Downloading as a stream is not currently compatible with the --recursive parameter.

aws s3 cp s3://amzn-s3-demo-bucket/stream.txt -

PowerShell may alter the encoding of or add a CRLF to piped or redirected output.

Example 14: To upload to an S3 access point

The following cp example uploads a single file (mydoc.txt) to the access point (myaccesspoint) at the key (mykey).

aws s3 cp mydoc.txt s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey

Output:

upload: mydoc.txt to s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey

Example 15: To download from an S3 access point

The following cp example downloads a single object (mykey) from the access point (myaccesspoint) to the local file (mydoc.txt).

aws s3 cp s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey mydoc.txt

Output:

download: s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey to mydoc.txt

For more information, see Using high-level (s3) commands in the AWS CLI in the AWS CLI User Guide.

Example 1: To create a bucket

The following create-bucket example creates a bucket named amzn-s3-demo-bucket.

aws s3api create-bucket \
    --bucket amzn-s3-demo-bucket \
    --region us-east-1

Output:

{
    "Location": "/amzn-s3-demo-bucket"
}

For more information, see Creating a bucket in the Amazon S3 User Guide.

Example 2: To create a bucket with owner enforced

The following create-bucket example creates a bucket named amzn-s3-demo-bucket that uses the bucket owner enforced setting for S3 Object Ownership.

aws s3api create-bucket \
    --bucket amzn-s3-demo-bucket \
    --region us-east-1 \
    --object-ownership BucketOwnerEnforced

Output:

{
    "Location": "/amzn-s3-demo-bucket"
}

For more information, see Controlling ownership of objects and disabling ACLs in the Amazon S3 User Guide.

Example 3: To create a bucket outside of the ``us-east-1`` region

The following create-bucket example creates a bucket named amzn-s3-demo-bucket in the us-west-2 region. Regions outside of us-east-1 require the appropriate LocationConstraint to be specified in order to create the bucket in the desired region.

aws s3api create-bucket \
    --bucket amzn-s3-demo-bucket \
    --region us-west-2 \
    --create-bucket-configuration LocationConstraint=us-west-2

Output:

{
    "Location": "http://amzn-s3-demo-bucket.s3.amazonaws.com/"
}

For more information, see Creating a bucket in the Amazon S3 User Guide.

To create a multipart upload

The following create-multipart-upload example creates a multipart upload in the bucket amzn-s3-demo-bucket with the key multipart/01.

aws s3api create-multipart-upload \
    --bucket amzn-s3-demo-bucket \
    --key 'multipart/01'

Output:

{
    "Bucket": "amzn-s3-demo-bucket",
    "UploadId": "dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R",
    "Key": "multipart/01"
}

The completed file will be named 01 in a folder called multipart in the bucket amzn-s3-demo-bucket. Save the upload ID, key and bucket name for use with the upload-part command.

For more information, see Uploading and copying objects using multipart upload in Amazon S3 in the Amazon S3 User Guide.

To delete an analytics configuration for a bucket

The following delete-bucket-analytics-configuration example removes the analytics configuration for the specified bucket and ID.

aws s3api delete-bucket-analytics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 1

This command produces no output.

For more information, see Amazon S3 analytics - Storage Class Analysis in the Amazon S3 User Guide.

To delete the CORS configuration of a bucket

The following delete-bucket-cors example deletes a Cross-Origin Resource Sharing configuration from a bucket named amzn-s3-demo-bucket.

aws s3api delete-bucket-cors \
    --bucket amzn-s3-demo-bucket

This command produces no output.

For more information, see Using cross-origin resource sharing (CORS) in the Amazon S3 User Guide.

To delete the server-side encryption configuration of a bucket

The following delete-bucket-encryption example deletes the server-side encryption configuration of the specified bucket.

aws s3api delete-bucket-encryption \
    --bucket amzn-s3-demo-bucket

This command produces no output.

For more information, see Setting default server-side encryption behavior for Amazon S3 buckets in the Amazon S3 User Guide.

To remove an S3 Intelligent-Tiering configuration on a bucket

The following delete-bucket-intelligent-tiering-configuration example removes an S3 Intelligent-Tiering configuration, named ExampleConfig, on a bucket.

aws s3api delete-bucket-intelligent-tiering-configuration \
    --bucket amzn-s3-demo-bucket \
    --id ExampleConfig

This command produces no output.

For more information, see Using S3 Intelligent-Tiering in the Amazon S3 User Guide.

To delete the inventory configuration of a bucket

The following delete-bucket-inventory-configuration example deletes the inventory configuration with ID 1 for the specified bucket.

aws s3api delete-bucket-inventory-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 1

This command produces no output.

For more information, see Cataloging and analyzing your data with S3 Inventory in the Amazon S3 User Guide.

To delete the lifecycle configuration of a bucket

The following delete-bucket-lifecycle example deletes a lifecycle configuration from a bucket named amzn-s3-demo-bucket.

aws s3api delete-bucket-lifecycle \
    --bucket amzn-s3-demo-bucket

This command produces no output.

For more information, see Managing the lifecycle of objects in the Amazon S3 User Guide.

To delete a metrics configuration for a bucket

The following delete-bucket-metrics-configuration example removes the metrics configuration for the specified bucket and ID.

aws s3api delete-bucket-metrics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 123

This command produces no output.

For more information, see CloudWatch metrics configurations in the Amazon S3 User Guide.

To remove the bucket ownership settings of a bucket

The following delete-bucket-ownership-controls example removes the bucket ownership settings of a bucket.

aws s3api delete-bucket-ownership-controls \
    --bucket amzn-s3-demo-bucket

This command produces no output.

For more information, see Setting Object Ownership on an existing bucket in the Amazon S3 User Guide.

To delete a bucket policy

The following delete-bucket-policy example deletes a bucket policy from a bucket named amzn-s3-demo-bucket.

aws s3api delete-bucket-policy \
    --bucket amzn-s3-demo-bucket

This command produces no output.

For more information, see Bucket policies for Amazon S3 in the Amazon S3 User Guide.

To delete the replication configuration of a bucket

The following delete-bucket-replication example deletes a replication configuration from a bucket named amzn-s3-demo-bucket.

aws s3api delete-bucket-replication \
    --bucket amzn-s3-demo-bucket

This command produces no output.

For more information, see Replicating objects within and across Regions in the Amazon S3 User Guide.

To delete the tagging configuration of a bucket

The following delete-bucket-tagging example deletes a tagging configuration from a bucket named amzn-s3-demo-bucket.

aws s3api delete-bucket-tagging \
    --bucket amzn-s3-demo-bucket

This command produces no output.

For more information, see Using cost allocation S3 bucket tags in the Amazon S3 User Guide.

To delete the website configuration of a bucket

The following delete-bucket-website example deletes a website configuration from a bucket named amzn-s3-demo-bucket.

aws s3api delete-bucket-website \
    --bucket amzn-s3-demo-bucket

This command produces no output.

For more information, see Hosting a static website using Amazon S3 in the Amazon S3 User Guide.

To delete a bucket

The following delete-bucket example deletes a bucket named amzn-s3-demo-bucket.

aws s3api delete-bucket \
    --bucket amzn-s3-demo-bucket

This command produces no output.

For more information, see Deleting a general purpose bucket in the Amazon S3 User Guide.

To delete the tag sets of an object

The following delete-object-tagging example deletes the tag with the specified key from the object doc1.rtf.

aws s3api delete-object-tagging \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf

This command produces no output.

For more information, see Tagging your objects in the Amazon S3 User Guide.

To delete an object

The following delete-object example deletes an object named test.txt from a bucket named amzn-s3-demo-bucket.

aws s3api delete-object \
    --bucket amzn-s3-demo-bucket \
    --key test.txt

If bucket versioning is enabled, the output contains the version ID of the delete marker.

Output:

{
    "VersionId": "9_gKg5vG56F.TTEUdwkxGpJ3tNDlWlGq",
    "DeleteMarker": true
}

For more information, see Deleting a single object in the Amazon S3 User Guide.

To delete an object by using a JSON file

The following delete-objects example deletes an object from a bucket named amzn-s3-demo-bucket.

aws s3api delete-objects \
    --bucket amzn-s3-demo-bucket \
    --delete file://delete.json

The file delete.json is a JSON document in the current directory that specifies the object to delete.

Contents of delete.json:

{
    "Objects": [
        {
            "Key": "test1.txt"
        }
    ],
    "Quiet": false
}

Output:

{
    "Deleted": [
        {
            "DeleteMarkerVersionId": "mYAT5Mc6F7aeUL8SS7FAAqUPO1koHwzU",
            "Key": "test1.txt",
            "DeleteMarker": true
        }
    ]
}

For more information, see Deleting multiple objects in the Amazon S3 User Guide.

To delete the block public access configuration for a bucket

The following delete-public-access-block example removes the block public access configuration on the specified bucket.

aws s3api delete-public-access-block \
    --bucket amzn-s3-demo-bucket

This command produces no output.

For more information, see Blocking public access to your Amazon S3 storage in the Amazon S3 User Guide.

To retrieve the accelerate configuration of a bucket

The following get-bucket-accelerate-configuration example retrieves the accelerate configuration for the specified bucket.

aws s3api get-bucket-accelerate-configuration \
    --bucket amzn-s3-demo-bucket

Output:

{
    "Status": "Enabled"
}

For more information, see Configuring fast, secure file transfers using Amazon S3 Transfer Acceleration in the Amazon S3 User Guide.

To retrieve the access control list of a bucket

The following get-bucket-acl example retrieves the access control list for a bucket named amzn-s3-demo-bucket.

aws s3api get-bucket-acl \
    --bucket amzn-s3-demo-bucket

Output:

{
    "Owner": {
        "DisplayName": "my-username",
        "ID": "7009a8971cd538e11f6b6606438875e7c86c5b672f46db45460ddcd087d36c32"
    },
    "Grants": [
        {
            "Grantee": {
                "DisplayName": "my-username",
                "ID": "7009a8971cd538e11f6b6606438875e7c86c5b672f46db45460ddcd087d36c32"
            },
            "Permission": "FULL_CONTROL"
        }
    ]
}

For more information, see Access control list (ACL) overview in the Amazon S3 User Guide.

To retrieve the analytics configuration for a bucket with a specific ID

The following get-bucket-analytics-configuration example displays the analytics configuration for the specified bucket and ID.

aws s3api get-bucket-analytics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 1

Output:

{
    "AnalyticsConfiguration": {
        "StorageClassAnalysis": {},
        "Id": "1"
    }
}

For more information, see Amazon S3 analytics - Storage Class Analysis in the Amazon S3 User Guide.

To retrieve the CORS configuration of a bucket

The following get-bucket-cors example retrieves the Cross-Origin Resource Sharing configuration for a bucket named amzn-s3-demo-bucket.

aws s3api get-bucket-cors \
    --bucket amzn-s3-demo-bucket

Output:

{
    "CORSRules": [
        {
            "AllowedHeaders": [
                "*"
            ],
            "ExposeHeaders": [
                "x-amz-server-side-encryption"
            ],
            "AllowedMethods": [
                "PUT",
                "POST",
                "DELETE"
            ],
            "MaxAgeSeconds": 3000,
            "AllowedOrigins": [
                "http://www.example.com"
            ]
        },
        {
            "AllowedHeaders": [
                "Authorization"
            ],
            "MaxAgeSeconds": 3000,
            "AllowedMethods": [
                "GET"
            ],
            "AllowedOrigins": [
                "*"
            ]
        }
    ]
}

For more information, see Using cross-origin resource sharing (CORS) in the Amazon S3 User Guide.

To retrieve the server-side encryption configuration for a bucket

The following get-bucket-encryption example retrieves the server-side encryption configuration for the bucket amzn-s3-demo-bucket.

aws s3api get-bucket-encryption \
    --bucket amzn-s3-demo-bucket

Output:

{
    "ServerSideEncryptionConfiguration": {
        "Rules": [
            {
                "ApplyServerSideEncryptionByDefault": {
                    "SSEAlgorithm": "AES256"
                }
            }
        ]
    }
}

For more information, see Setting default server-side encryption behavior for Amazon S3 buckets in the Amazon S3 User Guide.

To retrieve an S3 Intelligent-Tiering configuration on a bucket

The following get-bucket-intelligent-tiering-configuration example retrieves an S3 Intelligent-Tiering configuration, named ExampleConfig, on a bucket.

aws s3api get-bucket-intelligent-tiering-configuration \
    --bucket amzn-s3-demo-bucket \
    --id ExampleConfig

Output:

{
    "IntelligentTieringConfiguration": {
        "Id": "ExampleConfig2",
        "Filter": {
            "Prefix": "images"
        },
        "Status": "Enabled",
        "Tierings": [
            {
                "Days": 90,
                "AccessTier": "ARCHIVE_ACCESS"
            },
            {
                "Days": 180,
                "AccessTier": "DEEP_ARCHIVE_ACCESS"
            }
        ]
    }
}

For more information, see Using S3 Intelligent-Tiering in the Amazon S3 User Guide.

To retrieve the inventory configuration for a bucket

The following get-bucket-inventory-configuration example retrieves the inventory configuration for the specified bucket with ID 1.

aws s3api get-bucket-inventory-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 1

Output:

{
    "InventoryConfiguration": {
        "IsEnabled": true,
        "Destination": {
            "S3BucketDestination": {
                "Format": "ORC",
                "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket",
                "AccountId": "123456789012"
            }
        },
        "IncludedObjectVersions": "Current",
        "Id": "1",
        "Schedule": {
            "Frequency": "Weekly"
        }
    }
}

For more information, see Cataloging and analyzing your data with S3 Inventory in the Amazon S3 User Guide.

To retrieve the lifecycle configuration of a bucket

The following get-bucket-lifecycle-configuration example retrieves the lifecycle configuration for a bucket named amzn-s3-demo-bucket.

aws s3api get-bucket-lifecycle-configuration \
    --bucket amzn-s3-demo-bucket

Output:

{
    "Rules": [
        {
            "ID": "Move rotated logs to Glacier",
            "Prefix": "rotated/",
            "Status": "Enabled",
            "Transitions": [
                {
                    "Date": "2015-11-10T00:00:00.000Z",
                    "StorageClass": "GLACIER"
                }
            ]
        },
        {
            "Status": "Enabled",
            "Prefix": "",
            "NoncurrentVersionTransitions": [
                {
                    "NoncurrentDays": 0,
                    "StorageClass": "GLACIER"
                }
            ],
            "ID": "Move old versions to Glacier"
        }
    ]
}

For more information, see Managing the lifecycle of objects in the Amazon S3 User Guide.

To retrieve the lifecycle configuration of a bucket

The following get-bucket-lifecycle example retrieves the lifecycle configuration for a bucket named amzn-s3-demo-bucket.

aws s3api get-bucket-lifecycle \
    --bucket amzn-s3-demo-bucket

Output:

{
    "Rules": [
        {
            "ID": "Move to Glacier after sixty days (objects in logs/2015/)",
            "Prefix": "logs/2015/",
            "Status": "Enabled",
            "Transition": {
                "Days": 60,
                "StorageClass": "GLACIER"
            }
        },
        {
            "Expiration": {
                "Date": "2016-01-01T00:00:00.000Z"
            },
            "ID": "Delete 2014 logs in 2016.",
            "Prefix": "logs/2014/",
            "Status": "Enabled"
        }
    ]
}

For more information, see Managing the lifecycle of objects in the Amazon S3 User Guide.

To retrieve the location constraint of a bucket

The following get-bucket-location example retrieves the location constraint for a bucket named amzn-s3-demo-bucket, if a constraint exists.

aws s3api get-bucket-location \
    --bucket amzn-s3-demo-bucket

Output:

{
    "LocationConstraint": "us-west-2"
}

For more information, see General purpose buckets overview in the Amazon S3 User Guide.

To retrieve the logging status for a bucket

The following get-bucket-logging example retrieves the logging status for the specified bucket.

aws s3api get-bucket-logging \
    --bucket amzn-s3-demo-bucket

Output:

{
    "LoggingEnabled": {
        "TargetPrefix": "",
        "TargetBucket": "amzn-s3-demo-bucket-logs"
    }
}

For more information, see Logging requests with server access logging in the Amazon S3 User Guide.

To retrieve the metrics configuration for a bucket with a specific ID

The following get-bucket-metrics-configuration example displays the metrics configuration for the specified bucket and ID.

aws s3api get-bucket-metrics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 123

Output:

{
    "MetricsConfiguration": {
        "Filter": {
            "Prefix": "logs"
        },
        "Id": "123"
    }
}

For more information, see CloudWatch metrics configurations in the Amazon S3 User Guide.

To retrieve the notification configuration of a bucket

The following get-bucket-notification-configuration example retrieves the notification configuration for a bucket named amzn-s3-demo-bucket.

aws s3api get-bucket-notification-configuration \
    --bucket amzn-s3-demo-bucket

Output:

{
    "TopicConfigurations": [
        {
            "Id": "YmQzMmEwM2EjZWVlI0NGItNzVtZjI1MC00ZjgyLWZDBiZWNl",
            "TopicArn": "arn:aws:sns:us-west-2:123456789012:my-notification-topic",
            "Events": [
                "s3:ObjectCreated:*"
            ]
        }
    ]
}

For more information, see Amazon S3 Event Notifications in the Amazon S3 User Guide.

To retrieve the notification configuration of a bucket

The following get-bucket-notification example retrieves the notification configuration for a bucket named amzn-s3-demo-bucket.

aws s3api get-bucket-notification \
    --bucket amzn-s3-demo-bucket

Output:

{
    "TopicConfiguration": {
        "Topic": "arn:aws:sns:us-west-2:123456789012:my-notification-topic",
        "Id": "YmQzMmEwM2EjZWVlI0NGItNzVtZjI1MC00ZjgyLWZDBiZWNl",
        "Event": "s3:ObjectCreated:*",
        "Events": [
            "s3:ObjectCreated:*"
        ]
    }
}

For more information, see Amazon S3 Event Notifications in the Amazon S3 User Guide.

To retrieve the bucket ownership settings of a bucket

The following get-bucket-ownership-controls example retrieves the bucket ownership settings of a bucket.

aws s3api get-bucket-ownership-controls \
    --bucket amzn-s3-demo-bucket

Output:

{
    "OwnershipControls": {
        "Rules": [
            {
                "ObjectOwnership": "BucketOwnerEnforced"
            }
        ]
    }
}

For more information, see Viewing the Object Ownership setting for an S3 bucket in the Amazon S3 User Guide.

To retrieve the policy status for a bucket indicating whether the bucket is public

The following get-bucket-policy-status example retrieves the policy status for the bucket amzn-s3-demo-bucket.

aws s3api get-bucket-policy-status \
    --bucket amzn-s3-demo-bucket

Output:

{
    "PolicyStatus": {
        "IsPublic": false
    }
}

For more information, see Blocking public access to your Amazon S3 storage in the Amazon S3 User Guide.

Example 1: To retrieve a bucket policy

The following get-bucket-policy example retrieves the bucket policy for a bucket named amzn-s3-demo-bucket.

aws s3api get-bucket-policy \
    --bucket amzn-s3-demo-bucket

Output:

{
    "Policy": "{\"Version\":\"2008-10-17\",\"Statement\":[{\"Sid\":\"\",\"Effect\":\"Allow\",\"Principal\":\"*\",\"Action\":\"s3:GetObject\",\"Resource\":\"arn:aws:s3:::amzn-s3-demo-bucket/*\"},{\"Sid\":\"\",\"Effect\":\"Deny\",\"Principal\":\"*\",\"Action\":\"s3:GetObject\",\"Resource\":\"arn:aws:s3:::amzn-s3-demo-bucket/secret/*\"}]}"
}

Example 2: To get and put a bucket policy

The following get-bucket-policy example shows how you can download an Amazon S3 bucket policy, make modifications to the file, and then use put-bucket-policy to apply the modified bucket policy. To download the bucket policy to a file, run the following command.

aws s3api get-bucket-policy \
    --bucket amzn-s3-demo-bucket \
    --query Policy \
    --output text > policy.json

This command produces no output.

You can then modify the policy.json file as needed. Finally you can apply this modified policy back to the S3 bucket by running the following command.

aws s3api put-bucket-policy \
    --bucket amzn-s3-demo-bucket \
    --policy file://policy.json

Contents of policy.json:

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Principal": "*",
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*"
        },
        {
            "Sid": "",
            "Effect": "Deny",
            "Principal": "*",
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/secret/*"
        }
    ]
}

This command produces no output.

For more information, see Bucket policies for Amazon S3 in the Amazon S3 User Guide.

To retrieve the replication configuration of a bucket

The following get-bucket-replication example retrieves the replication configuration for a bucket named amzn-s3-demo-bucket1.

aws s3api get-bucket-replication \
    --bucket amzn-s3-demo-bucket1

Output:

{
    "ReplicationConfiguration": {
        "Rules": [
            {
                "Status": "Enabled",
                "Prefix": "",
                "Destination": {
                    "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket2",
                    "StorageClass": "STANDARD"
                },
                "ID": "ZmUwNzE4ZmQ4tMjVhOS00MTlkLOGI4NDkzZTIWJjNTUtYTA1"
            }
        ],
        "Role": "arn:aws:iam::123456789012:role/s3-replication-role"
    }
}

For more information, see Replicating objects within and across Regions in the Amazon S3 User Guide.

To retrieve the request payment configuration for a bucket

The following get-bucket-request-payment example retrieves the requester pays configuration for the specified bucket.

aws s3api get-bucket-request-payment \
    --bucket amzn-s3-demo-bucket

Output:

{
    "Payer": "BucketOwner"
}

For more information, see Using Requester Pays general purpose buckets for storage transfers and usage in the Amazon S3 User Guide.

To retrieve the tagging configuration of a bucket

The following get-bucket-tagging example retrieves the tagging configuration for a bucket named amzn-s3-demo-bucket.

aws s3api get-bucket-tagging \
    --bucket amzn-s3-demo-bucket

Output:

{
    "TagSet": [
        {
            "Value": "marketing",
            "Key": "organization"
        }
    ]
}

For more information, see Using cost allocation S3 bucket tags in the Amazon S3 User Guide.

To retrieve the versioning configuration of a bucket

The following get-bucket-versioning example retrieves the versioning configuration for a bucket named amzn-s3-demo-bucket.

aws s3api get-bucket-versioning \
    --bucket amzn-s3-demo-bucket

Output:

{
    "Status": "Enabled"
}

For more information, see Retaining multiple versions of objects with S3 Versioning in the Amazon S3 User Guide.

To retrieve the website configuration of a bucket

The following get-bucket-website example retrieves the static website configuration for a bucket named amzn-s3-demo-bucket.

aws s3api get-bucket-website \
    --bucket amzn-s3-demo-bucket

Output:

{
    "IndexDocument": {
        "Suffix": "index.html"
    },
    "ErrorDocument": {
        "Key": "error.html"
    }
}

For more information, see Hosting a static website using Amazon S3 in the Amazon S3 User Guide.

To retrieve the access control list of an object

The following get-object-acl example retrieves the access control list for an object in a bucket named amzn-s3-demo-bucket.

aws s3api get-object-acl \
    --bucket amzn-s3-demo-bucket \
    --key index.html

Output:

{
    "Owner": {
        "DisplayName": "my-username",
        "ID": "7009a8971cd538e11f6b6606438875e7c86c5b672f46db45460ddcd087d36c32"
    },
    "Grants": [
        {
            "Grantee": {
                "DisplayName": "my-username",
                "ID": "7009a8971cd538e11f6b6606438875e7c86c5b672f46db45460ddcd087d36c32"
            },
            "Permission": "FULL_CONTROL"
        },
        {
            "Grantee": {
                "URI": "http://acs.amazonaws.com/groups/global/AllUsers"
            },
            "Permission": "READ"
        }
    ]
}

For more information, see Access control list (ACL) overview in the Amazon S3 User Guide.

To retrieves metadata from an object without returning the object itself

The following get-object-attributes example retrieves metadata from the object doc1.rtf.

aws s3api get-object-attributes \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf \
    --object-attributes "StorageClass" "ETag" "ObjectSize"

Output:

{
    "LastModified": "2022-03-15T19:37:31+00:00",
    "VersionId": "IuCPjXTDzHNfldAuitVBIKJpF2p1fg4P",
    "ETag": "b662d79adeb7c8d787ea7eafb9ef6207",
    "StorageClass": "STANDARD",
    "ObjectSize": 405
}

For more information, see Working with object metadata in the Amazon S3 User Guide.

To retrieve the Legal Hold status of an object

The following get-object-legal-hold example retrieves the Legal Hold status for the specified object.

aws s3api get-object-legal-hold \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf

Output:

{
    "LegalHold": {
        "Status": "ON"
    }
}

For more information, see Locking objects with Object Lock in the Amazon S3 User Guide.

To retrieve an object lock configuration for a bucket

The following get-object-lock-configuration example retrieves the object lock configuration for the specified bucket.

aws s3api get-object-lock-configuration \
    --bucket amzn-s3-demo-bucket

Output:

{
    "ObjectLockConfiguration": {
        "ObjectLockEnabled": "Enabled",
        "Rule": {
            "DefaultRetention": {
                "Mode": "COMPLIANCE",
                "Days": 50
            }
        }
    }
}

For more information, see Configuring S3 Object Lock in the Amazon S3 User Guide.

To retrieve the object retention configuration for an object

The following get-object-retention example retrieves the object retention configuration for the specified object.

aws s3api get-object-retention \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf

Output:

{
    "Retention": {
        "Mode": "GOVERNANCE",
        "RetainUntilDate": "2025-01-01T00:00:00.000Z"
    }
}

For more information, see Locking objects with Object Lock in the Amazon S3 User Guide.

To retrieve the tags attached to an object

The following get-object-tagging example retrieves the values for the specified key from the specified object.

aws s3api get-object-tagging \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf

Output:

{
    "TagSet": [
        {
            "Value": "confidential",
            "Key": "designation"
        }
    ]
}

The following get-object-tagging example tries to retrieve the tag sets of the object doc2.rtf, which has no tags.

aws s3api get-object-tagging \
    --bucket amzn-s3-demo-bucket \
    --key doc2.rtf

Output:

{
    "TagSet": []
}

The following get-object-tagging example retrieves the tag sets of the object doc3.rtf, which has multiple tags.

aws s3api get-object-tagging \
    --bucket amzn-s3-demo-bucket \
    --key doc3.rtf

Output:

{
    "TagSet": [
        {
            "Value": "confidential",
            "Key": "designation"
        },
        {
            "Value": "finance",
            "Key": "department"
        },
        {
            "Value": "payroll",
            "Key": "team"
        }
    ]
}

For more information, see Tagging your objects in the Amazon S3 User Guide.

To create a torrent for an object

The following get-object-torrent example creates a torrent for an object in a bucket named amzn-s3-demo-bucket.

aws s3api get-object-torrent large-video-file.torrent \
    --bucket amzn-s3-demo-bucket \
    --key large-video-file.mp4

This command produces no output.

The torrent file is saved locally in the current folder. Note that the output filename (large-video-file.torrent) is specified without an option name.

For more information, see Working with objects in Amazon S3 in the Amazon S3 User Guide.

Example 1: To download an object

The following get-object example downloads an object from Amazon S3.

aws s3api get-object my_images.tar.bz2 \
    --bucket amzn-s3-demo-bucket \
    --key dir/my_images.tar.bz2

Output:

{
    "AcceptRanges": "bytes",
    "LastModified": "2015-04-16T18:19:14+00:00",
    "ContentLength": 3191,
    "ETag": "\"30a6ec7e1a9ad79c203d05a589c8b400\"",
    "ContentType": "binary/octet-stream",
    "ServerSideEncryption": "AES256",
    "Metadata": {}
}

Note that the outfile parameter is specified without an option name such as "--outfile".

Example 2: To download a specific byte range from an object

The following get-object example uses --range to download a specific byte range from an object. Note the byte ranges need to be prefixed with "bytes=".

aws s3api get-object my_data_range \
    --bucket amzn-s3-demo-bucket \
    --key dir/my_data \
    --range bytes=8888-9999

Output:

{
    "AcceptRanges": "bytes",
    "LastModified": "2015-04-16T18:21:07+00:00",
    "ContentLength": 1112,
    "ETag": "\"0db5e5a2c4f0b9d3e1f6a7b8c9d0e1f2\"",
    "ContentRange": "bytes 8888-9999/20000",
    "ContentType": "binary/octet-stream",
    "ServerSideEncryption": "AES256",
    "Metadata": {}
}

For more information, see Downloading objects in the Amazon S3 User Guide.

To set or modify the block public access configuration for a bucket

The following get-public-access-block example displays the block public access configuration for the specified bucket.

aws s3api get-public-access-block \
    --bucket amzn-s3-demo-bucket

Output:

{
    "PublicAccessBlockConfiguration": {
        "IgnorePublicAcls": true,
        "BlockPublicPolicy": true,
        "BlockPublicAcls": true,
        "RestrictPublicBuckets": true
    }
}

For more information, see Configuring block public access settings for your S3 buckets in the Amazon S3 User Guide.

To verify access to a bucket

The following head-bucket example verifies access to a bucket named amzn-s3-demo-bucket.

aws s3api head-bucket \
    --bucket amzn-s3-demo-bucket

Output:

{
    "BucketRegion": "us-west-2",
    "AccessPointAlias": false
}

If the bucket exists and you have access to it, the output contains the Region of the bucket. Otherwise, an error message will be shown. For example:

A client error (404) occurred when calling the HeadBucket operation: Not Found

For more information, see General purpose buckets overview in the Amazon S3 User Guide.

To retrieve metadata for an object

The following head-object example retrieves metadata for an object in a bucket named amzn-s3-demo-bucket.

aws s3api head-object \
    --bucket amzn-s3-demo-bucket \
    --key index.html

Output:

{
    "AcceptRanges": "bytes",
    "ContentType": "text/html",
    "LastModified": "Thu, 16 Apr 2015 18:19:14 GMT",
    "ContentLength": 77,
    "VersionId": "null",
    "ETag": "\"30a6ec7e1a9ad79c203d05a589c8b400\"",
    "Metadata": {}
}

For more information, see Working with object metadata in the Amazon S3 User Guide.

To retrieve a list of analytics configurations for a bucket

The following list-bucket-analytics-configurations example retrieves a list of analytics configurations for the specified bucket.

aws s3api list-bucket-analytics-configurations \
    --bucket amzn-s3-demo-bucket

Output:

{
    "AnalyticsConfigurationList": [
        {
            "StorageClassAnalysis": {},
            "Id": "1"
        }
    ],
    "IsTruncated": false
}

For more information, see Amazon S3 analytics - Storage Class Analysis in the Amazon S3 User Guide.

To retrieve all S3 Intelligent-Tiering configurations on a bucket

The following list-bucket-intelligent-tiering-configurations example retrieves all S3 Intelligent-Tiering configuration on a bucket.

aws s3api list-bucket-intelligent-tiering-configurations \
    --bucket amzn-s3-demo-bucket

Output:

{
    "IsTruncated": false,
    "IntelligentTieringConfigurationList": [
        {
            "Id": "ExampleConfig",
            "Filter": {
                "Prefix": "images"
            },
            "Status": "Enabled",
            "Tierings": [
                {
                    "Days": 90,
                    "AccessTier": "ARCHIVE_ACCESS"
                },
                {
                    "Days": 180,
                    "AccessTier": "DEEP_ARCHIVE_ACCESS"
                }
            ]
        },
        {
            "Id": "ExampleConfig2",
            "Status": "Disabled",
            "Tierings": [
                {
                    "Days": 730,
                    "AccessTier": "ARCHIVE_ACCESS"
                }
            ]
        },
        {
            "Id": "ExampleConfig3",
            "Filter": {
                "Tag": {
                    "Key": "documents",
                    "Value": "taxes"
                }
            },
            "Status": "Enabled",
            "Tierings": [
                {
                    "Days": 90,
                    "AccessTier": "ARCHIVE_ACCESS"
                },
                {
                    "Days": 365,
                    "AccessTier": "DEEP_ARCHIVE_ACCESS"
                }
            ]
        }
    ]
}

For more information, see Using S3 Intelligent-Tiering in the Amazon S3 User Guide.

To retrieve a list of inventory configurations for a bucket

The following list-bucket-inventory-configurations example lists the inventory configurations for the specified bucket.

aws s3api list-bucket-inventory-configurations \
    --bucket amzn-s3-demo-bucket

Output:

{
    "InventoryConfigurationList": [
        {
            "IsEnabled": true,
            "Destination": {
                "S3BucketDestination": {
                    "Format": "ORC",
                    "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket",
                    "AccountId": "123456789012"
                }
            },
            "IncludedObjectVersions": "Current",
            "Id": "1",
            "Schedule": {
                "Frequency": "Weekly"
            }
        },
        {
            "IsEnabled": true,
            "Destination": {
                "S3BucketDestination": {
                    "Format": "CSV",
                    "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket",
                    "AccountId": "123456789012"
                }
            },
            "IncludedObjectVersions": "Current",
            "Id": "2",
            "Schedule": {
                "Frequency": "Daily"
            }
        }
    ],
    "IsTruncated": false
}

For more information, see Cataloging and analyzing your data with S3 Inventory in the Amazon S3 User Guide.

To retrieve a list of metrics configurations for a bucket

The following list-bucket-metrics-configurations example retrieves a list of metrics configurations for the specified bucket.

aws s3api list-bucket-metrics-configurations \
    --bucket amzn-s3-demo-bucket

Output:

{
    "IsTruncated": false,
    "MetricsConfigurationList": [
        {
            "Filter": {
                "Prefix": "logs"
            },
            "Id": "123"
        },
        {
            "Filter": {
                "Prefix": "tmp"
            },
            "Id": "234"
        }
    ]
}

For more information, see CloudWatch metrics configurations in the Amazon S3 User Guide.

To list the names of all your Amazon S3 buckets

The following list-buckets example displays the names of all your Amazon S3 buckets (across all regions).

aws s3api list-buckets \
    --query "Buckets[].Name"

Output:

[
    "amzn-s3-demo-bucket1",
    "amzn-s3-demo-bucket2"
]

The query option filters the output of list-buckets down to only the bucket names.

For more information, see General purpose buckets overview in the Amazon S3 User Guide.

To list the active multipart uploads for a bucket

The following list-multipart-uploads example lists all of the active multipart uploads for a bucket named amzn-s3-demo-bucket.

aws s3api list-multipart-uploads \
    --bucket amzn-s3-demo-bucket

Output:

{
    "Uploads": [
        {
            "Initiator": {
                "DisplayName": "username",
                "ID": "arn:aws:iam::0123456789012:user/username"
            },
            "Initiated": "2015-06-02T18:01:30.000Z",
            "UploadId": "dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R",
            "StorageClass": "STANDARD",
            "Key": "multipart/01",
            "Owner": {
                "DisplayName": "aws-account-name",
                "ID": "100719349fc3b6dcd7c820a124bf7aecd408092c3d7b51b38494939801fc248b"
            }
        }
    ],
    "CommonPrefixes": []
}

In progress multipart uploads incur storage costs in Amazon S3. Complete or abort an active multipart upload to remove its parts from your account.

For more information, see Uploading and copying objects using multipart upload in Amazon S3 in the Amazon S3 User Guide.

To retrieve version information for an object

The following list-object-versions example retrieves version information for an object in a bucket named amzn-s3-demo-bucket.

aws s3api list-object-versions \
    --bucket amzn-s3-demo-bucket \
    --prefix index.html

Output:

{
    "DeleteMarkers": [
        {
            "Owner": {
                "DisplayName": "my-username",
                "ID": "7009a8971cd6606875a8875e7c86c5b672fe116bd438f46db45460ddcd036c32"
            },
            "IsLatest": true,
            "VersionId": "B2VsEK5saUNNHKcOAJj7hIE86RozToyq",
            "Key": "index.html",
            "LastModified": "2015-11-10T00:57:03.000Z"
        },
        {
            "Owner": {
                "DisplayName": "my-username",
                "ID": "7009a8971cd6606875a8875e7c86c5b672fe116bd438f46db45460ddcd036c32"
            },
            "IsLatest": false,
            "VersionId": ".FLQEZscLIcfxSq.jsFJ.szUkmng2Yw6",
            "Key": "index.html",
            "LastModified": "2015-11-09T23:32:20.000Z"
        }
    ],
    "Versions": [
        {
            "LastModified": "2015-11-10T00:20:11.000Z",
            "VersionId": "Rb_l2T8UHDkFEwCgJjhlgPOZC0qJ.vpD",
            "ETag": "\"0622528de826c0df5db1258a23b80be5\"",
            "StorageClass": "STANDARD",
            "Key": "index.html",
            "Owner": {
                "DisplayName": "my-username",
                "ID": "7009a8971cd6606875a8875e7c86c5b672fe116bd438f46db45460ddcd036c32"
            },
            "IsLatest": false,
            "Size": 38
        },
        {
            "LastModified": "2015-11-09T23:26:41.000Z",
            "VersionId": "rasWWGpgk9E4s0LyTJgusGeRQKLVIAFf",
            "ETag": "\"06225825b8028de826c0df5db1a23be5\"",
            "StorageClass": "STANDARD",
            "Key": "index.html",
            "Owner": {
                "DisplayName": "my-username",
                "ID": "7009a8971cd6606875a8875e7c86c5b672fe116bd438f46db45460ddcd036c32"
            },
            "IsLatest": false,
            "Size": 38
        },
        {
            "LastModified": "2015-11-09T22:50:50.000Z",
            "VersionId": "null",
            "ETag": "\"d1f45267a863c8392e07d24dd592f1b9\"",
            "StorageClass": "STANDARD",
            "Key": "index.html",
            "Owner": {
                "DisplayName": "my-username",
                "ID": "7009a8971cd6606875a8875e7c86c5b672fe116bd438f46db45460ddcd036c32"
            },
            "IsLatest": false,
            "Size": 533823
        }
    ]
}

For more information, see Retaining multiple versions of objects with S3 Versioning in the Amazon S3 User Guide.

To get a list of objects in a bucket

The following list-objects-v2 example lists the objects in the specified bucket.

aws s3api list-objects-v2 \
    --bucket amzn-s3-demo-bucket

Output:

{
    "Contents": [
        {
            "LastModified": "2019-11-05T23:11:50.000Z",
            "ETag": "\"621503c373607d548b37cff8778d992c\"",
            "StorageClass": "STANDARD",
            "Key": "doc1.rtf",
            "Size": 391
        },
        {
            "LastModified": "2019-11-05T23:11:50.000Z",
            "ETag": "\"a2cecc36ab7c7fe3a71a273b9d45b1b5\"",
            "StorageClass": "STANDARD",
            "Key": "doc2.rtf",
            "Size": 373
        },
        {
            "LastModified": "2019-11-05T23:11:50.000Z",
            "ETag": "\"08210852f65a2e9cb999972539a64d68\"",
            "StorageClass": "STANDARD",
            "Key": "doc3.rtf",
            "Size": 399
        },
        {
            "LastModified": "2019-11-05T23:11:50.000Z",
            "ETag": "\"d1852dd683f4043065a9471af106988e\"",
            "StorageClass": "STANDARD",
            "Key": "doc4.rtf",
            "Size": 6225
        }
    ]
}

For more information, see Listing object keys programmatically in the Amazon S3 User Guide.

To list the objects in a bucket

The following list-objects example displays the names of all the objects in the specified bucket.

aws s3api list-objects \
    --bucket amzn-s3-demo-bucket \
    --query 'Contents[].{Key: Key, Size: Size}'

Output:

[
    {
        "Key": "dir/my_data",
        "Size": 20000
    },
    {
        "Key": "dir/my_images.tar.bz2",
        "Size": 3191
    }
]

The example uses the --query argument to filter the output of list-objects down to the key value and size for each object

For more information, see Listing object keys programmatically in the Amazon S3 User Guide.

To list the uploaded parts of a multipart upload

The following list-parts example lists all of the parts that have been uploaded for a multipart upload with key multipart/01 in the bucket amzn-s3-demo-bucket.

aws s3api list-parts \
    --bucket amzn-s3-demo-bucket \
    --key 'multipart/01' \
    --upload-id dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R

Output:

{
    "Owner": {
        "DisplayName": "aws-account-name",
        "ID": "100719349fc3b6dcd7c820a124bf7aecd408092c3d7b51b38494939801fc248b"
    },
    "Initiator": {
        "DisplayName": "username",
        "ID": "arn:aws:iam::0123456789012:user/username"
    },
    "Parts": [
        {
            "LastModified": "2015-06-02T18:07:35.000Z",
            "PartNumber": 1,
            "ETag": "\"e868e0f4719e394144ef36531ee6824c\"",
            "Size": 5242880
        },
        {
            "LastModified": "2015-06-02T18:07:42.000Z",
            "PartNumber": 2,
            "ETag": "\"6bb2b12753d66fe86da4998aa33fffb0\"",
            "Size": 5242880
        },
        {
            "LastModified": "2015-06-02T18:07:47.000Z",
            "PartNumber": 3,
            "ETag": "\"d0a0112e841abec9c9ec83406f0159c8\"",
            "Size": 5242880
        }
    ],
    "StorageClass": "STANDARD"
}

For more information, see Uploading and copying objects using multipart upload in Amazon S3 in the Amazon S3 User Guide.

Example 1: To list all user owned buckets

The following ls example lists all of the buckets owned by the user. In this example, the user owns the buckets amzn-s3-demo-bucket and amzn-s3-demo-bucket2. The timestamp is the date the bucket was created, shown in your machine's time zone. This date can change when making changes to your bucket, such as editing its bucket policy. Note if s3:// is used for the path argument <S3Uri>, it will list all of the buckets as well.

aws s3 ls

Output:

2013-07-11 17:08:50 amzn-s3-demo-bucket
2013-07-24 14:55:44 amzn-s3-demo-bucket2

Example 2: To list all prefixes and objects in a bucket

The following ls example lists objects and common prefixes under a specified bucket and prefix. In this example, the user owns the bucket amzn-s3-demo-bucket with the objects test.txt and somePrefix/test.txt. The LastWriteTime and Length are arbitrary. Note that since the ls command has no interaction with the local filesystem, the s3:// URI scheme is not required to resolve ambiguity and may be omitted.

aws s3 ls s3://amzn-s3-demo-bucket

Output:

                           PRE somePrefix/
2013-07-25 17:06:27         88 test.txt

Example 3: To list all prefixes and objects in a specific bucket and prefix

The following ls example lists objects and common prefixes under a specified bucket and prefix. However, there are no objects nor common prefixes under the specified bucket and prefix.

aws s3 ls s3://amzn-s3-demo-bucket/noExistPrefix

Output:

None

Example 4: To recursively list all prefixes and objects in a bucket

The following ls example recursively lists objects in a bucket. Rather than showing PRE dirname/ in the output, all the content in a bucket will be listed in order.

aws s3 ls s3://amzn-s3-demo-bucket \
    --recursive

Output:

2013-09-02 21:37:53         10 a.txt
2013-09-02 21:37:53    2863288 foo.zip
2013-09-02 21:32:57         23 foo/bar/.baz/a
2013-09-02 21:32:58         41 foo/bar/.baz/b
2013-09-02 21:32:57        281 foo/bar/.baz/c
2013-09-02 21:32:57         73 foo/bar/.baz/d
2013-09-02 21:32:57        452 foo/bar/.baz/e
2013-09-02 21:32:57        896 foo/bar/.baz/hooks/bar
2013-09-02 21:32:57        189 foo/bar/.baz/hooks/foo
2013-09-02 21:32:57        398 z.txt

Example 5: To summarize all prefixes and objects in a bucket

The following ls example runs the same command as the previous example with the --human-readable and --summarize options. --human-readable displays file size in Bytes/MiB/KiB/GiB/TiB/PiB/EiB. --summarize displays the total number of objects and total size at the end of the result listing.

aws s3 ls s3://amzn-s3-demo-bucket \
    --recursive \
    --human-readable \
    --summarize

Output:

2013-09-02 21:37:53   10 Bytes a.txt
2013-09-02 21:37:53  2.9 MiB foo.zip
2013-09-02 21:32:57   23 Bytes foo/bar/.baz/a
2013-09-02 21:32:58   41 Bytes foo/bar/.baz/b
2013-09-02 21:32:57  281 Bytes foo/bar/.baz/c
2013-09-02 21:32:57   73 Bytes foo/bar/.baz/d
2013-09-02 21:32:57  452 Bytes foo/bar/.baz/e
2013-09-02 21:32:57  896 Bytes foo/bar/.baz/hooks/bar
2013-09-02 21:32:57  189 Bytes foo/bar/.baz/hooks/foo
2013-09-02 21:32:57  398 Bytes z.txt

Total Objects: 10
   Total Size: 2.9 MiB

Example 6: To list objects in an S3 access point

The following ls example lists objects from access point (myaccesspoint).

aws s3 ls s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/

Output:

                           PRE somePrefix/
2013-07-25 17:06:27         88 test.txt

For more information, see Using high-level (s3) commands in the AWS CLI in the AWS CLI User Guide.

Example 1: To create a bucket

The following mb example creates a bucket. In this example, the user makes the bucket amzn-s3-demo-bucket. The bucket is created in the region specified in the user's configuration file.

aws s3 mb s3://amzn-s3-demo-bucket

Output:

make_bucket: s3://amzn-s3-demo-bucket

Example 2: To create a bucket in the specified region

The following mb example creates a bucket in a region specified by the --region parameter. In this example, the user makes the bucket amzn-s3-demo-bucket in the region us-west-2.

aws s3 mb s3://amzn-s3-demo-bucket \
    --region us-west-2

Output:

make_bucket: s3://amzn-s3-demo-bucket

Example 3: To create a bucket with specified tags

The following mb example creates a bucket with specified tags using the --tags parameter. In this example, the user makes the bucket amzn-s3-demo-bucket with two tags with keys Key1 and Key2, respectively.

aws s3 mb s3://amzn-s3-demo-bucket \
    --tags Key1 Value1 \
    --tags Key2 Value2

Output:

make_bucket: s3://amzn-s3-demo-bucket

For more information, see Using high-level (s3) commands in the AWS CLI in the AWS CLI User Guide.

Example 1: To move a local file to the specified bucket

The following mv example moves a single file to a specified bucket and key.

aws s3 mv test.txt s3://amzn-s3-demo-bucket/test2.txt

Output:

move: test.txt to s3://amzn-s3-demo-bucket/test2.txt

Example 2: To move an object to the specified bucket and key

The following mv example moves a single S3 object to a specified bucket and key.

aws s3 mv s3://amzn-s3-demo-bucket/test.txt s3://amzn-s3-demo-bucket/test2.txt

Output:

move: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket/test2.txt

Example 3: To move an S3 object to the local directory

The following mv example moves a single object to a specified file locally.

aws s3 mv s3://amzn-s3-demo-bucket/test.txt test2.txt

Output:

move: s3://amzn-s3-demo-bucket/test.txt to test2.txt

Example 4: To move an object with its original name to the specified bucket

The following mv example moves a single object to a specified bucket while retaining its original name.

aws s3 mv s3://amzn-s3-demo-bucket/test.txt s3://amzn-s3-demo-bucket2/

Output:

move: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket2/test.txt

Example 5: To move all objects and prefixes in a bucket to the local directory

The following mv example recursively moves all objects under a specified prefix and bucket to a specified directory when passed with the parameter --recursive. In this example, the bucket amzn-s3-demo-bucket has the objects test1.txt and test2.txt.

aws s3 mv s3://amzn-s3-demo-bucket . \
    --recursive

Output:

move: s3://amzn-s3-demo-bucket/test1.txt to test1.txt
move: s3://amzn-s3-demo-bucket/test2.txt to test2.txt

Example 6: To move all files in a local directory to a bucket, except ``.jpg`` files

The following mv example recursively moves all files under a specified directory to a specified bucket and prefix when passed with the parameter --recursive, while excluding some files by using an --exclude parameter. In this example, the directory myDir has the files test1.txt and test2.jpg.

aws s3 mv myDir s3://amzn-s3-demo-bucket/ \
    --recursive \
    --exclude "*.jpg"

Output:

move: myDir/test1.txt to s3://amzn-s3-demo-bucket2/test1.txt

Example 7: To move all objects in a bucket to another bucket, except objects under a specified prefix

The following mv example recursively moves all objects under a specified bucket to another bucket when passed with the parameter --recursive, while excluding some objects by using an --exclude parameter. In this example, the bucket amzn-s3-demo-bucket has the objects test1.txt and another/test1.txt.

aws s3 mv s3://amzn-s3-demo-bucket/ s3://amzn-s3-demo-bucket2/ \
    --recursive \
    --exclude "amzn-s3-demo-bucket/another/*"

Output:

move: s3://amzn-s3-demo-bucket/test1.txt to s3://amzn-s3-demo-bucket2/test1.txt

Example 8: To move an object to the specified bucket and set the ACL

The following mv example moves a single object to a specified bucket and key while setting the ACL to public-read-write.

aws s3 mv s3://amzn-s3-demo-bucket/test.txt s3://amzn-s3-demo-bucket/test2.txt \
    --acl public-read-write

Output:

move: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket/test2.txt

Example 9: To move a local file to the specified bucket and grant permissions

The following mv example uses the --grants option to grant read access to all users and full control to a specific user identified by their email address.

aws s3 mv file.txt s3://amzn-s3-demo-bucket/ \
    --grants read=uri=http://acs.amazonaws.com/groups/global/AllUsers full=emailaddress=user@example.com

Output:

move: file.txt to s3://amzn-s3-demo-bucket/file.txt

Example 10: To move a file to an S3 access point

The following mv example moves a single file named mydoc.txt to the access point named myaccesspoint at the key named mykey.

aws s3 mv mydoc.txt s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey

Output:

move: mydoc.txt to s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey

For more information, see Using high-level (s3) commands in the AWS CLI in the AWS CLI User Guide.

Example 1: To create a pre-signed URL with the default one hour lifetime that links to an object in an S3 bucket

The following presign example generates a pre-signed URL for a specified bucket and key that is valid for one hour.

aws s3 presign s3://amzn-s3-demo-bucket/test2.txt

Output:

https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/key?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAEXAMPLE123456789%2F20210621%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20210621T041609Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=EXAMPLE1234494d5fba3fed607f98018e1dfc62e2529ae96d844123456

Example 2: To create a pre-signed URL with a custom lifetime that links to an object in an S3 bucket

The following presign example generates a pre-signed URL for a specified bucket and key that is valid for one week.

aws s3 presign s3://amzn-s3-demo-bucket/test2.txt \
    --expires-in 604800

Output:

https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/key?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAEXAMPLE123456789%2F20210621%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20210621T041609Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=EXAMPLE1234494d5fba3fed607f98018e1dfc62e2529ae96d844123456

For more information, see Share an Object with Others in the Amazon S3 Developer Guide.

To set the accelerate configuration of a bucket

The following put-bucket-accelerate-configuration example enables the accelerate configuration for the specified bucket.

aws s3api put-bucket-accelerate-configuration \
    --bucket amzn-s3-demo-bucket \
    --accelerate-configuration Status=Enabled

This command produces no output.

For more information, see Configuring fast, secure file transfers using Amazon S3 Transfer Acceleration in the Amazon S3 User Guide.

To set the access control list for a bucket

The following put-bucket-acl example grants full control to two AWS users (user1@example.com and user2@example.com) and read permission to everyone.

aws s3api put-bucket-acl \
    --bucket amzn-s3-demo-bucket \
    --grant-full-control emailaddress=user1@example.com,emailaddress=user2@example.com \
    --grant-read uri=http://acs.amazonaws.com/groups/global/AllUsers

This command produces no output.

For more information, see Configuring ACLs in the Amazon S3 User Guide.

To sets an analytics configuration for the bucket

The following put-bucket-analytics-configuration example configures analytics for the specified bucket.

aws s3api put-bucket-analytics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 1 \
    --analytics-configuration '{"Id": "1","StorageClassAnalysis": {}}'

This command produces no output.

For more information, see Amazon S3 analytics - Storage Class Analysis in the Amazon S3 User Guide.

To configure CORS for a bucket

The following put-bucket-cors example enables PUT, POST, and DELETE requests from www.example.com, and enables GET requests from any domain.

aws s3api put-bucket-cors \
    --bucket amzn-s3-demo-bucket \
    --cors-configuration file://cors.json

Contents of cors.json:

{
    "CORSRules": [
        {
            "AllowedOrigins": [
                "http://www.example.com"
            ],
            "AllowedHeaders": [
                "*"
            ],
            "AllowedMethods": [
                "PUT",
                "POST",
                "DELETE"
            ],
            "MaxAgeSeconds": 3000,
            "ExposeHeaders": [
                "x-amz-server-side-encryption"
            ]
        },
        {
            "AllowedOrigins": [
                "*"
            ],
            "AllowedHeaders": [
                "Authorization"
            ],
            "AllowedMethods": [
                "GET"
            ],
            "MaxAgeSeconds": 3000
        }
    ]
}

This command produces no output.

For more information, see Using cross-origin resource sharing (CORS) in the Amazon S3 User Guide.

To configure server-side encryption for a bucket

The following put-bucket-encryption example sets AES256 encryption as the default for the specified bucket.

aws s3api put-bucket-encryption \
    --bucket amzn-s3-demo-bucket \
    --server-side-encryption-configuration '{"Rules": [{"ApplyServerSideEncryptionByDefault": {"SSEAlgorithm": "AES256"}}]}'

This command produces no output.

For more information, see Setting default server-side encryption behavior for Amazon S3 buckets in the Amazon S3 User Guide.

To update an S3 Intelligent-Tiering configuration on a bucket

The following put-bucket-intelligent-tiering-configuration example updates an S3 Intelligent-Tiering configuration, named ExampleConfig, on a bucket. The configuration will transition objects that have not been accessed under the prefix images to Archive Access after 90 days and Deep Archive Access after 180 days.

aws s3api put-bucket-intelligent-tiering-configuration \
    --bucket amzn-s3-demo-bucket \
    --id "ExampleConfig" \
    --intelligent-tiering-configuration file://intelligent-tiering-configuration.json

Contents of intelligent-tiering-configuration.json:

{
    "Id": "ExampleConfig",
    "Status": "Enabled",
    "Filter": {
        "Prefix": "images"
        },
    "Tierings": [
        {
            "Days": 90,
            "AccessTier": "ARCHIVE_ACCESS"
        },
        {
            "Days": 180,
            "AccessTier": "DEEP_ARCHIVE_ACCESS"
        }
    ]
}

This command produces no output.

For more information, see Setting Object Ownership on an existing bucket in the Amazon S3 User Guide.

Example 1: To set an inventory configuration for a bucket

The following put-bucket-inventory-configuration example sets a weekly ORC-formatted inventory report for the bucket amzn-s3-demo-bucket.

aws s3api put-bucket-inventory-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 1 \
    --inventory-configuration '{"Destination": { "S3BucketDestination": { "AccountId": "123456789012", "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket", "Format": "ORC" }}, "IsEnabled": true, "Id": "1", "IncludedObjectVersions": "Current", "Schedule": { "Frequency": "Weekly" }}'

This command produces no output.

For more information, see Cataloging and analyzing your data with S3 Inventory in the Amazon S3 User Guide.

Example 2: To set an inventory configuration for a bucket

The following put-bucket-inventory-configuration example sets a daily CSV-formatted inventory report for the bucket amzn-s3-demo-bucket.

aws s3api put-bucket-inventory-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 2 \
    --inventory-configuration '{"Destination": { "S3BucketDestination": { "AccountId": "123456789012", "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket", "Format": "CSV" }}, "IsEnabled": true, "Id": "2", "IncludedObjectVersions": "Current", "Schedule": { "Frequency": "Daily" }}'

This command produces no output.

For more information, see Cataloging and analyzing your data with S3 Inventory in the Amazon S3 User Guide.

To apply a lifecycle configuration to a bucket

The following put-bucket-lifecycle-configuration example applies a lifecycle configuration to a bucket named amzn-s3-demo-bucket.

aws s3api put-bucket-lifecycle-configuration \
    --bucket amzn-s3-demo-bucket \
    --lifecycle-configuration file://lifecycle.json

The file lifecycle.json is a JSON document in the current folder that specifies two rules.

Contents of lifecycle.json:

{
    "Rules": [
        {
            "ID": "Move rotated logs to Glacier",
            "Prefix": "rotated/",
            "Status": "Enabled",
            "Transitions": [
                {
                    "Date": "2015-11-10T00:00:00.000Z",
                    "StorageClass": "GLACIER"
                }
            ]
        },
        {
            "Status": "Enabled",
            "Prefix": "",
            "NoncurrentVersionTransitions": [
                {
                    "NoncurrentDays": 2,
                    "StorageClass": "GLACIER"
                }
            ],
            "ID": "Move old versions to Glacier"
        }
    ]
}

Output:

{
    "TransitionDefaultMinimumObjectSize": "all_storage_classes_128K"
}

The first rule moves files with the prefix rotated to Glacier on the specified date. The second rule moves old object versions to Glacier when they are no longer current. For information on acceptable timestamp formats, see Specifying parameter values in the AWS CLI in the AWS CLI User Guide.

For more information, see Managing the lifecycle of objects in the Amazon S3 User Guide.

To apply a lifecycle configuration to a bucket

The following put-bucket-lifecycle example applies a lifecycle configuration to the bucket amzn-s3-demo-bucket.

aws s3api put-bucket-lifecycle \
    --bucket amzn-s3-demo-bucket \
    --lifecycle-configuration file://lifecycle.json

This command produces no output.

The file lifecycle.json is a JSON document in the current folder that specifies two rules.

Contents of lifecycle.json:

{
    "Rules": [
        {
            "ID": "Move to Glacier after sixty days (objects in logs/2015/)",
            "Prefix": "logs/2015/",
            "Status": "Enabled",
            "Transition": {
                "Days": 60,
                "StorageClass": "GLACIER"
            }
        },
        {
            "Expiration": {
                "Date": "2016-01-01T00:00:00.000Z"
            },
            "ID": "Delete 2014 logs in 2016.",
            "Prefix": "logs/2014/",
            "Status": "Enabled"
        }
    ]
}

The first rule moves files to Amazon Glacier after sixty days. The second rule deletes files from Amazon S3 on the specified date. For information on acceptable timestamp formats, see Specifying parameter values in the AWS CLI in the AWS CLI User Guide.

Each rule in the above example specifies a policy (Transition or Expiration) and file prefix (folder name) to which it applies. You can also create a rule that applies to an entire bucket by specifying a blank prefix:

{
    "Rules": [
        {
            "ID": "Move to Glacier after sixty days (all objects in bucket)",
            "Prefix": "",
            "Status": "Enabled",
            "Transition": {
                "Days": 60,
                "StorageClass": "GLACIER"
            }
        }
    ]
}

For more information, see Managing the lifecycle of objects in the Amazon S3 User Guide.

Example 1: To set bucket policy logging

The following put-bucket-logging example sets the logging policy for amzn-s3-demo-bucket. First, grant the logging service principal permission in your bucket policy using the put-bucket-policy command.

aws s3api put-bucket-policy \
    --bucket amzn-s3-demo-bucket \
    --policy file://policy.json

Contents of policy.json:

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "S3ServerAccessLogsPolicy",
            "Effect": "Allow",
            "Principal": {"Service": "logging.s3.amazonaws.com"},
            "Action": "s3:PutObject",
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/Logs/*",
            "Condition": {
                "ArnLike": {"aws:SourceARN": "arn:aws:s3:::SOURCE-BUCKET-NAME"},
                "StringEquals": {"aws:SourceAccount": "SOURCE-AWS-ACCOUNT-ID"}
            }
        }
    ]
}

To apply the logging policy, use put-bucket-logging.

aws s3api put-bucket-logging \
    --bucket amzn-s3-demo-bucket \
    --bucket-logging-status file://logging.json

Contents of logging.json:

{
    "LoggingEnabled": {
        "TargetBucket": "amzn-s3-demo-bucket",
        "TargetPrefix": "Logs/"
    }
}

This command produces no output.

The put-bucket-policy command is required to grant s3:PutObject permissions to the logging service principal.

For more information, see Amazon S3 Server Access Logging in the Amazon S3 User Guide.

Example 2: To set a bucket policy for logging access to only a single user

The following put-bucket-logging example sets the logging policy for amzn-s3-demo-bucket. The AWS user bob@example.com will have full control over the log files, and no one else has any access. First, grant S3 permission with put-bucket-acl.

aws s3api put-bucket-acl \
    --bucket amzn-s3-demo-bucket \
    --grant-write URI=http://acs.amazonaws.com/groups/s3/LogDelivery \
    --grant-read-acp URI=http://acs.amazonaws.com/groups/s3/LogDelivery

Then apply the logging policy using put-bucket-logging.

aws s3api put-bucket-logging \
    --bucket amzn-s3-demo-bucket \
    --bucket-logging-status file://logging.json

Contents of logging.json:

{
    "LoggingEnabled": {
        "TargetBucket": "amzn-s3-demo-bucket",
        "TargetPrefix": "amzn-s3-demo-bucket-logs/",
        "TargetGrants": [
            {
                "Grantee": {
                    "Type": "AmazonCustomerByEmail",
                    "EmailAddress": "bob@example.com"
                },
                "Permission": "FULL_CONTROL"
            }
        ]
    }
}

This command produces no output.

the put-bucket-acl command is required to grant S3's log delivery system the necessary permissions (write and read-acp permissions).

For more information, see Amazon S3 Server Access Logging in the Amazon S3 Developer Guide.

To set a metrics configuration for a bucket

The following put-bucket-metrics-configuration example sets a metric configuration with ID 123 for the specified bucket.

aws s3api put-bucket-metrics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 123 \
    --metrics-configuration '{"Id": "123", "Filter": {"Prefix": "logs"}}'

This command produces no output.

For more information, see CloudWatch metrics configurations in the Amazon S3 User Guide.

To enable the specified notifications to a bucket

The following put-bucket-notification-configuration example applies a notification configuration to a bucket named amzn-s3-demo-bucket. The file notification.json is a JSON document in the current folder that specifies an SNS topic and an event type to monitor.

aws s3api put-bucket-notification-configuration \
    --bucket amzn-s3-demo-bucket \
    --notification-configuration file://notification.json

Contents of notification.json:

{
    "TopicConfigurations": [
        {
            "TopicArn": "arn:aws:sns:us-west-2:123456789012:s3-notification-topic",
            "Events": [
                "s3:ObjectCreated:*"
            ]
        }
    ]
}

This command produces no output.

The SNS topic must have an IAM policy attached to it that allows Amazon S3 to publish to it.

{
    "Version":"2012-10-17",
    "Id": "example-ID",
    "Statement": [
        {
            "Sid": "example-statement-ID",
            "Effect": "Allow",
            "Principal": {
                "Service": "s3.amazonaws.com"
            },
            "Action": [
                "SNS:Publish"
            ],
            "Resource": "arn:aws:sns:us-west-2:123456789012::s3-notification-topic",
            "Condition": {
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:s3:*:*:amzn-s3-demo-bucket"
                }
            }
        }
    ]
}

For more information, see Amazon S3 Event Notifications in the Amazon S3 User Guide.

To apply a notification configuration to a bucket

The following put-bucket-notification example applies a notification configuration to a bucket named amzn-s3-demo-bucket.

aws s3api put-bucket-notification \
    --bucket amzn-s3-demo-bucket \
    --notification-configuration file://notification.json

This command produces no output.

The file notification.json is a JSON document in the current folder that specifies an SNS topic and an event type to monitor.

Contents of notification.json:

{
    "TopicConfiguration": {
        "Event": "s3:ObjectCreated:*",
        "Topic": "arn:aws:sns:us-west-2:123456789012:s3-notification-topic"
    }
}

The SNS topic must have an IAM policy attached to it that allows Amazon S3 to publish to it:

{
    "Version":"2012-10-17",
    "Id": "example-ID",
    "Statement": [
        {
            "Sid": "example-statement-ID",
            "Effect": "Allow",
            "Principal": {
                "Service": "s3.amazonaws.com"
            },
            "Action": [
                "SNS:Publish"
            ],
            "Resource": "arn:aws:sns:us-west-2:123456789012:amzn-s3-demo-bucket",
            "Condition": {
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:s3:*:*:amzn-s3-demo-bucket"
                }
            }
        }
    ]
}

For more information, see Amazon S3 Event Notifications in the Amazon S3 User Guide.

To update the bucket ownership settings of a bucket

The following put-bucket-ownership-controls example updates the bucket ownership settings of a bucket.

aws s3api put-bucket-ownership-controls \
    --bucket amzn-s3-demo-bucket \
    --ownership-controls="Rules=[{ObjectOwnership=BucketOwnerEnforced}]"

This command produces no output.

For more information, see Setting Object Ownership on an existing bucket in the Amazon S3 User Guide.

To apply a policy to a bucket

The following put-bucket-policy example allows all users to retrieve any object in amzn-s3-demo-bucket except those in the MySecretFolder. It also grants put and delete permission to the root user of the AWS account 1234-5678-9012.

aws s3api put-bucket-policy \
    --bucket amzn-s3-demo-bucket \
    --policy file://policy.json

Contents of policy.json:

{
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": "*",
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*"
        },
        {
            "Effect": "Deny",
            "Principal": "*",
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/MySecretFolder/*"
        },
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:root"
            },
            "Action": [
                "s3:DeleteObject",
                "s3:PutObject"
            ],
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*"
        }
    ]
}

This command produces no output.

For more information, see Bucket policies for Amazon S3 in the Amazon S3 User Guide.

To configure replication for an S3 bucket

The following put-bucket-replication example applies a replication configuration to the specified S3 bucket.

aws s3api put-bucket-replication \
    --bucket amzn-s3-demo-bucket1 \
    --replication-configuration file://replication.json

Contents of replication.json:

{
    "Role": "arn:aws:iam::123456789012:role/s3-replication-role",
    "Rules": [
        {
            "Status": "Enabled",
            "Priority": 1,
            "DeleteMarkerReplication": { "Status": "Disabled" },
            "Filter" : { "Prefix": ""},
            "Destination": {
                "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket2"
            }
        }
    ]
}

The destination bucket must have versioning enabled. The specified role must have permission to write to the destination bucket and have a trust relationship that allows Amazon S3 to assume the role.

Example role permission policy:

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetReplicationConfiguration",
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket1"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetObjectVersion",
                "s3:GetObjectVersionAcl",
                "s3:GetObjectVersionTagging"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket1/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:ReplicateObject",
                "s3:ReplicateDelete",
                "s3:ReplicateTags"
            ],
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket2/*"
        }
    ]
}

Example trust relationship policy:

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "s3.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

This command produces no output.

For more information, see This is the topic title in the Amazon Simple Storage Service Console User Guide.

Example 1: To enable ``requester pays`` configuration for a bucket

The following put-bucket-request-payment example enables requester pays for the specified bucket.

aws s3api put-bucket-request-payment \
    --bucket amzn-s3-demo-bucket \
    --request-payment-configuration '{"Payer":"Requester"}'

This command produces no output.

For more information, see Using Requester Pays general purpose buckets for storage transfers and usage in the Amazon S3 User Guide.

Example 2: To disable ``requester pays`` configuration for a bucket

The following put-bucket-request-payment example disables requester pays for the specified bucket.

aws s3api put-bucket-request-payment \
    --bucket amzn-s3-demo-bucket \
    --request-payment-configuration '{"Payer":"BucketOwner"}'

This command produces no output.

For more information, see Using Requester Pays general purpose buckets for storage transfers and usage in the Amazon S3 User Guide.

To apply a tagging configuration to a bucket

The following put-bucket-tagging example applies a tagging configuration to a bucket named amzn-s3-demo-bucket.

aws s3api put-bucket-tagging \
    --bucket amzn-s3-demo-bucket \
    --tagging file://tagging.json

This command produces no output.

The file tagging.json is a JSON document in the current folder that specifies tags.

Contents of tagging.json:

{
    "TagSet": [
        {
            "Key": "organization",
            "Value": "marketing"
        }
    ]
}

Alternatively, apply a tagging configuration to amzn-s3-demo-bucket directly from the command line.

aws s3api put-bucket-tagging \
    --bucket amzn-s3-demo-bucket \
    --tagging 'TagSet=[{Key=organization,Value=marketing}]'

This command produces no output.

For more information, see Using cost allocation S3 bucket tags in the Amazon S3 User Guide.

To enable versioning on a bucket

The following put-bucket-versioning example enables versioning on a bucket named amzn-s3-demo-bucket.

aws s3api put-bucket-versioning \
    --bucket amzn-s3-demo-bucket \
    --versioning-configuration Status=Enabled

This command produces no output.

The following command enables versioning and uses an MFA code.

aws s3api put-bucket-versioning \
    --bucket amzn-s3-demo-bucket \
    --versioning-configuration Status=Enabled \
    --mfa "SERIAL 123456"

This command produces no output.

For more information, see Retaining multiple versions of objects with S3 Versioning in the Amazon S3 User Guide.

To apply a static website configuration to a bucket

The following put-bucket-website example applies a static website configuration to a bucket named amzn-s3-demo-bucket.

aws s3api put-bucket-website \
    --bucket amzn-s3-demo-bucket \
    --website-configuration file://website.json

This command produces no output.

The file website.json is a JSON document in the current folder that specifies index and error pages for the website.

Contents of website.json:

{
    "IndexDocument": {
        "Suffix": "index.html"
    },
    "ErrorDocument": {
        "Key": "error.html"
    }
}

For more information, see Hosting a static website using Amazon S3 in the Amazon S3 User Guide.

To set the access control list for an object

The following put-object-acl example grants full control to two AWS users (user1@example.com and user2@example.com) and read permission to everyone.

aws s3api put-object-acl \
    --bucket amzn-s3-demo-bucket \
    --key file.txt \
    --grant-full-control emailaddress=user1@example.com,emailaddress=user2@example.com \
    --grant-read uri=http://acs.amazonaws.com/groups/global/AllUsers

This command produces no output.

For more information, see Access control list (ACL) overview in the Amazon S3 User Guide.

To apply a Legal Hold to an object

The following put-object-legal-hold example sets a Legal Hold on the object doc1.rtf.

aws s3api put-object-legal-hold \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf \
    --legal-hold Status=ON

This command produces no output.

For more information, see Locking objects with Object Lock in the Amazon S3 User Guide.

To set an object lock configuration on a bucket

The following put-object-lock-configuration example sets a 50-day object lock on the specified bucket.

aws s3api put-object-lock-configuration \
    --bucket amzn-s3-demo-bucket \
    --object-lock-configuration '{ "ObjectLockEnabled": "Enabled", "Rule": { "DefaultRetention": { "Mode": "COMPLIANCE", "Days": 50 }}}'

This command produces no output.

For more information, see Locking objects with Object Lock in the Amazon S3 User Guide.

To set an object retention configuration for an object

The following put-object-retention example sets an object retention configuration for the specified object until 2025-01-01.

aws s3api put-object-retention \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf \
    --retention '{ "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00" }'

This command produces no output.

For more information, see Locking objects with Object Lock in the Amazon S3 User Guide.

To set a tag on an object

The following put-object-tagging example sets a tag with the key designation and the value confidential on the specified object.

aws s3api put-object-tagging \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf \
    --tagging '{"TagSet": [{ "Key": "designation", "Value": "confidential" }]}'

This command produces no output.

For more information, see Tagging your objects in the Amazon S3 User Guide.

The following put-object-tagging example sets multiple tags sets on the specified object.

aws s3api put-object-tagging \
    --bucket amzn-s3-demo-bucket \
    --key doc3.rtf \
    --tagging '{"TagSet": [{ "Key": "designation", "Value": "confidential" }, { "Key": "department", "Value": "finance" }, { "Key": "team", "Value": "payroll" } ]}'

This command produces no output.

For more information, see Tagging your objects in the Amazon S3 User Guide.

Example 1: To upload an object to Amazon S3

The following put-object example uploads an object to Amazon S3.

aws s3api put-object \
    --bucket amzn-s3-demo-bucket \
    --key my-dir/MySampleImage.png \
    --body MySampleImage.png

Output:

{
    "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
    "ChecksumCRC64NVME": "Kd3SA7ZjkPE=",
    "ChecksumType": "FULL_OBJECT",
    "ServerSideEncryption": "AES256"
}

For more information, see Uploading objects in the Amazon S3 User Guide.

Example 2: To upload a video file to Amazon S3

The following put-object example uploads a video file.

aws s3api put-object \
    --bucket amzn-s3-demo-bucket \
    --key my-dir/big-video-file.mp4 \
    --body /media/videos/f-sharp-3-data-services.mp4

Output:

{
    "ETag": "\"9c8b9f2a5e4d3c2b1a0f9e8d7c6b5a49\"",
    "ChecksumCRC64NVME": "bS5l2pLqN0A=",
    "ChecksumType": "FULL_OBJECT",
    "ServerSideEncryption": "AES256"
}

For more information, see Uploading objects in the Amazon S3 User Guide.

To set the block public access configuration for a bucket

The following put-public-access-block example sets a restrictive block public access configuration for the specified bucket.

aws s3api put-public-access-block \
    --bucket amzn-s3-demo-bucket \
    --public-access-block-configuration "BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true"

This command produces no output.

For more information, see Blocking public access to your Amazon S3 storage in the Amazon S3 User Guide.

Example 1: To delete a bucket

The following rb example removes a bucket. In this example, the user's bucket is amzn-s3-demo-bucket. Note that the bucket must be empty in order to remove it.

aws s3 rb s3://amzn-s3-demo-bucket

Output:

remove_bucket: amzn-s3-demo-bucket

Example 2: To force delete a bucket

The following rb example uses the --force parameter to first remove all of the objects in the bucket and then remove the bucket itself. In this example, the user's bucket is amzn-s3-demo-bucket and the objects in amzn-s3-demo-bucket are test1.txt and test2.txt.

aws s3 rb s3://amzn-s3-demo-bucket \
    --force

Output:

delete: s3://amzn-s3-demo-bucket/test1.txt
delete: s3://amzn-s3-demo-bucket/test2.txt
remove_bucket: amzn-s3-demo-bucket

For more information, see Using high-level (s3) commands in the AWS CLI in the AWS CLI User Guide.

To create a restore request for an object

The following restore-object example restores the specified Amazon S3 Glacier object for the bucket amzn-s3-demo-bucket for 10 days.

aws s3api restore-object \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf \
    --restore-request Days=10

This command produces no output.

For more information, see Restoring an archived object in the Amazon S3 User Guide.

Example 1: To delete an S3 object

The following rm example deletes a single S3 object.

aws s3 rm s3://amzn-s3-demo-bucket/test2.txt

Output:

delete: s3://amzn-s3-demo-bucket/test2.txt

Example 2: To delete all contents in a bucket

The following rm example recursively deletes all objects under a specified bucket and prefix when passed with the parameter --recursive. In this example, the bucket amzn-s3-demo-bucket contains the objects test1.txt and test2.txt.

aws s3 rm s3://amzn-s3-demo-bucket \
    --recursive

Output:

delete: s3://amzn-s3-demo-bucket/test1.txt
delete: s3://amzn-s3-demo-bucket/test2.txt

Example 3: To delete all contents in a bucket, except ``.jpg`` files

The following rm example recursively deletes all objects under a specified bucket and prefix when passed with the parameter --recursive while excluding some objects by using an --exclude parameter. In this example, the bucket amzn-s3-demo-bucket has the objects test1.txt and test2.jpg.

aws s3 rm s3://amzn-s3-demo-bucket/ \
    --recursive \
    --exclude "*.jpg"

Output:

delete: s3://amzn-s3-demo-bucket/test1.txt

Example 4: To delete all contents in a bucket, except objects under the specified prefix

The following rm example recursively deletes all objects under a specified bucket and prefix when passed with the parameter --recursive while excluding all objects under a particular prefix by using an --exclude parameter. In this example, the bucket amzn-s3-demo-bucket has the objects test1.txt and another/test.txt.

aws s3 rm s3://amzn-s3-demo-bucket/ \
    --recursive \
    --exclude "another/*"

Output:

delete: s3://amzn-s3-demo-bucket/test1.txt

Example 5: To delete an object from an S3 access point

The following rm example deletes a single object (mykey) from the access point (myaccesspoint).

aws s3 rm s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey

Output:

delete: s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey

For more information, see Using high-level (s3) commands in the AWS CLI in the AWS CLI User Guide.

To filter the contents of an Amazon S3 object based on an SQL statement

The following select-object-content example filters the object my-data-file.csv with the specified SQL statement and sends output to a file.

aws s3api select-object-content \
    --bucket amzn-s3-demo-bucket \
    --key my-data-file.csv \
    --expression "select * from s3object limit 100" \
    --expression-type 'SQL' \
    --input-serialization '{"CSV": {}, "CompressionType": "NONE"}' \
    --output-serialization '{"CSV": {}}' "output.csv"

This command produces no output.

For more information, see Querying data in place with Amazon S3 Select in the Amazon S3 User Guide.

Example 1: To sync all local objects to the specified bucket

The following sync example syncs objects from a local directory to the specified prefix and bucket by uploading the local files to S3. A local file will require uploading if the size of the local file is different than the size of the S3 object, the last modified time of the local file is newer than the last modified time of the S3 object, or the local file does not exist under the specified bucket and prefix. In this example, the user syncs the bucket amzn-s3-demo-bucket to the local current directory. The local current directory contains the files test.txt and test2.txt. The bucket amzn-s3-demo-bucket contains no objects.

aws s3 sync . s3://amzn-s3-demo-bucket

Output:

upload: test.txt to s3://amzn-s3-demo-bucket/test.txt
upload: test2.txt to s3://amzn-s3-demo-bucket/test2.txt

Example 2: To sync all S3 objects from the specified S3 bucket to another bucket

The following sync example syncs objects under a specified prefix and bucket to objects under another specified prefix and bucket by copying S3 objects. An S3 object will require copying if the sizes of the two S3 objects differ, the last modified time of the source is newer than the last modified time of the destination, or the S3 object does not exist under the specified bucket and prefix destination.

In this example, the user syncs the bucket amzn-s3-demo-bucket to the bucket amzn-s3-demo-bucket2. The bucket amzn-s3-demo-bucket contains the objects test.txt and test2.txt. The bucket amzn-s3-demo-bucket2 contains no objects.

aws s3 sync s3://amzn-s3-demo-bucket s3://amzn-s3-demo-bucket2

Output:

copy: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket2/test.txt
copy: s3://amzn-s3-demo-bucket/test2.txt to s3://amzn-s3-demo-bucket2/test2.txt

Example 3: To sync all S3 objects from the specified S3 bucket to the local directory

The following sync example syncs files from the specified S3 bucket to the local directory by downloading S3 objects. An S3 object will require downloading if the size of the S3 object differs from the size of the local file, the last modified time of the S3 object is newer than the last modified time of the local file, or the S3 object does not exist in the local directory. Take note that when objects are downloaded from S3, the last modified time of the local file is changed to the last modified time of the S3 object. In this example, the user syncs the bucket amzn-s3-demo-bucket to the current local directory. The bucket amzn-s3-demo-bucket contains the objects test.txt and test2.txt. The current local directory has no files.

aws s3 sync s3://amzn-s3-demo-bucket .

Output:

download: s3://amzn-s3-demo-bucket/test.txt to test.txt
download: s3://amzn-s3-demo-bucket/test2.txt to test2.txt

Example 4: To sync all local objects to the specified bucket and delete all files that do not match

The following sync example syncs objects under a specified prefix and bucket to files in a local directory by uploading the local files to S3. Because of the --delete parameter, any files existing under the specified prefix and bucket but not existing in the local directory will be deleted. In this example, the user syncs the bucket amzn-s3-demo-bucket to the local current directory. The local current directory contains the files test.txt and test2.txt. The bucket amzn-s3-demo-bucket contains the object test3.txt.

aws s3 sync . s3://amzn-s3-demo-bucket \
    --delete

Output:

upload: test.txt to s3://amzn-s3-demo-bucket/test.txt
upload: test2.txt to s3://amzn-s3-demo-bucket/test2.txt
delete: s3://amzn-s3-demo-bucket/test3.txt

Example 5: To sync all local objects to the specified bucket except ``.jpg`` files

The following sync example syncs objects under a specified prefix and bucket to files in a local directory by uploading the local files to S3. Because of the --exclude parameter, all files matching the pattern existing both in S3 and locally will be excluded from the sync. In this example, the user syncs the bucket amzn-s3-demo-bucket to the local current directory. The local current directory contains the files test.jpg and test2.txt. The bucket amzn-s3-demo-bucket contains the object test.jpg of a different size than the local test.jpg.

aws s3 sync . s3://amzn-s3-demo-bucket \
    --exclude "*.jpg"

Output:

upload: test2.txt to s3://amzn-s3-demo-bucket/test2.txt

Example 6: To sync all local objects to the specified bucket except specified directory files

The following sync example syncs files under a local directory to objects under a specified prefix and bucket by downloading S3 objects. This example uses the --exclude parameter flag to exclude a specified directory and S3 prefix from the sync command. In this example, the user syncs the local current directory to the bucket amzn-s3-demo-bucket. The local current directory contains the files test.txt and another/test2.txt. The bucket amzn-s3-demo-bucket contains the objects another/test5.txt and test1.txt.

aws s3 sync s3://amzn-s3-demo-bucket/ . \
    --exclude "*another/*"

Output:

download: s3://amzn-s3-demo-bucket/test1.txt to test1.txt

Example 7: To sync all objects between buckets in different regions

The following sync example syncs files between two buckets in different regions.

aws s3 sync s3://amzn-s3-demo-bucket1 s3://amzn-s3-demo-bucket2 \
    --source-region us-west-2 \
    --region us-east-1

Output:

download: s3://amzn-s3-demo-bucket1/test1.txt to s3://amzn-s3-demo-bucket2/test1.txt

Example 8: To sync to an S3 access point

The following sync example syncs the current directory to the access point (myaccesspoint).

aws s3 sync . s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/

Output:

upload: test.txt to s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/test.txt
upload: test2.txt to s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/test2.txt

For more information, see Using high-level (s3) commands in the AWS CLI in the AWS CLI User Guide.

To upload part of an object by copying data from an existing object as the data source

The following upload-part-copy example uploads a part by copying data from an existing object as a data source.

aws s3api upload-part-copy \
    --bucket amzn-s3-demo-bucket \
    --key "Map_Data_June.mp4" \
    --copy-source "amzn-s3-demo-bucket/copy_of_Map_Data_June.mp4" \
    --part-number 1 \
    --upload-id "bq0tdE1CDpWQYRPLHuNG50xAT6pA5D.m_RiBy0ggOH6b13pVRY7QjvLlf75iFdJqp_2wztk5hvpUM2SesXgrzbehG5hViyktrfANpAD0NO.Nk3XREBqvGeZF6U3ipiSm"

Output:

{
    "CopyPartResult": {
        "LastModified": "2019-12-13T23:16:03.000Z",
        "ETag": "\"711470fc377698c393d94aed6305e245\""
    }
}

For more information, see Copying an object using multipart upload in the Amazon S3 User Guide.

To upload a part of a multipart upload

The following upload-part example uploads the first part in a multipart upload initiated with the create-multipart-upload command.

aws s3api upload-part \
    --bucket amzn-s3-demo-bucket \
    --key 'multipart/01' \
    --part-number 1 \
    --body part01 \
    --upload-id "dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R"

The body option takes the name or path of a local file for upload (do not use the file:// prefix). The minimum part size is 5 MB. Upload ID is returned by create-multipart-upload and can also be retrieved with list-multipart-uploads. Bucket and key are specified when you create the multipart upload.

Output:

{
    "ETag": "\"e868e0f4719e394144ef36531ee6824c\""
}

Save the ETag value of each part for later. They are required to complete the multipart upload.

For more information, see Uploading and copying objects using multipart upload in Amazon S3 in the Amazon S3 User Guide.

To configure an S3 bucket as a static website

The following website example configures a bucket named amzn-s3-demo-bucket as a static website. The index document option specifies the file in amzn-s3-demo-bucket that visitors will be directed to when they navigate to the website URL. In this case, the bucket is in the us-west-2 region, so the site would appear at http://amzn-s3-demo-bucket.s3-website-us-west-2.amazonaws.com.

All files in the bucket that appear on the static site must be configured to allow visitors to open them. File permissions are configured separately from the bucket website configuration.

aws s3 website s3://amzn-s3-demo-bucket/ \
    --index-document index.html \
    --error-document error.html

This command produces no output.

For information on hosting a static website in Amazon S3, see Hosting a Static Website in the Amazon Simple Storage Service Developer Guide.