GetBucketVersioning接口用于獲取指定Bucket的版本控制狀態。
請求語法
GET /?versioning HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
當您在OSS ON云盒中調用該接口時,您需要將Host替換為云盒Endpoint。更多信息,請參見云盒Endpoint。
請求頭
此接口僅涉及公共請求頭。更多信息,請參見公共請求頭(Common Request Headers)。
響應頭
此接口僅涉及公共響應頭。更多信息,請參見公共響應頭(Common Response Headers)。
響應元素
名稱 | 類型 | 示例值 | 描述 |
VersioningConfiguration | 容器 | 不涉及 | 保存版本控制狀態的容器。 子節點:Status 父節點:無 |
Status | 字符串 | Enabled | 版本控制狀態 父節點:VersioningConfiguration 有效值:
說明 如果Bucket從未開啟版本控制,則響應元素中不包含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 qn6q**************:77Dv****************
返回示例
已開啟版本控制的返回示例
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不存在。 |
文檔內容是否對您有幫助?