Get Bucket Requester Pays

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

Request headers

See common 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>.storage.googleapis.com
Date: <date>
Content-Length: <request body length>
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>
Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Storage Documentation