设置存储分区请求者付款

默认情况下,存储分区未启用请求者付款。如需为现有存储分区启用或停用请求者付款功能,您需要发出 Bucket 请求(仅适用于存储分区)并使用 billing 查询字符串参数。您必须在请求正文中添加 XML 文档,以指明您要启用或停用该功能。您无法为正在创建的新存储分区设置请求者付款。

您必须具有 storage.buckets.update 权限才能为现有存储分区启用或停用请求者付款功能。

查询字符串参数

参数 说明 必需
billing 为存储分区启用或停用请求者付款功能时使用。如果在 PUT 存储分区请求中使用,则请求正文应指定启用或停用状态。

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

请求标头

请参阅常见请求标头

请求正文元素

以下请求正文元素仅在您使用 billing 查询字符串参数为现有存储分区启用或停用请求者付款功能时适用。

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

请求语法

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

<?xml version="1.0" encoding="UTF-8"?>
<BillingConfiguration>
  <RequesterPays>
     Enabled | Disabled
  </RequesterPays>
</BillingConfiguration>

响应标头

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

响应正文元素

响应的响应正文中不包含 XML 文档。

示例

以下示例为名为 my-bucket 的存储分区启用了请求者付款功能。

请求

PUT /?billing HTTP/1.1
Host: my-bucket.storage.googleapis.com
Date: Thu, 12 Mar 2012 03:38:42 GMT
Content-Length: 121
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

<?xml version="1.0" encoding="UTF-8"?>
<BillingConfiguration>
  <RequesterPays>Enabled</RequesterPays>
</BillingConfiguration>

响应

HTTP/1.1 200 OK
Date: Thu, 12 Mar 2012 03:38:42 GMT
Expires: Mon, 01 Jan 1990 00:00:00 GMT
Cache-Control: no-cache, no-store, must-revalidate
Content-Length: 0
Content-Type: text/html