GetBucketVersioning接口用于获取指定Bucket的版本控制状态。

请求语法

GET /?versioning HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

响应元素

名称 类型 描述
VersioningConfiguration 容器 保存版本控制状态的容器

子节点：Status

父节点：无
Status 字符串 版本控制状态

父节点：VersioningConfiguration

有效值：
  • Enabled：开启版本控制状态
  • Suspended：暂停版本控制状态

示例

请求示例 
GET /?versioning HTTP/1.1
Host: bucket-versioning.oss-cn-hangzhou.aliyuncs.com
Date: Tue, 09 Apr 2019 02:28:18 GMT
Authorization: OSS pu4kyewh6qk6nut:2TeHBmWY36GwdwS0JFiRb+NV****

返回示例

  • 已开启版本控制的返回示例 
    HTTP/1.1 200 OK
x-oss-request-id: 5CAC0342B7AEADE01700****
Date: Tue, 09 Apr 2019 02:28:18 GMT 
Content-Length: 121
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<VersioningConfiguration>
    <Status>Enabled</Status>
</VersioningConfiguration>
  • 未曾开启版本控制的返回示例

    如果该Bucket未曾开启版本控制状态，则XML中不会返回版本控制Status信息。

    HTTP/1.1 200 OK
x-oss-request-id: 5CAC015CB7AEADE01700****
Date: Tue, 09 Apr 2019 02:20:12 GMT 
Content-Length: 74
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<VersioningConfiguration xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com"/>

SDK

此接口所对应的各语言SDK如下：

错误码

错误码 HTTP状态码 描述
AccessDenied 403 无权限查看Bucket的版本控制状态。

只有Bucket拥有者及授予了GetBucketVersioning权限的RAM用户才能查看Bucket的版本控制状态。
NoSuchBucket 404 访问的Bucket不存在。