Object Storage Service:OSSオブジェクトをローカルコンピューターに同期する, OSSオブジェクトをローカルコンピューターに同期する

使用上の注意

• OSSからコンピューターにオブジェクトを同期するには、oss:GetObjectおよびoss:ListObjects権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

• バイナリ名

  ossutil 1.6.16以降の場合、コマンドラインでossutilをバイナリ名として直接使用できます。 オペレーティングシステムに基づいてバイナリ名を更新する必要はありません。 1.6.16より前のossutilの場合、オペレーティングシステムに基づいてバイナリ名を更新する必要があります。 詳細は、「ossutilコマンドリファレンス」をご参照ください。

• 同期するローカルファイルの数

  -- deleteオプションを含めずにsyncコマンドを実行する場合、一度に同期できるローカルファイルの数に制限はありません。 syncコマンドの実行時に -- deleteオプションを含めると、一度に最大100万個のローカルファイルを同期できます。 同期するローカルファイルの数が1百万を超える場合、最大同期数1000000を超える。 エラーメッセージが返されます。

• syncコマンドとcpコマンドの違い

  • syncコマンドは、特定のディレクトリ内のすべてのオブジェクトとサブディレクトリを再帰的に同期します。 cpコマンドは、-rオプションが指定されている場合にのみ、オブジェクトを再帰的に同期します。

  • syncコマンドは、-- backup-dirオプションをサポートしています。 syncコマンドを実行してデータをOSSに同期する場合、コマンドでこのオプションを指定して、宛先に存在するがソースには存在しないオブジェクトを格納するためにOSSのディレクトリを指定できます。 cpコマンドは -- backup-dirオプションをサポートしていません。

  • syncコマンドは -- version-idオプションをサポートしていません。 したがって、syncコマンドを使用して、バージョン管理されたバケット内の以前のバージョンのオブジェクトを同期することはできません。 cpコマンドは、-- version-idオプションをサポートしています。

  上記の違いを除いて、syncコマンドとcpコマンドを同様に使用できます。 cpコマンドの実行方法の詳細については、「オブジェクトのダウンロード」をご参照ください。

コマンド構文

ossutil sync cloud_url  file_url
[-f --force]
[-u --update]
[--maxdownspeed <value>]
[--delete]
[--backup-dir <value>]
[--enable-symlink-dir]
[--disable-all-symlink]
[--disable-ignore-error]
[--only-current-dir]
[--output-dir <value>]
[--bigfile-threshold <value>]
[--part-size <value>]
[--checkpoint-dir <value>]
[--range <value>]
[--encoding-type <value>]
[--snapshot-path <value>]
[--include <value>]
[--exclude <value>]
[--disable-crc64]
[--payer <value>]
[-j, --job <value>]
[--parallel <value>]
[--retry-times <value>]

次の表に、コマンド構文のパラメーターとオプションを示します。

例

examplebucketという名前のバケットのlocaldirディレクトリには、オブジェクトa.txtとb.txt、およびCという名前のサブディレクトリが含まれています。d.txtという名前のローカルファイルは、ローカルルートディレクトリのdestdirディレクトリに格納されます。 次の構造は、同期前のコンピュータとOSSのファイルとディレクトリを示しています。

examplebucket           Local root directory
└── localdir/             └── destdir/
       ├── a.txt                └── d.txt
       ├── b.txt
       └── C/

• examplebucketのlocaldirディレクトリをコンピューターに同期します。

  ossutil sync  oss://examplebucket/localdir/  destdir/ 

  上記のコマンドを実行すると、a.txtおよびb.txtオブジェクトとCディレクトリがコンピュータのdestfolderディレクトリに追加されます。 次の構造は、同期後のコンピュータとOSSのファイルとディレクトリを示しています。

  examplebucket           Local root directory
  └── localdir/             └── destdir/
         ├── a.txt                ├── a.txt 
         ├── b.txt                ├── b.txt
         └── C/                   ├── d.txt
                                     └── C/

• examplebucketバケットのlocaldirディレクトリをdestdirという名前のローカルディレクトリに同期します。 コマンドで -- backup-dirオプションをbackupという名前のディレクトリに設定して、destdirディレクトリに存在するがlocaldirディレクトリには存在しないオブジェクトを格納します。 これらのオブジェクトはdestdirディレクトリから削除されます。

  ossutil sync oss://examplebucket/localdir/  destdir/  --delete  --backup-dir backup/

  コマンドを実行すると、examplebucketバケットのlocaldirディレクトリがコンピュータのdestdirディレクトリに同期されます。 destdirディレクトリに存在し、localdirディレクトリに存在しないオブジェクトは、backupディレクトリに移動されます。 同期後、a.txtとb.txtという名前の同期オブジェクトとCという名前のサブディレクトリのみがdestdirディレクトリに格納されます。 同期前にdestdirディレクトリに存在するd.txtオブジェクトは、backupディレクトリに移動されます。 次の構造は、バックアップディレクトリを指定して同期した後のコンピュータとOSSのファイルとディレクトリを示しています。

  examplebucket              Local root directory
  └── localdir/               ├── destdir/
         ├── a.txt            │     ├── a.txt 
         ├── b.txt            │     ├── b.txt
         └── C/               │     └── C/                             
                                 └── backup/
                                        └──d.txt

• 上記のコマンドが正常に実行されると、次の内容のような出力が返され、同期されたオブジェクトの数、同期されたオブジェクトのサイズ、および同期に費やされた時間が示されます。

  Succeed: Total num: 2, size: 750,081. OK num: 2(upload 2 files).
  
  average speed 1641000(byte/s)

一般的なオプション

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

ossutil sync oss://examplebucket/srcfolder/  examplefolder/ -e oss-cn-shanghai.aliyuncs.com -i LTAI****************  -k yourAccessKeySecret

共通オプションの詳細については、「共通オプション」をご参照ください。