Amazon Simple Storage Service - AWS …

1 Amazon Simple Storage ServiceDeveloper GuideAPI Version 2006-03-01 Amazon Simple Storage Service Developer GuideAmazon Simple Storage Service : Developer GuideCopyright 2018 Amazon Web services , Inc. and/or its affiliates. All rights 's trademarks and trade dress may not be used in connection with any product or Service that is not Amazon 's, in any mannerthat is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon . All other trademarks notowned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored Simple Storage Service Developer GuideTable of ContentsWhat Is Amazon S3? .. 1 How Do .. 1 Introduction.

2 2 Overview of Amazon S3 and This Guide .. 2 Advantages to Amazon S3 .. 2 Amazon S3 Concepts .. 3 Buckets .. 3 Objects .. 3 Keys .. 3 Regions .. 4 Amazon S3 Data Consistency Model .. 4 Amazon S3 Features .. 6 Storage 6 Bucket Policies .. 6 AWS Identity and Access Management .. 7 Access Control Lists .. 7 Versioning .. 7 Amazon S3 Application Programming Interfaces (API) .. 8 The REST Interface .. 8 The SOAP Interface .. 8 Paying for Amazon S3 .. 9 Related services .. 9 Making Requests .. 10 About Access Keys .. 10 AWS Account Access Keys .. 10 IAM User Access Keys .. 10 Temporary Security Credentials .. 11 Request Endpoints .. 11 Making Requests over IPv6 .. 12 Getting Started with IPv6 .. 12 Using IPv6 Addresses in IAM Policies.

3 13 Testing IP Address Compatibility .. 14 Using Dual-Stack 14 Making Requests Using the AWS SDKs .. 18 Using AWS Account or IAM User Credentials .. 18 Using IAM User Temporary Credentials .. 25 Using Federated User Temporary Credentials .. 34 Making Requests Using the REST API .. 44 Dual-Stack Endpoints (REST API).. 45 Virtual Hosting of Buckets .. 45 Request Redirection and the REST API .. 49 Buckets .. 52 Creating a Bucket .. 52 About Permissions .. 53 Accessing a Bucket .. 54 Bucket Configuration Options .. 54 Restrictions and Limitations .. 56 Rules for 57 Examples of Creating a Bucket .. 57 Using the Amazon S3 Console .. 58 Using the AWS SDK for Java .. 58 Using the AWS SDK for .NET .. 59 Using the AWS SDK for Ruby Version 3.

4 60 API Version 2006-03-01iiiAmazon Simple Storage Service Developer GuideUsing Other AWS SDKs .. 61 Deleting or Emptying a Bucket .. 61 Delete a Bucket .. 61 Empty a Bucket .. 63 Default Encryption for a Bucket .. 65 How to Set Up Amazon S3 Default Bucket Encryption .. 65 Moving to Default Encryption from Using Bucket Policies for Encryption Enforcement .. 66 Using Default Encryption with Cross-Region Replication .. 66 Monitoring Default Encryption with CloudTrail and CloudWatch .. 67 More Info .. 67 Bucket Website Configuration .. 68 Using the AWS Management Console .. 68 Using the AWS SDK for Java .. 68 Using the AWS SDK for .NET .. 69 Using the SDK for 71 Using the REST 72 Transfer Acceleration .. 72 Why use Transfer Acceleration?

5 72 Getting Started .. 73 Requirements for Using Amazon S3 Transfer Acceleration .. 74 Transfer Acceleration Examples .. 74 Requester Pays Buckets .. 79 Configure with the Console .. 80 Configure with the REST API .. 80 Charge Details .. 82 Access Control .. 83 Billing and Usage Reporting .. 83 Billing Reports .. 83 Usage Report .. 85 Understanding Billing and Usage Reports .. 86 Using Cost Allocation Tags .. 92 Objects .. 94 Object Key and Metadata .. 95 Object Keys .. 95 Object Metadata .. 97 Storage 99 Storage Classes for Frequently Accessed Objects .. 100 Storage Classes for Infrequently Accessed Objects .. 100 GLACIER Storage Class .. 101 Storage Classes: Comparing Durability and Availability .. 102 Setting the Storage Class of an Object.

