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+8) から 2023 年 10 月 31 日 12:55:58 (UTC+8) の間に最終更新された 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

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

• 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 共通オプションを使用して、別の Alibaba Cloud アカウントに属する中国 (上海) リージョンのソースバケット 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 ロールを引き受ける権限を付与して、より安全なクロスアカウントアクセスを実現することを推奨します。