cp コマンドは、オブジェクトをアップロード、ダウンロード、またはコピーする場合に使用します。

コマンド構文

  • オブジェクトをアップロードする
    ./ossutil cp file_url cloud_url  [-r] [-f] [-u] [--output-dir=odir] [--bigfile-threshold=size] [--checkpoint-dir=cdir] [--snapshot-path=sdir] [--payer requester]
  • オブジェクトをダウンロードする
    ./ossutil cp cloud_url file_url  [-r] [-f] [-u] [--output-dir=odir] [--bigfile-threshold=size] [--checkpoint-dir=cdir] [--range=x-y] [--payer requester]
  • オブジェクトをコピーする
    ./ossutil cp cloud_url cloud_url [-r] [-f] [-u] [--output-dir=odir] [--bigfile-threshold=size] [--checkpoint-dir=cdir] [--payer requester]

  • オブジェクトをアップロードする
    • 単一のオブジェクトをアップロードする
      ./ossutil cp a.txt oss://bucket/path
    • 単一のオブジェクトをアップロードし、--meta オプションを指定する
      オブジェクトをアップロードするとき、--meta オプションを使用して、オブジェクトメタデータを header:value#header:value... の形式で設定できます。 次のコマンドを実行して a.txt ファイルをアップロードし、メタデータを設定します。
      ./ossutil cp a.txt oss://bucket/path --meta=Cache-Control:no-cache#Content-Encoding:gzip
      メタ設定の詳細は、「set-meta」をご参照ください。
    • フォルダーをアップロードする
      -r オプションを cp コマンドに追加して、フォルダーを OSS にアップロードできます。 コマンドは次のとおりです。
      ./ossutil cp -r dir oss://bucket/path
      アップロードするオブジェクトがローカルフォルダーにマップするシンボリックリンクの場合、cp コマンドを使用してオブジェクトをアップロードするとき、シンボリックリンクにスラッシュ (/) を追加します。
      ./ossutil cp -r symbolic_link/ oss://bucket/path
    • オブジェクトまたはフォルダーをアップロードし、最大アップロード速度を設定する
      オブジェクトをアップロードするとき、--maxupspeed オプションを使用して最大アップロード速度 (KB/s) を設定します。デフォルト値は 0 です。これは、最大アップロード速度を設定しないことを示します。
      • オブジェクトをアップロードし、最大アップロード速度を 1 MB/s に設定する
        ./ossutil cp a.jpg oss://bucket/path --maxupspeed 1024
      • フォルダーをアップロードし、最大アップロード速度を 1 MB/s に設定する
        ./ossutil cp -r dir oss://bucket/path --maxupspeed 1024
    • 特定の条件を満たす複数のオブジェクトをアップロードする

      複数のオブジェクトをコピーするとき、--include/--exclude オプションを CP コマンドに追加して、オブジェクトの選定条件を指定できます。

      --include/--exclude オプションは、次の形式をサポートしています。
      • *:すべての文字に一致します。 たとえば、*.txt は、すべての txt オブジェクトを表します。
      • ? :任意の 1 文字に一致します。 たとえば、abc?.jpg は、abc の後に任意の 1 文字を含む名前を持つ JPG オブジェクト (abc1.jpg など) を表します。
      • [sequence]:シーケンス内の任意の文字に一致します。 たとえば、abc[1-5].jpg は、名前が abc で始まり、その後にシーケンス [1-5] に含まれる数字が続く名前を持つオブジェクト (abc1.jpg〜abc5.jpg など) を示します。
      • [! sequence]:シーケンスに存在しない文字に一致します。 たとえば、abc[! 0-7].jpg は、名前が abc で始まり、シーケンス [0-7] に含まれる数字が後に続かないオブジェクト (abc0.jpg〜abc7.jpg など) を示します。
      • --include "/usr/test/.jpg" など、ディレクトリを含む名前はサポートされていません。
      • --include/--exclude オプションを指定するには、--recursive(-r) オプションも指定する必要があります。
      • include と exclude で指定された複数の条件を 1 つのルールに含めることができます。 これらの条件が設定されている場合、ossutil は各ルールを左から右に順番に読み取り、最終的な一致結果を取得します。
        test.txt オブジェクトが有効なフォルダーに存在する場合、マッチングルールに基づいて結果が生成されます。
        • ルール 1:--include "*test*" --exclude "*.txt" 。 ossutil が --include "*test* 条件を読み取ったとき、test.txt オブジェクトは条件に一致します。 ossutil が --exclude "*.txt" 条件を読み取ったとき、test.txt オブジェクトは TXT 形式なので除外されます。 最終的な一致結果に test.txt オブジェクトは含まれません。
        • ルール 2:--exclude "*.txt" --include "*test*"。 ossutil が --exclude "*.txt" 条件を読み取ったとき、一致結果に test.txt オブジェクトは含まれません。 ossutil が --include "*test*" 条件を読み取ったとき、test.txt オブジェクト名に test が含まれるので条件に一致します。 最終的な一致結果に test.txt オブジェクトが含まれます。
        • ルール 3:--include "*test*" --exclude "*.txt" --include "te? t.txt" 。 ossutil が --include "*test*" 条件を読み取ったとき、test.txt オブジェクトは条件に一致します。 ossutil が --exclude "*.txt" 条件を読み取ったとき、test.txt オブジェクトは TXT 形式なので除外されます。 ossutil が --include "te? t.txt" 条件を読み取ったとき、test.txt オブジェクトは条件に一致します。 最終的な一致結果に test.txt オブジェクトは含まれます。
      例:
      • txt 形式のすべてのオブジェクトをアップロードする
        ./ossutil cp dir/ oss://my-bucket/path --include "*.txt" -r
      • 名前に abc を含み、形式が jpg または txt 以外のすべてのオブジェクトをアップロードする
        ./ossutil cp dir/ oss://my-bucket/path --include "*abc*" --exclude "*.jpg" --exclude "*.txt" -r
    • オブジェクトをアップロードし、ストレージクラスを変更する
      オブジェクトをアップロードするとき、--meta オプションを使用して、オブジェクトのストレージクラスを変更できます。
      • オブジェクトをアップロードし、ストレージクラスを IA に設定する
        ./ossutil cp dir/sys.log  oss://my-bucket/path --meta X-oss-Storage-Class:IA
      • フォルダーをアップロードし、フォルダー内のすべてのオブジェクトのストレージクラスを IA に設定する
        ./ossutil cp dir/ oss://my-bucket/path --meta X-oss-Storage-Class:IA -r
    • オブジェクトをアップロードし、サーバー側の暗号化方式を指定する
      オブジェクトをアップロードするとき、サーバー側の暗号化方式を指定できます。 オブジェクトを暗号化した後、そのオブジェクトをバケットに保存できます。 サーバー側暗号化の詳細は、「サーバー側暗号化」をご参照ください。
      • オブジェクトをアップロードし、サーバー側の暗号化方式を AES256 に設定する
        ./ossutil cp a.txt oss://my-bucket/path --meta=x-oss-server-side-encryption:AES256
      • オブジェクトをアップロードし、サーバー側の暗号化方式を KMS に設定する
        ./ossutil cp a.txt oss://my-bucket/path --meta=x-oss-server-side-encryption:KMS

        KMS を使用してオブジェクトを暗号化すると、KMS コンソールにオブジェクトのマスターキーが作成されます。KMS API 操作が呼び出されたときに少額の料金が発生します。

    • 既存のオブジェクトをアップロードせずにフォルダーをアップロードする

      複数のオブジェクトをアップロードするときに --update (短縮形 -u) オプションを指定すると、ターゲットに存在しないオブジェクト、または最終変更時刻がターゲットオブジェクトの最終変更時刻より後のオブジェクトのみがアップロードされます。 コマンドは次のとおりです。

      ./ossutil cp -r dir oss://bucket1/path -u

      このオプションを使用して、正常にアップロードされていないオブジェクトに対して増分アップロードを実行できます。

    • フォルダーをアップロードし、スナップショット情報を生成する

      複数のオブジェクトをアップロードするときに --snapshot-path オプションを指定すると、アップロードのスナップショットが取得され、指定したディレクトリにスナップショット情報が保存されます。 オブジェクトの次回アップロード時にこのオプションが指定されていると、ossutil は指定されたディレクトリからスナップショット情報を読み取り、増分アップロードを実行します。 コマンドは次のとおりです。

      ./ossutil cp -r dir oss://bucket1/path --snapshot-path=path                                
      重要
      • --snapshot-path オプションは、複数のオブジェクトの増分アップロードまたはダウンロードを加速するシナリオで使用されます。 このオプションは、オブジェクトの数が多く、2 回のアップロード中に他のユーザーが OSS のオブジェクトを変更しない場合に使用できます。 このオプションは、オブジェクトのコピーには使用できません。
      • --snapshot-path オプションは、アップロードまたはダウンロードされたオブジェクトのローカルの lastModifiedTime を記録し、記録された lastModifiedTime を次回アップロードまたはダウンロードするオブジェクトの lastModifiedTime と比較して、どのオブジェクトをスキップできるか判断します。 このオプションを使用する場合、2 回のアップロードまたはダウンロード中に OSS のオブジェクトが変更されないようにしてください。 2 回のアップロードまたはダウンロード中に OSS のオブジェクトが更新されるシナリオの場合、--update オプションを使用して、オブジェクトの増分アップロードまたはダウンロードを実行します。
      • ossutil は、snapshot-path で指定されたディレクトリからスナップショット情報を自動的に削除しません。 スナップショット情報を保持する必要がない場合、ディレクトリを削除します。
      • スナップショット情報を読み書きするには、追加のオーバーヘッドが必要です。 次のシナリオの場合、このオプションを使用しないことを推奨します。アップロードまたはダウンロードするオブジェクトの数が少ない。 ネットワークが正しく接続されている。 他のユーザーが、これらのオブジェクトに対して操作を実行する必要がある。 この場合、--update オプションを使用して、増分アップロードまたはダウンロードを実行できます。
      • --update オプションと --snapshot-path オプションは一緒に使用できます。ossutil は、最初に --snapshot-path オプションを使用して、オブジェクトのアップロードまたはダウンロードをスキップするかどうかを決定します。 --snapshot-path によってアップロードまたはダウンロードがスキップされない場合、ossutil は --update オプションを使用して、オブジェクトのアップロードまたはダウンロードをスキップするかどうかを決定します。
    • pay-by-requester モードが有効になっているバケットにオブジェクトをアップロードする
      ./ossutil cp dir/test.mp4 oss://payer/ --payer=requester
  • オブジェクトをダウンロードする
    • 単一のオブジェクトをダウンロードする
      ./ossutil cp oss://my-bucket/path/test1.txt /dir
    • オブジェクトの特定の範囲をダウンロードする

      --range オプションを使用して、オブジェクトの特定の範囲をダウンロードできます。

      たとえば、test1.txt オブジェクトの 10〜20 文字目をダウンロードし、ローカルデバイスにファイルとしてダウンロードします。
      ./ossutil cp oss://my-bucket/path/test1.txt /dir  --range=10-20
      Succeed: Total num: 1, size: 11. OK num: 1(download 1 objects).
      0.290769(s) elapsed
    • pay-by-requester モードが有効になっているバケットからオブジェクトをダウンロードする
      ./ossutil cp oss://payer/test.mp4 dir/ --payer=requester
    • フォルダーをダウンロードする
      ./ossutil cp -r oss://my-bucket/path /dir 
    • フォルダーをダウンロードし、--update オプションを指定する
      複数のオブジェクトをダウンロードするときに --update オプションを指定すると、ターゲットに存在しないオブジェクト、または最終変更時刻がターゲットオブジェクトの最終変更時刻より後のオブジェクトのみがダウンロードされます。 コマンドは次のとおりです。
      ./ossutil cp -r oss://bucket/path  /dir  --update                           
      このオプションを使用して、正常にダウンロードされていないオブジェクトに対して増分ダウンロードを実行できます。
    • フォルダーをダウンロードし、スナップショット情報を生成する

      複数のオブジェクトをダウンロードするときに --snapshot-path オプションを指定すると、ダウンロードのスナップショットが取得され、指定したディレクトリにスナップショット情報が保存されます。 オブジェクトの次回アップロード時にこのオプションが指定されていると、ossutil は指定されたディレクトリからスナップショット情報を読み取り、増分アップロードを実行します。 詳細は、--snapshot-path をご参照ください。 コマンドは次のとおりです。

      ./ossutil cp -r oss://bucket1/path dir --snapshot-path=path                                
    • 特定の条件を満たす複数のオブジェクトをダウンロードする
      複数のオブジェクトをダウンロードするとき、--include /--exclude を使用してオブジェクトの選定条件を指定できます。 詳細は、「cp」をご参照ください。
      • 形式が jpg 以外のオブジェクトをダウンロードする
        ./ossutil cp oss://my-bucket/path dir/ --exclude "*.jpg" -r
      • 名前に abc を含み、形式が jpg または txt 以外のすべてのオブジェクトをダウンロードする
        ./ossutil cp oss://my-bucket1/path dir/ --include "*abc*" --exclude "*.jpg" --exclude "*.txt" -r
    • バージョン管理が有効になっているバケットにあるオブジェクトの特定バージョンをダウンロードする
      ./ossutil cp oss://bucket1/test.jpg dir/ --version-id  CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk
      --version-id オプションを使用するには、ls --all-versions コマンドを実行して、オブジェクトのバージョン ID を取得する必要があります。
      --version-id オプションは、バージョン管理が有効になっているバケット内のオブジェクトにのみ使用できます。 バケットのバージョン管理を有効にするコマンドの詳細は、「bucket-versioning」をご参照ください。
  • オブジェクトをコピーする

    オブジェクトのみをコピーできます。 パートはコピーできません。 リージョン間でオブジェクトをコピーすることはできません。

    • 単一のオブジェクトをコピーする
      ./ossutil cp oss://bucket/path1/a oss://bucket/path2/                                 
    • 単一のオブジェクトをコピーし、名前を変更する
      ./ossutil cp oss://bucket/path1/a oss://bucket/path2/b                           
    • 特定の条件を満たす複数のオブジェクトをコピーする
      複数のオブジェクトをコピーするとき、--include/--exclude コマンドを使用してオブジェクトの選択条件を指定できます。 詳細は、「cp」をご参照ください。
      • 形式が jpg 以外のオブジェクトをコピーする
        ./ossutil cp oss://my-bucket1/path oss://my-bucket2/path --exclude "*.jpg" -r
      • 名前に abc を含み、形式が jpg または txt 以外のすべてのオブジェクトをコピーする
        ./ossutil cp oss://my-bucket1/path oss://my-bucket2/path --include "*abc*" --exclude "*.jpg" --exclude "*.txt" -r
    • オブジェクトをコピーし、ストレージクラスを変更する
      • 既存のオブジェクトのストレージクラスをアーカイブに設定する
        ./ossutil cp oss://my-bucket/path/0104_6.jpg oss://my-bucket/path/0104_6.jpg --meta X-oss-Storage-Class:Archive
      • 既存のフォルダー内のすべてのファイルのストレージクラスを標準に設定する
        ./ossutil cp oss://my-bucket/path/ oss://my-bucket/path/ --meta X-oss-Storage-Class:Standard -r
        重要
        • cp コマンドを使用して、オブジェクトのストレージクラスをアーカイブから他のストレージクラスに変更することはできません。 最初に restore コマンドを使用してオブジェクトを読み取り可能な状態に復元し、次に cp コマンドを使用してそのストレージクラスを変更する必要があります。
        • cp コマンドを実行してオブジェクトを上書きした場合、上書きしたと見なされ、料金が発生する場合があります。 IA またはアーカイブストレージクラスのオブジェクトが、作成後 30 日または 60 日以内に上書きされた場合、早期削除料金が発生します。 詳細は、「課金項目」をご参照ください。
    • オブジェクトをコピーし、サーバー側の暗号化方式を指定する
      オブジェクトをコピーするときに、サーバー側の暗号化方式を指定できます。 オブジェクトを暗号化した後、そのオブジェクトをバケットに保存できます。 サーバー側暗号化の詳細は、「サーバー側暗号化」をご参照ください。
      • オブジェクトをコピーし、サーバー側の暗号化方式を AES256 に設定する
        ./ossutil cp oss://bucket/path1/a oss://bucket/path2/ --meta=x-oss-server-side-encryption:AES256
      • オブジェクトをコピーし、サーバー側の暗号化方式を KMS に設定する
        ./ossutil cp oss://bucket/path1/a oss://bucket/path2/ --meta=x-oss-server-side-encryption:KMS

        KMS を使用してオブジェクトを暗号化すると、KMS コンソールにオブジェクトのマスターキーが作成されます。KMS API 操作が呼び出されたときに少額の料金が発生します。

    • 単一のオブジェクトをコピーし、--meta オプションを指定する
      オブジェクトをコピーするとき、--meta オプションを使用して、header:value#header:value... 形式のオブジェクトメタデータを設定できます。
      ./ossutil cp oss://bucket/path1/a oss://bucket/path2/ --meta=Cache-Control:no-cache
    • 同じリージョン内の異なるバケット間で複数のオブジェクトをコピーする
      -r オプションを cp コマンドに追加して、同じリージョン内の異なるバケット間で複数のオブジェクトをコピーできます。
      ./ossutil cp oss://your_src_bucket/path1/ oss://your_dest_bucket/path2/ -r                                   
    • 同じリージョン内の異なるバケット間でオブジェクトの増分コピーを実行する
      複数のオブジェクトをコピーするときに --update オプションを指定すると、ターゲットに存在しないオブジェクト、または最終変更時刻がターゲットオブジェクトの最終変更時刻より後のオブジェクトのみがコピーされます。 コマンドは次のとおりです。
      ./ossutil cp oss://your_src_bucket/path1/ oss://your_dest_bucket/path2/ -r --update
      このオプションを使用して、正常にコピーされていないオブジェクトに対して増分コピーを実行できます。
    • pay-by-requester モードが有効になっているバケットから一般的なバケットにオブジェクトをコピーする
      ./ossutil cp oss://payer/test.mp4 oss://my-bucket/path  --payer=requester
    • 一般的なバケットから、pay-by-requester モードが有効になっているバケットにオブジェクトをコピーする
      ./ossutil cp oss://my-bucket/path/test.mp4 oss://payer --payer=requester
    • バージョン管理が有効になっているバケットにあるオブジェクトの特定バージョンをコピーする
      ./ossutil cp oss://bucket1/test.jpg oss://bucket2/ --version-id  CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk
      --version-id オプションを使用するには、ls --all-versions コマンドを実行して、オブジェクトのバージョン ID を取得する必要があります。
      --version-id オプションは、バージョン管理が有効になっているバケット内のオブジェクトにのみ使用できます。 バケットのバージョン管理を有効にするコマンドの詳細は、「bucket-versioning」をご参照ください。
  • オブジェクトのアップロード、ダウンロード、コピーのパフォーマンスを最適化する
    --jobs オプションと --parallel オプションを cp コマンドに追加して、同時操作数を指定できます。 ossutil で設定されるデフォルトの同時操作数がパフォーマンス要件を満たしていない場合、これら 2 つのオプションの値を変更してパフォーマンスを調整できます。
    • --jobs オプションには、複数のファイルがアップロード、ダウンロード、またはコピーされるときの同時タスク数を指定します。
    • --parallel オプションには、マルチパートのアップロード、ダウンロード、またはコピー時に大きなオブジェクトで実行される同時操作数を指定します。

    デフォルトでは、オブジェクトサイズに基づいて同時操作数が計算されます。 このオプションは、小さいオブジェクトには機能しません。 マルチパートモードでアップロード、ダウンロード、またはコピーする大きなオブジェクトのしきい値は、--bigfile-threshold オプションで指定できます。 複数のオブジェクトをアップロード、ダウンロード、またはコピーするとき、実際の同時操作数はジョブ数に同時操作数を乗算して計算されます。

    警告
    • ECS インスタンスまたはサーバーのリソース (ネットワーク帯域幅、メモリ、CPU など) が制限されている場合、同時操作数を100 未満の値に調整することを推奨します。 ネットワーク、メモリ、CPU などのリソースが完全に占有されていない場合、同時操作数を増やすことができます。
    • 同時操作が多すぎる場合、ossutil のアップロード、ダウンロード、コピーのパフォーマンスが低下するか、スレッド間のリソースの切り替えやスナッチが原因で EOF エラーが発生する可能性があります。 この問題を解決するには、必要に応じて --jobs オプションと --parallel オプションの値を調整する必要があります。 負荷テストを実行するには、最初に 2 つのオプションを小さな値に設定し、徐々に最適な値に調整します。

