| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
GET Bucket requestPayment
Description
This implementation of the GET operation uses the
requestPayment subresource to return the request payment
configuration of a bucket. To use this version of the operation, you must be the bucket
owner. For more information, see Requester Pays Buckets.
Requests
Syntax
GET ?requestPayment HTTP/1.1 Host:BucketName.s3.amazonaws.com Date:DateAuthorization:Signature
Request Parameters
This implementation of the operation does not use request parameters.
Request Headers
This implementation of the operation uses only request headers that are common to all operations. For more information, see Common Request Headers.
Responses
Response Headers
This implementation of the operation uses only response headers that are common to most responses. For more information, see Common Response Headers.
Response Elements
| Name | Description |
|---|---|
Payer
|
Specifies who pays for the download and request fees. Type: Enum Valid Values: Requester | BucketOwner Ancestor: RequestPaymentConfiguration |
RequestPaymentConfiguration
|
Container for Type: Container |
Special Errors
This implementation of the operation does not return special errors. For general information about Amazon S3 errors and a list of error codes, see Error Responses.
Examples
Sample Request
The following request returns the payer for the bucket,
colorpictures.
GET ?requestPayment HTTP/1.1 Host: colorpictures.s3.amazonaws.com Date: Wed, 01 Mar 2009 12:00:00 GMT Authorization: AWS AKIAIOSFODNN7EXAMPLE:xQE0diMbLRepdf3YB+FIEXAMPLE=
Sample Response
HTTP/1.1 200 OK x-amz-id-2: YgIPIfBiKa2bj0KMg95r/0zo3emzU4dzsD4rcKCHQUAdQkf3ShJTOOpXUueF6QKo x-amz-request-id: 236A8905248E5A01 Date: Wed, 01 Mar 2009 12:00:00 GMT Content-Type: [type] Content-Length: 0 Connection: close Server: AmazonS3 <?xml version="1.0" encoding="UTF-8"?> <RequestPaymentConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Payer>Requester</Payer> </RequestPaymentConfiguration>
This response shows that the bucket is a Requester Pays bucket, meaning the person requesting a download from this bucket pays the transfer fees.
