この操作を呼び出して、バケットのバージョン管理状態をクエリできます。
リクエスト構文
GET /? versioning HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
リクエストヘッダー
DescribeRegions リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通リクエストヘッダー」をご参照ください。
レスポンスヘッダー
DescribeRegions リクエストへのレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。詳細については、「共通レスポンスヘッダー」をご参照ください。
レスポンス要素
要素 | タイプ | 例 | 説明 |
VersioningConfiguration | コンテナー | N/A | バケットのバージョン管理状態を格納するコンテナー。 子ノード: Status 親ノード: なし |
Status | 文字列 | Enabled | バケットのバージョン管理状態。 親ノード: VersioningConfiguration 有効な値:
説明 バケットのバージョン管理が有効になっていない場合、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>
バージョン管理が無効になっているバケットのレスポンスの例
リクエストされたバケットのバージョン管理が無効になっている場合、バケットのバージョン管理状態はレスポンスの XML 本文に含まれません。
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"/>
OSS SDK
次のプログラミング言語の OSS SDK を使用して、GetBucketVersioning 操作を呼び出すことができます。
ossutil
GetBucketVersioning 操作に対応する ossutil コマンドについては、「get-bucket-versioning」をご参照ください。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
AccessDenied | 403 | バケットのバージョン管理状態を照会する権限がないために返されるエラーメッセージ。 バケットの所有者、または GetBucketVersioning 権限を持つ RAM ユーザーのみが、バケットのバージョン管理状態を照会できます。 |
NoSuchBucket | 404 | 指定されたバケットが存在しないために返されるエラーメッセージ。 |