## 功能描述此接口用于获取存储桶的版本控制状态。 ## 注意事项 * 只有拥有 `GetBucketVersioning` 权限的用户才能调用 `GetBucketVersioning` 接口。默认情况下，存储桶的所有者直接拥有 `GetBucketVersioning` 权限，存储桶所有者也可以将该权限授予给其他用户。使用桶策略实现权限控制的详细说明，请参见[存储桶授权策略管理](/docs/6349/102126)。 * [分层桶](/docs/6349/1282866)不支持 GetBucketVersioning 接口。 ## 请求消息样式 ```JSON GET /?versioning HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: GMT Date Authorization: authorization string ``` ## 请求参数和消息头该请求使用的公共请求消息头，请参见[公共参数](/docs/6349/75044)。 |**名称** |**位置** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---|---| |versioning |Query |String |是 |\- |代表 GetBucketVersioning 请求的特殊标识。 | ## 请求元素该请求不使用消息元素。 ## 响应消息头该请求返回的公共响应消息头，请参见[公共参数](/docs/6349/75044)。 ## 响应元素 |**名称** |**参数类型** |**示例值** |**说明** | |---|---|---|---| |Status |String |Enabled |存储桶的版本控制状态，取值如下：|\ | | | ||\ | | | |* `Enabled`：开启版本控制功能。|\ | | | |* `Suspended`：暂停版本控制功能。|\ | | | |* 空：未开启版本控制功能。 | ## 请求示例 ```JSON GET /?versioning HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: Wed, 20 Sep 2023 02:39:48 GMT Authorization: authorization string ``` ## 响应示例 ```JSON HTTP/1.1 200 OK x-tos-id-2: ef60010a5b74f967650a5b74-ac1a2718-1qin80-GBV-cb-tos-front-aza-1 x-tos-request-id: ef60010a5b74f967650a5b74-ac1a2718-1qin80-GBV-cb-tos-front-aza-1 Date: Wed, 20 Sep 2023 02:28:54 GMT Content-Length: 20 server: TosServer { "Status": "Enabled" } ```

对象存储