一般的なオプション

次の表に、cp コマンドに追加できるオプションを示します。
オプション 説明
-r、--recursive バケット内のオブジェクトに対して操作を再帰的に実行します。 このオプションが指定されている場合、このオプションをサポートするコマンドは、指定された条件を満たすバケット内のすべてのオブジェクトに対して操作を実行します。 このオプションが指定されていない場合、コマンドは指定された 1 つのオブジェクトに対してのみ操作を実行します。
-f、--force ユーザーに確認を求めずに操作を強制します。
-u、--update ターゲットに存在しないオブジェクト、または最終変更時刻がターゲットオブジェクトの最終変更時刻より後のオブジェクトのみがアップロード、ダウンロード、またはコピーされます。
--output-dir 出力オブジェクトが存在するディレクトリを指定します。 出力オブジェクトには、レポートオブジェクトが含まれます。レポートオブジェクトは、cp コマンドで複数のオブジェクトをコピーするときに発生したエラーが原因で生成されます。 デフォルト値は、現在のディレクトリの ossutil_output ディレクトリです。
--bigfile-threshold 再開可能なデータ転送を開始するオブジェクトサイズを指定します。 単位:バイト。 有効値:負でない整数。 デフォルト値:100 MB。
--part-size 大きなオブジェクトをマルチパートアップロード、ダウンロード、またはコピーするときの各パートのサイズを指定します。 単位:バイト。デフォルトでは、オブジェクトサイズに基づいて適切なパートサイズが計算されます。 パフォーマンスを最適化する必要がある場合、または特別な制約の下で動作している場合、このオプションを任意の正の整数に設定できます。
--checkpoint-dir チェックポイントディレクトリを指定します。 デフォルト値:.ossutil_checkpoint。 再開可能なデータ転送が失敗すると、自動的にディレクトリが作成され、そのディレクトリにチェックポイント情報が記録されます。 再開可能な転送が成功すると、このディレクトリは削除されます。 このオプションを指定する場合、指定されたディレクトリが削除可能なことを確認してください。
--range ダウンロードするオブジェクトの範囲を指定します。 このオプション値は、3-9、3-、または -9 の形式でなければなりません。
--encoding-type オブジェクト名のエンコードタイプを指定します。 このオプションを指定する場合、値は url でなければなりません。 このオプションが指定されていない場合、オブジェクト名はエンコードされません。 バケット名は URL エンコードできません。
--include *.jpg など、特定の文字列に一致するオブジェクトを含めます。
--exclude *.txt など、特定の文字列に一致するオブジェクトを除外します。
--meta オブジェクトのメタデータを [header:value#header:value...] の形式で設定します。 例:Cache-Control:no-cache#Content-Encoding:gzip。詳細は、「set-meta」をご参照ください。
--acl オブジェクトの ACL を設定します。 デフォルト値:default。 有効値:
  • default:オブジェクトは、所属するバケットの ACL を継承します。
  • private
  • public-read
  • public-read-write
--snapshot-path 複数のオブジェクトをアップロードまたはダウンロードするときに --snapshot-path オプションを指定すると、アップロードまたはダウンロードのスナップショットが取得され、指定したディレクトリにスナップショット情報が保存されます。 オブジェクトの次回アップロードまたはダウンロード時にこのオプションが指定されていると、ossutil は指定されたディレクトリからスナップショット情報を読み取り、増分アップロードまたはダウンロードを実行します。
重要
  • --snapshot-path オプションは、オブジェクトの増分アップロードまたはダウンロードを加速するシナリオで使用されます。 このオプションは、オブジェクトの数が多く、2 回のアップロード中に他のユーザーが OSS のオブジェクトを変更しない場合に使用できます。 このオプションは、オブジェクトのコピーには使用できません。
  • --snapshot-path オプションは、アップロードまたはダウンロードされたオブジェクトのローカルの lastModifiedTime を記録し、記録された lastModifiedTime を次回アップロードまたはダウンロードするオブジェクトの lastModifiedTime と比較して、どのオブジェクトをスキップできるか判断します。 このオプションを使用する場合、2 回のアップロードまたはダウンロード中に OSS のオブジェクトが変更されないようにしてください。 2 回のアップロードまたはダウンロード中に OSS のオブジェクトが更新されるシナリオの場合、--update オプションを使用して、オブジェクトの増分アップロードまたはダウンロードを実行します。
  • ossutil は、snapshot-path で指定されたディレクトリからスナップショット情報を自動的に削除しません。 スナップショット情報を保持する必要がない場合、ディレクトリを削除します。
  • スナップショット情報を読み書きするには、追加のオーバーヘッドが必要です。 次のシナリオの場合、このオプションを使用しないことを推奨します。アップロードまたはダウンロードするオブジェクトの数が少ない。 ネットワークが正しく接続されている。 他のユーザーが、これらのオブジェクトに対して操作を実行する必要がある。 この場合、--update オプションを使用して、増分アップロードまたはダウンロードを実行できます。
  • --update オプションと --snapshot-path オプションは一緒に使用できます。ossutil は、最初に --snapshot-path オプションを使用して、オブジェクトのアップロードまたはダウンロードをスキップするかどうかを決定します。 --snapshot-path によってアップロードまたはダウンロードがスキップされない場合、ossutil は --update オプションを使用して、オブジェクトのアップロードまたはダウンロードをスキップするかどうかを決定します。
--disable-crc64 CRC64 を無効にします。デフォルトでは、データ送信時に CRC64 は有効化されています。
--maxupspeed 最大アップロード速度 (KB/s) を指定します。デフォルト値は 0 です。これは、最大アップロード速度を指定しないことを示します。
--payer リクエストの支払者を指定します。 pay-by-requester モードを有効にするには、このオプションを requester に設定します。
--partition-download オブジェクトパーティションのダウンロードに使用されます。 このオプションの値は、"partition number:total number of partitions" の形式です。 1:5 という値は、合計 5 つのパーティションの中からパーティション 1 がダウンロードされることを示します。 オブジェクトのパーティションルールは、ossutil によって決定されます。 このオプションは、ダウンロードするオブジェクトを、複数の ossutil コマンドでダウンロード可能な複数のパーティションに分割します。 各 ossutil コマンドは、独自のパーティションをダウンロードします。 異なる ECS インスタンスで複数の ossutil コマンドを並行して実行できます。
-j、--jobs 複数のオブジェクトで実行される同時操作数を指定します。 有効値:1~10000。 デフォルト値:3。
--parallel 単一のオブジェクトで実行される同時操作数を指定します。 有効値:1〜10000。このオプションのデフォルトの値は、操作タイプとオブジェクトサイズに基づいて決定されます。
--loglevel ログレベルを指定します。 デフォルト値は null で、ログファイルが生成されないことを示します。 有効値:
  • info:プロンプトログを生成します。
  • debug:対応する HTTP リクエストとレスポンス情報を含む詳細なログを生成します。
--retry-times 操作が失敗した場合に操作を再試行する回数を指定します。 有効値:1~500。 デフォルト値:10。
--version-id ダウンロードまたはコピーするオブジェクトのバージョン ID を指定します。 オブジェクトの存在するバケットは、バージョン管理が有効になっている必要があります。
--proxy-host プロキシサーバーの URL を指定します。 HTTP、HTTPS、SOCKS5 がサポートされています。 URL の例:http://120.79. **.**:3128、socks5://120.79. **. **:1080 など。
--proxy-user プロキシサーバーのユーザー名を指定します。 デフォルト値は null です。
--proxy-pwd プロキシサーバーのパスワードを指定します。 デフォルト値は null です。
一般的なオプションの詳細は、「サポートされているすべてのオプションの表示」をご参照ください。