To return a bucket's Requester Pays status, you make a GET request that is
scoped to the desired bucket, and you use the billing query string parameter.
The bucket's status is returned in an XML document in the response body.
You must have storage.buckets.get permission to check the Requester Pays
status for a bucket.
Query string parameters
| Parameter | Description | Required |
|---|---|---|
billing |
Use this to return the status of Requester Pays for the bucket. | No |
See signed URL query string parameters for information on the parameters you include when creating and using signed URLs.
Request headers
Request body elements
This request does not include an XML document in the request body.
Request syntax
The following syntax applies to GET Bucket requests that use the
billing query string parameter.
GET /?billing HTTP/1.1 Host: BUCKET_NAME.storage.googleapis.com Date: DATE Content-Length: 0 Authorization: AUTHENTICATION_STRING
Response headers
The request can return a variety of response headers depending on the request headers you use.
Response body elements
The following response body elements are applicable only if you use the
billing query string parameter to get the status of the Requester Pays feature
for the bucket.
| Element | Description |
|---|---|
BillingConfiguration |
The container for RequesterPays. |
RequesterPays |
The status of the Requester Pays feature. The
status is given as Enabled or Disabled. |
Example
The following example retrieves the Requester Pays status for a bucket named
my-bucket. In this example, the bucket has Requester Pays enabled.
Request
GET /?billing HTTP/1.1 Host: my-bucket.storage.googleapis.com Date: Thu, 24 Jan 2016 02:34:56 GMT Content-Length: 0 Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
Response
HTTP/1.1 200 OK Date: Thu, 24 Jan 2016 02:34:56 GMT Expires: Mon, 01 Jan 1990 00:00:00 GMT Cache-Control: no-cache, no-store, must-revalidate Content-Length: 121 Content-Type: text/html <?xml version="1.0" encoding="UTF-8"?> <BillingConfiguration> <RequesterPays>Enabled</RequesterPays> </BillingConfiguration>