すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:PutBucketVersioning

最終更新日:Feb 22, 2024

バケットのバージョン管理状態を設定します。

使用上の注意

  • バケットのバージョン管理状態を設定する前に、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

有効な値:

  • Enabled: バケットのバージョン管理が有効になっていることを示します。

  • Suspended: バケットのバージョン管理が一時停止されていることを示します。

レスポンスヘッダー

このリクエストには、共通のレスポンスヘッダーのみが含まれます。 詳細については、「共通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

構成するバージョン管理の状態が無効な場合に返されるエラーメッセージ。 バケットのバージョン管理状態を有効または一時停止のみに設定できます。