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

使用上の注意

• オブジェクトをコピーするには、oss:GetObject、oss:ListObjects、およびoss:PutObject権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

• ossutil 1.6.16以降の場合、コマンドラインでossutilをバイナリ名として直接使用できます。 オペレーティングシステムに基づいてバイナリ名を更新する必要はありません。 1.6.16より前のossutilの場合、オペレーティングシステムに基づいてバイナリ名を更新する必要があります。 詳細は、「ossutilコマンドリファレンス」をご参照ください。

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

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

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

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

コマンド構文

ossutil cp cloud_url cloud_url
[-r, --recursive]
[-f --force]
[-u --update]
[--disable-ignore-error]
[--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の値を調整できます。 ストレステストを実行するには、2つのオプションに小さな値を指定してから、最適な値に増分します。

サンプル環境

このトピックの例では、同じバケット内の異なるディレクトリ間および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

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

  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

簡単なコピーを実行する

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

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

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

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

  ossutil 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コピーします。

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

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

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

  cpコマンドを実行してオブジェクトの名前を変更すると、元のオブジェクトが保持されます。 オブジェクトの名前を変更した後、元のオブジェクトを削除できます。

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

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

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

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

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

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

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

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

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

• 標準

• IA

• アーカイブ

• ColdArchive

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

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

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

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

一般的なオプション

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

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

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