全部產品
Search
文件中心

Object Storage Service:GetBucketVersioning

更新時間:Jun 19, 2024

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

有效值:

  • Enabled:開啟版本控制狀態

  • Suspended:暫停版本控制狀態

說明

如果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不存在。