Object Storage Service:cp コマンドを使用したオブジェクトのコピー

デフォルトの同時実行性がパフォーマンス要件を満たさない場合は、-j, --jobs および --parallel オプションを調整してパフォーマンスを調整できます。デフォルトでは、ossutil はファイルサイズに基づいて `parallel` の値を計算します。大きなファイルを一括で転送する場合、実際の同時実行性は `jobs` の値 × `parallel` の値になります。

• コマンドを実行する ECS インスタンスまたはサーバーのネットワーク、メモリ、CPU などのリソースが限られている場合は、同時実行性を 100 未満の値に下げることをお勧めします。リソースが完全に使用されていない場合は、必要に応じて同時実行性を上げることができます。

• 高い同時実行性は、スレッドの切り替えオーバーヘッドやリソースの競合により、パフォーマンスを低下させたり、EOF エラーを引き起こしたりする可能性があります。マシンの実際のリソースに基づいて -j, --jobs および --parallel オプションを調整してください。ストレステストを実行する場合は、低い同時実行性から始めて徐々に上げていき、最適な値を見つけることをお勧めします。

単一ファイルのコピー

同じバケット内のあるディレクトリから別のディレクトリにファイルをコピーし、ファイル名を example.txt に変更します。

ossutil cp oss://examplebucket1/srcfolder1/examplefile.txt oss://examplebucket1/srcfolder2/example.txt                             

複数のファイルを一括でコピーする

ファイルをコピーするとき、ソースパスがスラッシュ (/) で終わらない場合、指定されたプレフィックスに一致するすべてのファイルが宛先バケットにコピーされます。ソースパスがスラッシュ (/) で終わる場合、指定されたディレクトリ内のファイルのみが宛先バケットにコピーされます。

ソースバケット `examplebucket1` の `srcfolder1` ディレクトリに次のファイルが含まれているとします:

srcfolder1/exampleobject1.txt
srcfolder1/exampleobject2.png
srcfolder1/dir1/
srcfolder1/dir1/exampleobject3.jpg
srcfolder1/dir2/
srcfolder1/dir2/exampleobject4.jpg

• ソースパスがスラッシュ (/) で終わらない

  ossutil cp oss://examplebucket1/srcfolder1  oss://examplebucket2 -r

  コピーが完了すると、次のファイルが宛先バケット `examplebucket2` に追加されます:

  srcfolder1/exampleobject1.txt
  srcfolder1/exampleobject2.png
  srcfolder1/dir1/
  srcfolder1/dir1/exampleobject3.jpg
  srcfolder1/dir2/
  srcfolder1/dir2/exampleobject4.jpg

• ソースパスがスラッシュ (/) で終わる

  ossutil cp oss://examplebucket1/srcfolder1/  oss://examplebucket2 -r

  コピーが完了すると、次のファイルが宛先バケット `examplebucket2` に存在します:

  exampleobject1.txt
  exampleobject2.png
  dir1/
  dir1/exampleobject3.jpg
  dir2/
  dir2/exampleobject4.jpg

• 増分ファイルのコピー

  一括コピー中に --update オプションを指定すると、ossutil は宛先オブジェクトが存在しない場合、またはソースオブジェクトの最終更新日時が宛先オブジェクトの最終更新日時より新しい場合にのみオブジェクトをコピーします。コマンドは次のとおりです:

  ossutil cp oss://examplebucket1/srcfolder1/ oss://examplebucket2/path2/ -r --update

  このオプションを使用して、失敗したバッチコピーをリトライする際に、すでに正常にコピーされたファイルをスキップすることで、増分コピーを実行できます。

• 現在のディレクトリ内のファイルのみをコピーし、サブディレクトリを無視する

  ossutil cp oss://examplebucket1/srcfolder1/ oss://examplebucket1/srcfolder2/ --only-current-dir -r

指定された時間範囲内のファイルのコピー

2023 年 10 月 31 日 10:09:18 (UTC+08:00) から 2023 年 10 月 31 日 12:55:58 (UTC+08:00) の間に最終更新された `srcfolder1` 内のファイルのみをコピーします。

ossutil cp -r oss://examplebucket1/srcfolder1/ oss://examplebucket2/path2/ --start-time 1698718158 --end-time 1698728158

指定された条件を満たすファイルのコピー

ファイルのコピーとメタデータの変更

--meta オプションを使用して、オブジェクトのメタデータを変更します。フォーマットは header:value#header:value... です。

ossutil cp oss://examplebucket1/examplefile.txt oss://examplebucket1/ --meta=Cache-Control:no-cache

ファイルのコピーとリクエスト元支払いモードの指定

ソースバケットから宛先バケットにファイルをコピーし、リクエスト元支払いモードを指定します。ossutil cp oss://examplebucket1/examplefile.txt oss://examplebucket2/desfolder/ --payer=requester

ossutil cp oss://examplebucket1/examplefile.txt oss://examplebucket2/desfolder/  --payer=requester

ファイルのコピーとストレージタイプの変更

• Standard: 標準ストレージ

• IA: 低頻度アクセス

• Archive: アーカイブストレージ

• ColdArchive: コールドアーカイブ

• DeepColdArchive: ディープコールドアーカイブ

ストレージタイプの詳細については、「ストレージタイプ」をご参照ください。

ファイルのコピーとタグの設定

ossutil cp oss://examplebucket1/examplefile.txt oss://examplebucket1/ --tagging "abc=1&bcd=2&……"

オブジェクトタグ付けの詳細については、「object-tagging (オブジェクトタグ付け)」をご参照ください。

ファイルのコピーとサーバー側暗号化の設定

ファイルの履歴バージョンの復元

ossutil cp oss://examplebucket1/examplefile.txt oss://examplebucket2/ --version-id  CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk

クロスアカウントコピー

-e、-i、および -k 共通オプションを使用して、別のアカウントに属する中国 (上海) リージョンのソースバケット `examplebucket` のルートディレクトリから `srcobject.png` ファイルを宛先バケット `destbucket` にコピーします。

ossutil cp oss://examplebucket/srcobject.png  oss://destbucket  -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

セキュリティのヒント: コマンドラインで AccessKey を使用すると、セキュリティリスクが生じます。自動化されたタスクや長期的なタスクの場合は、ソースアカウントの RAM ロールを作成し、宛先アカウントに RAM ロールを偽装する権限を付与して、より安全なクロスアカウントアクセスを行うことをお勧めします。