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

Object Storage Service:bucket-versioning

最終更新日:Feb 22, 2024

オブジェクトが誤って上書きまたは削除された後、いつでも以前のバージョンに復元するには、bucket-versioningコマンドを実行してバージョン管理を有効にします。 Object Storage Service (OSS) では、バケットに格納されているオブジェクトを保護するために、バケットのバージョン管理を設定できます。 バケットのバージョン管理を有効にすると、バケット内の既存のオブジェクトが上書きまたは削除されると、以前のバージョンとして保存されます。

使用上の注意

  • このトピックのサンプルコマンドラインは、64ビットLinuxシステムに基づいています。 他のシステムの場合は、を交換します。対応するバイナリ名を持つコマンドの /ossutil64。 詳細は、「ossutilコマンドリファレンス」をご参照ください。

  • バージョン管理の詳細については、「概要」をご参照ください。

バケットのバージョン管理ステータスの設定

  • コマンド構文

    . /ossutil64 bucket-versioning -- メソッドput oss:// bucketnameバージョン管理

    次の表に、上記のコマンドのパラメーターを示します。

    パラメーター

    説明

    bucketname

    バージョン管理ステータスを設定するバケットの名前。

    バージョン管理

    設定するバケットのバージョン管理ステータス。 有効な値:

    • enabled: バケットのバージョン管理が有効になっています。 バージョン管理が有効になっているバケットにオブジェクトがアップロードされると、オブジェクトのグローバルに一意なバージョンIDとしてランダムな文字列が生成されます。 詳細については、「バージョン管理が有効なバケット内のオブジェクトの管理」をご参照ください。

    • suspended: バケットのバージョン管理が一時停止されています。 バージョン管理が一時停止されているバケットにオブジェクトがアップロードされると、アップロードされたオブジェクトのバージョンIDはnullになります。 詳細については、「バージョン管理が一時停止されたバケット内のオブジェクトの管理」をご参照ください。

    重要

    デフォルトでは、バケットのバージョン管理ステータスは無効になっています。 バケットのバージョン管理を有効にすると、バケットのバージョン管理ステータスを無効に戻すことはできません。 ただし、バージョン管理が有効なバケットのバージョン管理は一時停止できます。

  • 次のコマンドを実行して、examplebucketという名前のバケットのバージョン管理を有効にします。

    . /ossutil64 bucket-versioning -- メソッドput oss:// examplebucket enabled

    次のコマンドを実行して、examplebucketという名前のバケットのバージョン管理を一時停止します。

    . /ossutil64 bucket-versioning -- メソッドput oss:// examplebucket suspended

    同様の出力が表示される場合、examplebucketという名前のバケットのバージョン管理ステータスが設定されます。

    0.261209経過

バケットのバージョン管理ステータスの照会

  • コマンド構文

    . /ossutil64 bucket-versioning -- メソッドget oss:// bucketname
  • 次のコマンドを実行して、examplebucketという名前のバケットのバージョン管理ステータスを照会します。

    . /ossutil64 bucket-versioning -- メソッドget oss:// examplebucket

    同様の出力が表示される場合、バケットのバージョン管理が有効になります。

    バケットのバージョン管理ステータス: 有効
    
    0.218001経過 

    同様の出力が表示される場合、バケットのバージョン管理は一時停止されます。

    バケットのバージョン管理ステータス: 一時停止
    
    0.168791経過 

    同様の出力が表示される場合、バケットのバージョン管理は無効になります。

    バケットのバージョン管理ステータス: Null
    
    0.158691経過 

関連する API 操作

  • OSSは、バージョン管理が有効なバケットとバージョン管理されていないバケットにアップロードされるオブジェクトを同じ方法で管理します。 バケットのバージョン管理を有効にすると、バケットにアップロードするオブジェクトのグローバルに一意なバージョンIDが生成されます。 詳しくは、「オブジェクトのアップロード」をご参照ください。

  • バケットのバージョン管理を有効にすると、バケット内で上書きまたは削除されたオブジェクトは以前のバージョンとして保存されます。 バージョンIDを指定して、指定したバージョンのオブジェクトをダウンロードできます。 詳しくは、「オブジェクトのダウンロード」をご参照ください。 バージョンIDを指定すると、オブジェクトの指定された以前のバージョンを復元できます。 詳細については、「オブジェクトのコピー」をご参照ください。

一般的なオプション

ossutilを使用して別のリージョンにあるバケットに切り替える場合は、コマンドに -eオプションを追加して、指定したバケットがあるリージョンのエンドポイントを指定します。 ossutilを使用して別のAlibaba Cloudアカウントに属するバケットに切り替える場合、コマンドに -iオプションを追加して、指定されたアカウントのAccessKey IDを指定し、コマンドに -kオプションを追加して、指定されたアカウントのAccessKeyシークレットを指定します。

たとえば、次のコマンドを実行して、中国 (杭州) リージョンにあり、別のAlibaba Cloudアカウントが所有するexamplebucketという名前のバケットのバージョン管理を有効にできます。

. /ossutil64バケットバージョン管理 -- メソッドput oss:// examplebucket enabled -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA **** -k 67DLVBkH7EamOjy2W5RVAHUY9H ****

同期コマンドに使用できるその他の一般的なオプションの詳細については、「オプションの表示」をご参照ください。