设置存储分区版本控制

默认情况下,存储分区未启用版本控制。如需为现有存储分区设置或修改版本控制配置,您需要发出 PUT 请求(范围限定于存储分区)并使用 versioning 查询字符串参数。您必须针对您要应用的版本控制配置加入 XML 文档。请注意,您不能为正在创建的新存储分区设置版本控制配置。

您必须具有 FULL_CONTROL 权限才能设置现有存储分区的版本控制配置或对其进行修改。此外,您还必须经过身份验证才能使用 PUT 存储分区方法。

查询字符串参数

参数 说明 必需
versioning 您可以使用此命令更改现有存储分区的版本控制配置。您必须在请求正文中提供 VersioningConfiguration 文档。

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

请求标头

请参阅常见请求标头

请求正文元素

以下请求正文元素仅在您使用 versioning 查询字符串参数为现有存储分区指定版本控制配置时才适用。

元素 说明
VersioningConfiguration 用于配置版本控制的容器。
Status 此存储分区的版本控制状态。目前可以是 EnabledSuspended

请求语法

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

XML_DOCUMENT_DEFINING_VERSIONING

响应标头

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

响应正文元素

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

示例

以下示例为名为 acme-pets 的存储分区启用了对象版本控制。

请求

PUT /?versioning HTTP/1.1
Host: acme-pets.storage.googleapis.com
Date: Thu, 12 Mar 2012 03:38:42 GMT
Content-Length: 113
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

<?xml version="1.0" encoding="UTF-8"?>
<VersioningConfiguration><Status>Enabled</Status></VersioningConfiguration>

响应

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