Object Storage Service:ローカルファイルをOSSに同期する

使用上の注意

• ローカルファイルをOSSに同期するには、oss:PutObject、oss:ListObjects、およびoss:DeleteObject権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

• バイナリ名

  このトピックでは、64ビットLinuxシステムで動作するサンプルコマンドラインを提供します。 他のシステムのために、取り替えて下さい./ossutil64対応するバイナリ名を持つコマンドで 詳細は、「ossutilコマンドリファレンス」をご参照ください。

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

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

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

  • syncコマンドは、特定のディレクトリ内のすべてのファイルとサブディレクトリを再帰的に同期します。 -rオプションが指定されている場合だけ, cpコマンドは再帰的にファイルをアップロードします。

  • syncコマンドを実行してローカルソースからOSSバケットにデータを同期する場合、コマンドに -- deleteオプションを追加して、ローカルソースには存在しないがバケットに存在するすべてのファイルを削除できます。 これにより、同期されたファイルのみがバケットに保持されます。 cpコマンドは -- deleteオプションをサポートしていません。

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

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

コマンド構文

. /ossutil64 sync file_url cloud_url
[-f -- force]
[-u -- 更新]
[-- 削除]
[-- enable-symlink-dir]
[-- disable-all-symlink]
[-- disable-無視-エラー]
[-- only-current-dir]
[-- output-dir <value>]
[-- bigfile-threshold <value>]
[-- part-size <value>]
[-- checkpoint-dir <value>]
[-- encoding-type <value>]
[-- snapshot-path <value>]
[-- include <value>]
[-- exclude <value>]
[-- meta <value>]
[-- acl <value>]
[-- maxuppspeed <value>]
[-- disable-crc64]
[-- payer <value>]
[-j, -- job <value>]
[-- parallel <value>]
[-- retry-times <value>]
[-- tagging <value>] 

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

例

d.txtとe.pngという名前の2つのファイルが、ローカルルートディレクトリのlocalfolderディレクトリに保存されます。 examplebucketという名前のバケットのdestfolderディレクトリには、a.txtとb.txtという名前の2つのオブジェクトと、Cという名前のサブディレクトリが含まれています。次の構造は、同期前のコンピュータとOSS上のファイルとディレクトリを示しています。

ローカルルートディレクトリexamplebucket
    └ ─ ─ localfolder ─ ─ destfolder /
            â ─ ─ d.txt â ─ a.txt
            â ─ ─ e.png â ─ b.txt
                                    └ ─ ─ C/ 

次の例は、さまざまなシナリオで同期コマンドを実行してローカルファイルをOSSに同期する方法を示しています。

• コンピューターのlocalfolderディレクトリをexamplebucketに同期する

  ./ossutil64 sync localfolder/ oss:// examplebucket/destfolder /

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

  ローカルルートディレクトリexamplebucket
      └ ─ ─ localfolder ─ ─ destfolder /
              â ─ ─ d.txt â ─ a.txt
              â ─ ─ e.png â ─ b.txt
                                      â ─ ─ d.txt 
                                      â ─ ─ e.png 
                                      └ ─ ─ C /
                          

• を同期します。localfolderディレクトリからexamplebucketバケットへのtxtオブジェクト

  ./ossutil64 sync localfolder/ oss:// examplebucket/destfolder/ -"*.txt" を含む

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

  ローカルルートディレクトリexamplebucket
      └ ─ ─ localfolder ─ ─ destfolder /
              â ─ ─ d.txt â ─ a.txt
              â ─ ─ e.png â ─ b.txt
                                      â ─ ─ d.txt 
                                      └ ─ ─ C /
                          

• localfolderディレクトリからexamplebucketバケットへの非TXTオブジェクトの同期

  ./ossutil64 sync localfolder/ oss:// examplebucket/destfolder/ -- exclude "*.txt"

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

  ローカルルートディレクトリexamplebucket
      └ ─ ─ localfolder ─ ─ destfolder /
              â ─ ─ d.txt â ─ a.txt
              â ─ ─ e.png â ─ b.txt
                                      â ─ ─ e.png 
                                      └ ─ ─ C /
                          

• コンピューターのlocalfolderディレクトリをexamplebucketに同期し、同期されたオブジェクトのみをexamplebucketのdestfolderディレクトリに保持します。

  コマンドに -- deleteオプションを追加して、localfolderディレクトリに存在しないすべてのオブジェクトをdestfolderディレクトリから削除します。 これにより、同期されたオブジェクトのみがdestfolderディレクトリに保持されます。

  ./ossutil64 sync localfolder/ oss:// examplebucket/destfolder/ -- 削除

  上記のコマンドを実行すると、localfolderディレクトリがコンピューターからexamplebucketバケットに同期されます。 examplebucketバケットのdestfolderディレクトリ内のa.txtおよびb.txtオブジェクトとCサブディレクトリが削除されます。 同期されたd.txtおよびe.pngオブジェクトのみが、examplebucketバケットのdestfolderディレクトリに保持されます。 次の構造は、同期後のコンピュータとOSS上のファイルとディレクトリを示しています。

  ローカルルートディレクトリexamplebucket
      └ ─ ─ localfolder ─ ─ destfolder /
              â ─ ─ d.txt â ─ d.txt
              â ─ ─ e.png â ─ e.png 

• 確認なしに、コンピューターからexamplebucketバケットにlocalfolderディレクトリを同期します

  デフォルトでは、ローカルディレクトリをOSSバケットに同期するときに、OSSバケットにローカルディレクトリ内のファイルと同じ名前のオブジェクトが含まれている場合、次のサンプルコマンドに示すように、バケット内の既存のオブジェクトを上書きするかどうかを確認するよう求められます。

  . /ossutil64 sync localfolder/ oss:// examplebucket/destfolder /
  cp: "oss:// examplebucket/destfolder/d.txt"(yまたはN)? 

  examplebucketバケット内のオブジェクトを上書きできることを確認した場合は、次のサンプルコマンドに示すように、コマンドに -f,-- forceオプションを追加して、バケット内の既存のオブジェクトを強制的に上書きできます。

  ./ossutil64 sync localfolder/ oss:// examplebucket/destfolder/ -f

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

  ローカルルートディレクトリexamplebucket
      └ ─ ─ localfolder ─ ─ destfolder /
              â ─ ─ d.txt â ─ a.txt
              â ─ ─ e.png â ─ b.txt
                                      â ─ ─ d.txt 
                                      â ─ ─ e.png
                                      └ ─ ─ C /
                      

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

  成功: 合計数: 2、サイズ: 750,081。 OK num: 2 (2ファイルアップロード) 。
  
  平均速度1641000 (バイト /秒) 

一般的なオプション

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

./ossutil64 sync srcfolder/ oss:// examplebucket/testfolder/ -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA **** -k 67DLVBkH7EamOjy2W5RVAHUY9H ****

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