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

请求语法

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

响应元素

名称 类型 描述
VersioningConfiguration 容器

保存 Bucket Versioning 状态的容器

子节点:Status

父节点:无

Status 字符串

Bucket Versioning 状态

父节点:VersioningConfiguration

有效值:
  • Enabled (已开启版本控制状态)
  • Suspended(暂停版本控制状态)
说明 如果该 Bucket 未曾开启版本控制状态,则 XML 中将不会返回 Status 信息。

示例

请求示例
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>
  • 未曾开启版本控制的返回示例
    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"/>
错误码 HTTP 状态码 描述
AccessDenied 403 无权限查看 Bucket 的版本控制状态。只有 Bucket 的拥有者才能查看 Bucket 的版本控制状态。
NoSuchBucket 404 访问的 Bucket 不存在。