GET Bucket requestPayment
Description
This implementation of the GET
operation uses the requestPayment
sub-resource 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
Requests
Syntax
GET ?requestPayment HTTP/1.1 Host:BucketName
.s3.amazonaws.com Date:Date
Authorization:Signature
Request Parameters
This implementation of the operation does not use request parameters.
Request Headers
This implementation of the operation only uses request headers 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 15B4D3461F177624206A: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.