获取存储分区请求者付款

如需返回存储分区的请求者付款状态,您需要发出范围限定至所需存储分区的 GET 请求,并使用 billing 查询字符串参数。在响应正文的 XML 文档中返回存储分区的状态。

您必须具有 storage.buckets.get 权限才能检查存储分区的请求者付款功能状态。

查询字符串参数

参数 说明 必需
billing 它用于返回存储分区的请求者付款状态。

如需了解您在创建和使用签名网址时包含的参数,请参阅签名网址查询字符串参数

请求标头

请参阅常见请求标头

请求正文元素

此请求不包含 XML 文档。

请求语法

以下语法适用于使用 billing 查询字符串参数的 GET 存储分区请求。

GET /?billing HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: 0
Authorization: AUTHENTICATION_STRING

响应标头

请求可以返回各种响应标头,具体取决于您使用的请求标头。

响应正文元素

以下响应正文元素仅适用于使用 billing 查询字符串参数获取存储分区的请求者付款功能的状态。

元素 说明
BillingConfiguration RequesterPays 的容器。
RequesterPays 请求者付款功能的状态。状态显示为 EnabledDisabled

示例

以下示例检索名为 my-bucket 的存储分区的请求者付款功能状态。在此示例中,存储分区启用了请求者付款功能。

请求

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

响应

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>