GetBucketVersioning介面用於擷取指定Bucket的版本控制狀態。
請求文法
GET /?versioning HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
要求標頭
此介面僅涉及公用要求標頭。更多資訊,請參見公用要求標頭(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不存在。 |