Welcome to Amazon S3
Introduction to Amazon S3
Making Requests
- Making Requests using AWS SDKs
- Making Requests using the REST API
Working with Amazon S3 Buckets
- Bucket Restrictions and Limitations
- Bucket Configuration Options
  - Buckets and Regions
- Managing Bucket Website Configuration
- Requester Pays Buckets
- Buckets and Access Control
- Billing and Reporting of Buckets
Working with Amazon S3 Objects
- Object Key and Metadata
- Object Subresources
- Object Versioning
- Object Expiration
  - Manage Object Expiration Using AWS Management Console
  - Manage Object Expiration Using the REST API
- Operations on Objects
  - Multipart Upload Overview
- Getting Objects
- Uploading Objects
- Copying Objects
  - Copying Objects in a Single Operation
  - Copying Objects Using the Multipart Upload API
- Listing Object Keys
- Deleting Objects
  - Deleting One Object Per Request
  - Deleting Multiple Objects Per Request
Access Control
- Using IAM Policies
- Using Bucket Policies
- Using ACLs
- Using ACLs and Bucket Policies Together
- Using Query String Authentication
Data Protection
- Using Data Encryption
  - Using Server-Side Encryption
  - Using Client-Side Encryption
    - Specifying Client-Side Encryption Using the AWS SDK for Java
      - Customizing Your Client-Side Encryption Environment
- Using Reduced Redundancy Storage
  - Setting the Storage Class of an Object You Upload
  - Changing the Storage Class of an Object in Amazon S3
    - Return Code For Lost Data
- Using Versioning
Hosting Websites on Amazon S3
- Setting Up a Website
- Website Endpoints
- Index Document Support
- Custom Error Document Support
- How Do I Configure My Bucket As a Website?
- Permissions Required for Website Access
Setting Up Notification of Bucket Events
Request Routing
- Request Redirection and the REST API
- DNS Considerations
Performance Optimization
- TCP Window Scaling
- TCP Selective Acknowledgement
Using BitTorrent with Amazon S3
- How You are Charged for BitTorrent Delivery
- Using BitTorrent to Retrieve Objects Stored in Amazon S3
- Publishing Content Using Amazon S3 and BitTorrent
Using Amazon DevPay with Amazon S3
- Amazon S3 Customer Data Isolation
- Amazon DevPay Token Mechanism
- Amazon S3 and Amazon DevPay Authentication
- Amazon S3 Bucket Limitation
- Amazon S3 and Amazon DevPay Process
- Additional Information
Handling Errors
- The REST Error Response
  - Error Response
- The SOAP Error Response
- Amazon S3 Error Best Practices
Server Access Logging
- Server Access Logging Configuration API
- Delivery of Server Access Logs
- Server Access Log Format
- Setting Up Server Access Logging
Using the AWS SDKs and Explorers
- Using the AWS SDK for Java
- Using the AWS SDK for .NET
- Using the AWS SDK for PHP
- Using the AWS SDK for Ruby
Appendices
- Appendix A: The Access Policy Language
- Appendix B: Using the SOAP API
Amazon S3 Resources
Document History
Glossary
Index

Did this page help you? Yes No Tell us about it...

Downloading Objects in Requester Pays Buckets

Because requesters are charged for downloading data from Requester Pays buckets, the requests must contain a special parameter, x-amz-request-payer, which demonstrates the requester knows he or she will be charged for the download. To access objects in Requester Pays buckets, requests must include one of the following.

For GET and POST requests, include x-amz-request-payer : requester in the header
For signed URLs, include x-amz-request-payer=requester in the request

If the request succeeds and the requester is charged, the response includes the header x-amz-request-charged:requester. If x-amz-request-payer is not in the request, Amazon S3 returns a 403 error and charges the bucket owner for the request.

Note

Bucket owners do not need to add x-amz-request-payer to their requests.

Make sure to include x-amz-request-payer and its value in your signature calculation. For more information, see Constructing the CanonicalizedAmzHeaders Element.

To download objects from a Requester Pays bucket

Use a GET request to download an object from a Requester Pays bucket, as shown in the following request.

GET / [destinationObject] HTTP/1.1
Host: [BucketName].s3.amazonaws.com
x-amz-request-payer : requester
Date: Wed, 01 Mar 2009 12:00:00 GMT
Authorization: AWS [Signature]

If the GET request succeeds and the requester is charged, the response includes x-amz-request-charged:requester.

Amazon S3 can return Access Denied errors for requests trying to get objects from Requester Pays buckets. For more information, go to ErrorCodeList.

Document Conventions
Terms of Use

Did this page help you? Yes No Tell us about it...

Warning

Javascript is disabled or is unavailable in your browser.
To use the AWS Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.