バケットのバージョン管理状態を設定します。
使用上の注意
バケットのバージョン管理状態を設定する前に、PutBucketVersioning権限が必要です。
バケットは、無効、有効、または一時停止のいずれかのバージョン管理状態にすることができます。 デフォルトでは、バケットのバージョン管理は無効になっています。
バケットのバージョン管理が有効になっている場合、バケットに追加されたすべてのオブジェクトに対して一意のバージョンIDが生成されます。 この場合、OSSは複数のバージョンのオブジェクトを保存します。
バケットのバージョン管理が一時停止されている場合、バケットに追加されたすべてのオブジェクトに対してバージョンID nullが生成されます。 この場合、削除または上書きされたオブジェクトの新しいバージョンは保存されません。
バージョン管理の詳細については、「概要」をご参照ください。
リクエスト構文
PUT /? バージョン管理HTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<VersioningConfiguration>
<ステータス> 有効 </ステータス>
</VersioningConfiguration>
リクエストヘッダー
このリクエストには、共通リクエストヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。
リクエストパラメーター
パラメーター | データ型 | 必須 | 例 | 説明 |
VersioningConfiguration | Container | 必須 | N/A | バケットのバージョン管理状態を格納するコンテナー。 子ノード: ステータス 親ノード: なし |
ステータス | String | 必須 | Enabled | バケットのバージョン管理状態。 親ノード: VersioningConfiguration 有効な値:
|
レスポンスヘッダー
このリクエストには、共通のレスポンスヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。
例
バケットのバージョン管理を有効にするためのサンプルリクエスト
PUT /? バージョン管理HTTP/1.1 ホスト: bucket-versioning.oss-cn-hangzhou.aliyuncs.com 日付: 4月2019日火曜日02:20:12 GMT 権限付与: OSS e7thre3jj5mlvqk:12ztptkaR8a74gIGFzOaZZQe **** <?xml version="1.0" encoding="UTF-8"?> <VersioningConfiguration> <ステータス> 有効 </ステータス> </VersioningConfiguration>
レスポンスの例
HTTP/1.1 200 OK x-oss-request-id: 5CAC015CB7AEADE01700 **** 日付: 4月2019日火曜日02:20:12 GMT コンテンツ長: 0 接続: キープアライブ サーバー: AliyunOSS
バケットのバージョン管理を一時停止するためのサンプルリクエスト
PUT /? バージョン管理HTTP/1.1 ホスト: bucket-versioning.oss-cn-hangzhou.aliyuncs.com 日付: 4月2019日火曜日02:28:18 GMT 承認: OSS m2qa99e9tpkaehr:DWAzr2EkqDwFJNke1Nuaogn7 **** <?xml version="1.0" encoding="UTF-8"?> <VersioningConfiguration> <ステータス> 中断 </ステータス> </VersioningConfiguration>
レスポンスの例
HTTP/1.1 200 OK x-oss-request-id: 5CAC0342B7AEADE01700 **** 日付: 4月2019日火曜日02:28:18 GMT コンテンツ長: 0 接続: キープアライブ サーバー: AliyunOSS
OSS SDK
次のプログラミング言語のOSS SDKを使用して、バケットのバージョン管理を一時停止できます。
エラーコード
エラーコード | HTTPステータスコード | 説明 |
AccessDenied | 403 | バケットのバージョン管理状態を設定する権限がない場合に返されるエラーメッセージ。 |
InvalidArgument | 400 | 構成するバージョン管理の状態が無効な場合に返されるエラーメッセージ。 バケットのバージョン管理状態を有効または一時停止のみに設定できます。 |