Amazon Simple Stora ge Ser vice - Amazon Web Services

1 Amazon Simple storage ServiceDeveloper GuideAPI Version 2006-03-01 Amazon Simple storage Service: Developer GuideCopyright 2014 Amazon Web Services , Inc. and/or its affiliates. All rights following are trademarks of Amazon Web Services , Inc.: Amazon , Amazon Web Services Design, AWS, Amazon CloudFront,Cloudfront, Amazon DevPay, DynamoDB, ElastiCache, Amazon EC2, Amazon Elastic Compute Cloud, Amazon Glacier, Kindle, KindleFire, AWS Marketplace Design, Mechanical Turk, Amazon Redshift, Amazon Route 53, Amazon S3, Amazon VPC.

2 In addition, graphics, logos, page headers, button icons, scripts, and service names are trademarks, or trade dress of Amazon inthe and/or other countries. Amazon 's trademarks and trade dress may not be used in connection with any product or service thatis not Amazon 's, in any manner that is likely to cause confusion among customers, or in any manner that disparages or other trademarks not owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connectedto, or sponsored by Simple storage Service Developer GuideTable of ContentsWhat Is Amazon S3?

3 1 How Do 2 Overview of Amazon S3 and This 2 Advantages to Amazon 2 Amazon S3 4 Amazon S3 Data Consistency 7 Reduced Redundancy 7 Bucket 7 AWS Identity and Access 8 Access Control 8 Amazon S3 Application Programming Interfaces (API).. 9 The REST 9 The SOAP 9 Paying for Amazon 9 Related Services .. 10 Making 11 About Access 11 AWS Account Access 11 IAM User Access 12 Temporary Security 12 Request 13 Making Requests Using the AWS 14 Using AWS Account or IAM User 15 Using IAM User Temporary 20 Using Federated User Temporary 31 Making Requests Using the REST 47 Virtual Hosting of 48 Request Redirection and the REST 55 Restrictions and 56 Rules for 56 Configuration 57 Buckets and 57 Bucket Website 59 Using the AWS Management 60 Using the SDK for Java.

4 60 Using the SDK for . 63 Using the SDK for 66 Using the REST 68 Requester Pays 69 Configure Requester Pays by Using the Amazon S3 69 Configure Requester Pays with the REST 70 DevPay and Requester 72 Charge 72 Buckets and Access 73 Billing and Reporting of 73 Cost Allocation 73 API Version 2006-03-01iiiAmazon Simple storage Service Developer GuideConfiguration 75 Object Key and 76 Object 76 Object 80 Lifecycle 83 Overview .. 84 Lifecycle Configuration 85 Object Archival .. 93 Object 95 Specifying a Lifecycle 95 Cross-Origin Resource 107 Cross-Origin Resource Sharing: 108 How Do I Enable CORS on My Bucket?

5 108 How Does Amazon S3 Evaluate the CORS Configuration On a Bucket?.. 110 Using the AWS Management 111 Using the SDK for Java .. 111 Using the SDK for . 116 Using the REST 122 Troubleshooting CORS 122 Operations on 122 Multipart Upload Overview .. 123 Getting 127 Related 127 Using the SDK for Java .. 128 Using the SDK for . 131 Using the SDK for 134 Using the REST 136 Share an Object with 136 Uploading 142 Related 142 Uploading Objects in a Single 143 Uploading Objects Using Multipart Upload 151 Uploading Objects Using Pre-Signed 187 Copying 193 Related 194 Copying Objects in a Single 195 Copying Objects Using the Multipart Upload 204 Listing Object 212 Iterating Through Multi-Page 213 Using a Prefix and 213 Using the SDK for Java.

6 214 Using the SDK for . 217 Using the SDK for 219 Using the REST 222 Related 222 Deleting 222 Deleting Objects from a Version-Enabled 222 Deleting Objects from an MFA-Enabled 223 Related 223 Deleting One Object Per 223 Deleting Multiple Objects Per 233 Restoring 255 Using the 256 Using the SDK for Java .. 257 Using the SDK for . 259 API Version 2006-03-01ivAmazon Simple storage Service Developer GuideUsing the REST 262 Managing 263 Overview .. 264 How Amazon S3 Authorizes a 269 Guidelines for Using the Available Access Policy 274 Example Walkthroughs: Managing 277 Using Bucket Policies and User 305 Access Policy Language Overview.

7 305 Bucket Policy 329 User Policy 335 Managing Access with ACLs .. 356 Access Control List (ACL) Overview .. 356 Managing 361 Data 373 Data 373 Server-Side 374 Client-Side 397 Reduced Redundancy 409 Setting the storage Class of an Object You 410 Changing the storage Class of an Object in Amazon 411 Enabling a Bucket's Versioning 412 Adding Objects to Versioning-Enabled 417 Listing the Objects in a Versioning-Enabled 417 Retrieving Object 419 Deleting Object 421 Transitioning Object 426 Restoring Previous 426 Versioned Object Permissions and 427 Working with Versioning-Suspended 428

8 Hosting a Static 433 Website 434 Key Differences Between the Amazon Website and the REST API 435 Configure a Bucket for Website 436 Overview .. 436 Syntax for Specifying Routing 438 Index Document Support .. 442 Custom Error Document Support .. 443 Configuring a 445 Permissions Required for Website 447 Example 447 Example: Setting Up a Static 448 Example: Setting Up a Static Website Using a Custom 449 Setting Up Notification of Bucket 457 Request 461 Request Redirection and the REST 461 Overview.

9 461 DNS 461 Temporary Request 462 Permanent Request 464 DNS 465 Performance 466 Request Rate and Performance 466 Workloads with a Mix of Request Types .. 467 GET-Intensive 469 TCP Window 469 TCP Selective 470 API Version 2006-03-01vAmazon Simple storage Service Developer 471 How You are Charged for BitTorrent Delivery .. 471 Using BitTorrent to Retrieve Objects Stored in Amazon 472 Publishing Content Using Amazon S3 and 473 Amazon DevPay .. 474 Amazon S3 Customer Data 475 Amazon DevPay Token 475 Amazon S3 and Amazon DevPay 475 Amazon S3 Bucket 476 Amazon S3 and Amazon DevPay 477 Additional 477 Error 478 The REST Error 478 Response 479 Error 479 The SOAP Error 480 Amazon S3 Error Best 480 Retry 480 Tune Application for Repeated SlowDown 480 Isolate 481 Server Access 482 Overview.

10 482 Log Object Key 483 How are Logs Delivered?.. 483 Best Effort Server Log Delivery .. 483 Bucket Logging Status Changes Take Effect Over 484 Related 484 Enabling Logging Using 484 Enabling Logging 486 Enabling 486 Granting the Log Delivery Group Write 486 Example: AWS SDK for . 487 Log 489 Custom Access Log 491 Programming Considerations for Extensible Server Access Log 491 Additional Logging for Copy Operations .. 491 Deleting Log 493 AWS SDKs and 494 Specifying Signature Version in Request 495 Using the AWS SDK for Java.