この操作では、バケットのバージョン管理状態を照会します。
リクエスト構文
GET /? HTTP/1.1のバージョン管理
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue リクエストヘッダー
このリクエストには、共通リクエストヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。
レスポンスヘッダー
このリクエストには、共通のレスポンスヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。
レスポンス要素
| 要素 | データ型 | 例 | 説明 |
| VersioningConfiguration | Container | N/A | バケットのバージョン管理状態を格納するコンテナー。 子ノード: ステータス 親ノード: なし |
| ステータス | String | Enabled | バケットのバージョン管理状態。 親ノード: VersioningConfiguration 有効な値：
説明 バケットのバージョン管理が有効になっていない場合、Status要素はレスポンス要素に含まれません。 |
例
サンプルリクエスト
GET /? HTTP/1.1のバージョン管理
ホスト: bucket-versioning.oss-cn-hangzhou.aliyuncs.com
日付: 4月2019日火曜日02:28:18 GMT
承認: OSS pu4kyewh6qk6nut:2TeHBmWY36GwdwS0JFiRb + NV **** レスポンスの例
- HTTP/1.1 200 OKバージョン管理が有効
になっているバケットのサンプル応答 x-oss-request-id: 5CAC0342B7AEADE01700 **** 日付: 4月2019日火曜日02:28:18 GMT コンテンツ-長さ: 121 Content-Type: application/xml 接続: キープアライブ サーバー: AliyunOSS <? xml version="1.0" encoding="UTF-8"? > <VersioningConfiguration> <ステータス> 有効 </ステータス> </VersioningConfiguration> - バージョン管理が無効になっているバケットのサンプル応答
要求されたバケットのバージョン管理が無効になっている場合、バケットのバージョン管理状態は応答のXML本文に含まれません。
HTTP/1.1 200 OK x-oss-request-id: 5CAC015CB7AEADE01700 **** 日付: 4月2019日火曜日02:20:12 GMT コンテンツ-長さ: 74 Content-Type: application/xml 接続: キープアライブ サーバー: AliyunOSS <VersioningConfiguration xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com"/>
OSS SDK
次のプログラミング言語のOSS SDKを使用して、GetBucketVersioning操作を呼び出すことができます。
エラーコード
| エラーコード | HTTPステータスコード | 説明 |
| AccessDenied | 403 | バケットのバージョン管理状態を照会する権限がない場合に返されるエラーメッセージ。 GetBucketVersioning権限を持つバケット所有者またはRAMユーザーのみが、バケットのバージョン管理状態を照会できます。 |
| NoSuchBucket | 404 | 指定されたバケットが存在しない場合に返されるエラーメッセージ。 |