6 103 Subresources .. 103 Versioning .. 104 Object Tagging .. 106 API Operations Related to Object Tagging .. 107 Object Tagging and Additional Information .. 108 Managing Object Tags .. 111 Lifecycle Management .. 114 When Should I Use Lifecycle Configuration? .. 115 How Do I Configure a Lifecycle? .. 115 Additional Considerations .. 115 Lifecycle Configuration Elements .. 120 Examples of Lifecycle Configuration .. 127 Setting Lifecycle Configuration .. 136 Cross-Origin Resource Sharing (CORS) .. 145 Cross-Origin Resource Sharing: Use-case Scenarios .. 145 How Do I Configure CORS on My Bucket? .. 146 API Version 2006-03-01ivAmazon Simple Storage Service Developer GuideHow Does Amazon S3 Evaluate the CORS Configuration on a Bucket?

7 148 Enabling CORS .. 148 Troubleshooting CORS .. 154 Operations on Objects .. 154 Getting Objects .. 155 Uploading Objects .. 163 Copying Objects .. 205 Listing Object Keys .. 216 Deleting Objects .. 222 Selecting Content from Objects .. 241 Restoring Archived Objects .. 244 Querying Archived Objects .. 248 Storage Class 252 How to Set Up Storage Class Analysis .. 252 Storage Class 253 How Can I Export Storage Class Analysis Data? .. 255 Storage Class Analysis Export File Layout .. 256 Amazon S3 Analytics REST APIs .. 257 Inventory .. 258 How to Set Up Amazon S3 Inventory .. 258 Amazon S3 Inventory Buckets .. 258 Setting Up Amazon S3 Inventory .. 259 Inventory Lists .. 260 Inventory Consistency .. 261 Location of Inventory Lists.

8 261 What Is an Inventory Manifest? .. 262 Notify When Inventory Is Complete .. 263>Querying Inventory with Athena .. 264 Amazon S3 Inventory REST APIs .. 265 Managing Access .. 266 Introduction .. 266 Overview .. 267 How Amazon S3 Authorizes a Request .. 272 Guidelines for Using the Available Access Policy Options .. 277 Example Walkthroughs: Managing Access .. 280 Using Bucket Policies and User Policies .. 306 Access Policy Language Overview .. 306 Bucket Policy Examples .. 335 User Policy Examples .. 344 Managing Access with ACLs .. 367 Access Control List (ACL) Overview .. 367 Managing ACLs .. 373 Protecting Data .. 379 Data Encryption .. 379 Server-Side Encryption .. 379 Client-Side Encryption .. 408 Versioning.

9 416 How to Configure Versioning on a Bucket .. 417 MFA Delete .. 418 Related Topics .. 419 Managing Objects in a Versioning-Enabled Bucket .. 421 Managing Objects in a Versioning-Suspended Bucket .. 435 Hosting a Static Website .. 439 Website Endpoints .. 440 Key Differences Between the Amazon Website and the REST API Endpoint .. 440 Configuring a Bucket for Website Hosting .. 441 API Version 2006-03-01vAmazon Simple Storage Service Developer GuideEnabling Website Hosting .. 441 Configuring Index Document Support .. 442 Permissions Required for Website Access .. 444(Optional) Configuring Web Traffic Logging .. 444(Optional) Custom Error Document Support .. 445(Optional) Configuring a Redirect .. 446 Example Walkthroughs.

10 453 Example: Setting up a Static Website .. 453 Example: Setting up a Static Website Using a Custom Domain .. 455 Example: Speed Up Your Website with Amazon CloudFront .. 461 Clean Up Example Resources .. 466 Overview .. 466 How to Enable Event Notifications .. 467 Event Notification Types and Destinations .. 469 Supported Event Types .. 469 Supported Destinations .. 469 Configuring Notifications with Object Key Name Filtering .. 470 Examples of Valid Notification Configurations with Object Key Name Filtering .. 470 Examples of Notification Configurations with Invalid Prefix/Suffix Overlapping .. 472 Granting Permissions to Publish Event Notification Messages to a Destination .. 474 Granting Permissions to Invoke an AWS Lambda Function.