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

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

srcfolder1 内で、最終更新日時が 2023 年 10 月 31 日 10:09:18 (UTC+8) から 2023 年 10 月 31 日 12:55:58 (UTC+8) までのファイルのみをコピーします。

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

ファイルのコピーとストレージクラスの変更

• Standard：標準

• IA：低頻度アクセス

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

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

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

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

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

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

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

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

ossutil api copy-object --server-side-encryption SM4

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

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

クロスアカウントコピー

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

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

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