赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 开发参考
  5. API参考
  6. 关于Bucket操作
  7. 版本控制(Versioning)
  8. GetBucketVersioning

GetBucketVersioning

  • 版本控制(Versioning)
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

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

有效值:

  • 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如下:

  • Java

  • Python

  • Go V2

  • C++

  • .NET

  • Node.js

命令行工具ossutil

GetBucketVersioning接口所对应的ossutil命令,请参见get-bucket-versioning。

错误码

错误码

HTTP状态码

描述

AccessDenied

403

无权限查看Bucket的版本控制状态。

只有Bucket拥有者及授予了GetBucketVersioning权限的RAM用户才能查看Bucket的版本控制状态。

NoSuchBucket

404

访问的Bucket不存在。

相关文章

PutBucketVersioning 2025-04-21 18:15

调用PutBucketVersioning设置指定存储空间(Bucket)的版本控制状态。

GetBucketVersioning 2025-04-21 18:15

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

ListObjectVersions(GetBucketVersions) 2025-04-21 18:15

ListObjectVersions(GetBucketVersions)接口用于列出Bucket中包括删除标记(Delete Marker)在内的所有Object的版本信息。

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号