Object Storage Service:オブジェクトのコピー

使用上の注意

• このトピックのサンプルコマンドラインは、64ビットLinuxシステムに基づいています。 他のシステムの場合は、を交換します。対応するバイナリ名を持つコマンドの /ossutil64。 詳細は、「ossutilコマンドリファレンス」をご参照ください。

• cpコマンドを実行して、別のAlibaba Cloudアカウントに属するバケット、または別のリージョンにあるバケットにオブジェクトをコピーすることはできません。 別のAlibaba Cloudアカウントに属するバケットまたは別のリージョンにあるバケットにオブジェクトをコピーする場合は、ossimportまたはData Online Migrationを使用します。

• cpコマンドを使用してオブジェクトをコピーできますが、パーツはコピーできません。

• 追加可能なオブジェクトはコピーできません。

• ソースオブジェクトに対する読み取り権限と、宛先バケットに対する読み取りおよび書き込み権限が必要です。 それ以外の場合、コピー操作は失敗します。 オブジェクトをコピーする方法の詳細については、「オブジェクトのコピー」をご参照ください。

コマンド構文

. /ossutil64 cp cloud_url cloud_url
[-r, -- recursive]
[-f -- force]
[-u -- 更新]
[-- disable-無視-エラー]
[-- only-current-dir]
[-- bigfile-threshold <value>]
[-- part-size <value>]
[-- checkpoint-dir <value>]
[-- encoding-type <value>]
[-- include <value>]
[-- exclude <value>]
[-- meta <value>]
[-- acl <value>]
[-- disable-crc64]
[-- payer <value>]
[-j, -- job <value>]
[-- parallel <value>]
[-- version-id <value>]
[-- start-time <value>]
[-- end-time <value>] 

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

デフォルトの同時実行値がパフォーマンス要件を満たさない場合は、-j、-- jobs、-- parallelオプションを使用してパフォーマンスを調整できます。 デフォルトでは、ossutilはオブジェクトサイズに基づいて -- parallelの値を計算します。 複数のラージオブジェクトをコピーする場合、同時実行タスクの実際の数は、-j, -- jobsの値に -- parallelの値を掛けて計算されます。

• Elastic Compute Service (ECS) インスタンスまたはサーバーのネットワーク帯域幅、メモリ、CPUなどのリソースが制限されている場合は、同時タスクの数を100未満の値に調整することを推奨します。 ネットワーク帯域幅、メモリ、CPUなどのリソースがアイドル状態のままである場合、同時実行タスクの数を増やすことができます。

• 同時実行タスクの数が多すぎると、スレッドがリソースを切り替えて競合するため、ossutilのコピー操作のパフォーマンスが低下する可能性があります。 さらに、EOF (end-of-file) エラーが発生することがある。 これらの問題を防ぐために、使用可能なリソースに基づいて -j、-- jobs、-- parallelの値を調整できます。 ストレステストを実行するには、最初にオプションに小さな値を指定し、値を徐々に増やして最適な値を見つけることをお勧めします。

サンプル環境

このトピックでは、オブジェクトはLinuxの異なるディレクトリまたはバケット間でコピーされます。 実際のビジネスシナリオでコマンドを使用するには、オペレーティングシステムと環境に基づいてサンプルコマンドのオプションとパラメーターの設定を変更する必要があります。 サンプル環境:

• オペレーティングシステム: Linux

• ソースバケット: examplebucket1

• ソースバケットのディレクトリ1: srcfolder1

• ソースバケットのディレクトリ2: srcfolder2

• 宛先バケット: examplebucket2

• 宛先バケットのディレクトリ: desfolder

ソースディレクトリをコピーするかどうかを指定する

ソースパスがスラッシュ (/) で終わっていない場合、ソースバケット内の指定されたプレフィックスを名前に含むすべてのオブジェクトが宛先バケットにコピーされます。 ソースパスがスラッシュ (/) で終わる場合、指定されたディレクトリ内のオブジェクトのみが宛先バケットにコピーされます。

たとえば、次のオブジェクトは、examplebucket1という名前のソースバケットのsrcfolder1ディレクトリに格納されます。

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

• スラッシュ (/) で終わらないパスからオブジェクトをコピーする

  . /ossutil64 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 

• スラッシュ (/) で終わるパスからオブジェクトをコピーする

  . /ossutil64 cp oss:// examplebucket1/srcfolder1/ oss:// examplebucket2 -r

  次のオブジェクトは、ソースバケットからexamplebucket2という名前の宛先バケットにコピーされます。

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

簡単なコピーを実行する

• 単一のオブジェクトをコピーする

  . /ossutil64 cp oss:// examplebucket1/examplefile.txt oss:// examplebucket1/srcfolder2/

• 増分オブジェクトのコピー

  複数のオブジェクトをコピーするときに -- updateオプションを指定した場合、ossutilは、宛先オブジェクトが存在しない場合、またはソースオブジェクトの最終変更時刻が宛先オブジェクトの最終変更時刻よりも遅い場合にのみ、オブジェクトをコピーします。 次のコマンドを実行して、増分オブジェクトをコピーできます。

  . /ossutil64 cp oss:// examplebucket1/srcfolder1/ oss:// examplebucket2/path2/ -r -- update

  このオプションを使用すると、コピーしたオブジェクトをスキップし、コピーに失敗したオブジェクトのみをコピーできます。

• 一度に複数のオブジェクトをコピーする

  次のコマンドを実行して、最終変更時刻が10月31日10:09:18 (UCT + 8) から2023月31日12:55:58 (UTC + 8) の範囲内であるsrcfolder1ディレクトリ内のオブジェクトを2023コピーします。

  . /ossutil64 cp -r oss:// examplebucket1/srcfolder1/ oss:// examplebucket2/path2/ -- 開始時間1698718158 -- 終了時間1698728158

• オブジェクトの名前変更

  . /ossutil64 cp oss:// examplebucket1/examplefile.txt oss:// examplebucket1/example.txt

  cpコマンドを実行してオブジェクトの名前を変更すると、元のオブジェクトは引き続き存在します。 オブジェクトの名前を変更した後、元のオブジェクトを削除できます。

• 現在のディレクトリ内のオブジェクトのみをコピーし、サブディレクトリを無視する

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

• オブジェクトのメタデータの変更

  オブジェクトをコピーするときは、-- metaオプションを使用してオブジェクトのメタデータを変更できます。 このオプションの値は、header:value#header:value... 形式です。

  . /ossutil64 cp oss:// examplebucket1/examplefile.txt oss:// examplebucket1/ -- meta=Cache-コントロール: no-cache

• pay-by-requesterが有効になっているバケットからpay-by-requesterが無効になっているバケットにオブジェクトをコピーします。

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

特定の条件を満たす複数のオブジェクトをコピーする

オブジェクトのストレージクラスの変更

• スタンダード: スタンダード

• IA: まれなアクセス (IA)

• アーカイブ: Archive

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

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

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

オブジェクトのタグの変更

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

オブジェクトタグ付けの詳細については、「オブジェクトタグ付け (オブジェクトタグの追加、変更、クエリ、および削除) 」をご参照ください。

オブジェクトのコピーと暗号化

バージョン管理が有効なバケット内のオブジェクトを復元する

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

一般的なオプション

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

. /ossutil64 cp oss:// examplebucket/srcobject.png oss:// destbucket -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA **** -k 67DLVBkH7EamOjy2W5RVAHUY9H ****

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