revert-versioning - Object Storage Service - Alibaba Cloud ドキュメントセンター

このトピックでは、revert-versioningコマンドを実行して、バージョン管理が有効なバケット内のオブジェクトを最新の以前のバージョンに復元する方法について説明します。

使用上の注意

このトピックのサンプルコマンドラインは、64ビットLinuxシステムに基づいています。他のシステムの場合は、を交換します。対応するバイナリ名を持つコマンドの /ossutil64。詳細については、「ossutilの使用を開始する」をご参照ください。
バージョン管理の詳細については、「概要」をご参照ください。
削除マーカーの詳細については、「マーカーの削除」をご参照ください。

コマンド構文

. /ossutil64 revert-versioning oss:// bucketname[/prefix]
[-- encoding-type <value>]
[-r, -- recursive]
[-- start-time <value> ]
[-- end-time <value>]
[-- include <value>]
[-- exclude <value>]
[-- payer <value>]

次の表に、revert-versioningコマンドを実行するために構成できるオプションを示します。

オプション	説明
bucketname	復元するオブジェクトを含むバケットの名前。
プレフィックス	指定されたプレフィックスを名前に含むバケット内のリソース (ディレクトリやオブジェクトなど) 。
-- encoding-type	`oss:// bucket_name`に続くプレフィックスをエンコードするために使用されるメソッド。有効値: url このオプションを指定しない場合、プレフィックスはエンコードされません。
-r, -- recursive	このオプションを指定すると、プレフィックスオプションで指定されたプレフィックスを名前に含むすべてのオブジェクトが、最新の以前のバージョンに復元されます。このオプションを指定しない場合、ossutilは指定されたオブジェクトのみを最新の以前のバージョンに復元します。
-- 開始時間	UNIXタイムスタンプ。このオプションを指定すると、今回より前に削除されたオブジェクトは復元されません。
-終了時間	UNIXタイムスタンプ。このオプションを指定した場合、この時間以降に削除されたオブジェクトは復元されません。
-含める	指定された条件を満たすすべてのオブジェクトにコマンドが適用されることを指定します。詳細は、「revert-versioning」をご参照ください。
-除外	指定された条件を満たさないすべてのオブジェクトにコマンドが適用されることを指定します。詳細は、「revert-versioning」をご参照ください。
-- 支払人	リクエストの支払人。指定されたパスのリソースにアクセスするリクエスタにトラフィックとリクエスト料金の支払いをさせたい場合は、このオプションをrequesterに設定します。

例

特定のオブジェクトを復元する方法の例
- examplebucketバケット内の削除されたexampleobject.jpgオブジェクトを最新の以前のバージョンに復元します。
```
. /ossutil64 revert-versioning oss:// examplebucket/exampleobject.jpg
```
- examplebucketバケットに格納され、名前に指定されたdestdirプレフィックスが含まれている複数の削除済みオブジェクトを、-rオプションを指定して最新の以前のバージョンに復元します。
```
. /ossutil64 revert-versioning oss:// examplebucket/destdir -r
```
- -rオプションを指定して、examplebucketバケット内のすべての削除されたオブジェクトを最新の以前のバージョンに復元します。
```
. /ossutil64 revert-versioning oss:// examplebucket -r
```
- 特定の期間に削除されたオブジェクトを最新の以前のバージョンに復元します。
  2020年6月16日 (UTC + 8) 、UTC + 8の16:22:58から16:39:38まで削除され、examplebucketバケットに保存されているオブジェクトを、-rオプションを指定して最新の以前のバージョンに復元します。
```
. /ossutil64 revert-versioning oss:// examplebucket -r -- start-time 1592295778 -- end-time 1592296778
```
- 指定された条件を満たすすべての削除されたオブジェクトを最新の以前のバージョンに復元します。
  - -rオプションを指定して、examplebucketバケット内のすべての削除されたTXTオブジェクトを最新の以前のバージョンに復元します。
```
. /ossutil64 revert-versioning oss:// examplebucket -- include "*.txt" -r
```
  - -rオプションを指定して、JPGオブジェクトを除くすべての削除済みオブジェクトを最新の以前のバージョンに復元します。
```
./ossutil64 revert-versioning oss:// examplebucket -- exclude "*.jpg" -r 
```
Output
指定されたオブジェクトが復元された後、復元されたオブジェクトの数とこれらのオブジェクトの復元に費やされた時間を示す結果が返されます。例：
```
復帰バージョン管理オブジェクト数は10、バッチリスト数は10

0.066413経過 
```

一般的なオプション

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

たとえば、次のコマンドを実行して、testbucketバケット内のexampletest.pngオブジェクトを最新の以前のバージョンに復元できます。 testbucketバケットは中国 (上海) リージョンにあり、別のAlibaba Cloudアカウントが所有しています。

. /ossutil64 revert-versioning oss:// testbucket/exampletest.png -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA **** -k 67DLVBkH7EamOjy2W5RVAHUY9H ****

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