Object Storage Service:CopyObject

バージョン管理

既定では、CopyObjectリクエストのx-oss-copy-sourceヘッダーは、オブジェクトの現在のバージョンがコピーされることを指定します。 x-oss-copy-sourceにversionIdを追加して、指定したバージョンのオブジェクトをコピーできます。 コピーするオブジェクトの指定されたバージョンが削除マーカーである場合、object Storage Service (OSS) はオブジェクトが存在しないことを示す404 Not Foundを返します。

以前のバージョンのオブジェクトを現在のバージョンに復元するには、オブジェクトが格納されているバケットに以前のバージョンのオブジェクトをコピーします。 その後、OSSはオブジェクトの以前のバージョンを現在のバージョンとして保存します。

宛先バケットのバージョン管理が有効になっている場合、OSSは宛先オブジェクトの一意のバージョンIDを自動的に生成します。 バージョンIDは、応答内のx-oss-version-idの値です。 宛先バケットのバージョン管理が有効または一時停止されていない場合、OSSは宛先オブジェクトのIDがnullのバージョンを生成し、IDがnullの既存のバージョンを上書きします。

制限事項

• CopyObject操作を呼び出すと、オブジェクトサイズの次の制限が適用されます。

  • ソースバケットが宛先バケットでもあり、ストレージクラス変換がCopyObject操作に含まれていない場合、コピーするオブジェクトは5 GBを超えることがあります。

  • ソースバケットが宛先バケットではなく、ストレージクラス変換がCopyObject操作に含まれていない場合、コピーするオブジェクトは5 GBを超えることはできません。

  • ストレージクラス変換がCopyObject操作に含まれる場合、コピーするオブジェクトは5 GBを超えることはできません。 コピーするオブジェクトが1 GBを超える場合は、UploadPartCopy操作を呼び出す必要があります。

• 読み取り権限が必要です。

  CopyObjectまたはUploadPartCopy操作を呼び出すには、コピーするオブジェクトに対する読み取り権限が必要です。

• CopyObject操作を呼び出して、バージョン化されていないバケット内のオブジェクトをコピーする場合、次の制限が適用されます。

  ソースオブジェクトと宛先オブジェクトは同じです。

  • コピー操作にソースオブジェクトの暗号化メソッドまたはストレージクラスの変更が含まれない場合、OSSはソースオブジェクトのメタデータのみを変更し、オブジェクトのコンテンツはコピーしません。

  • コピー操作にソースオブジェクトの暗号化メソッドまたはストレージクラスの変更が含まれる場合、OSSはソースオブジェクトのメタデータを変更し、オブジェクトのコンテンツをコピーします。

• CopyObject操作を呼び出してバージョン管理されたバケット内のオブジェクトをコピーする場合、次の制限が適用されます。

  • CopyObject操作を呼び出して追加可能なオブジェクトをコピーすることはできません。

  • CopyObject操作を呼び出して、追加可能オブジェクトのサーバー側暗号化メソッドを変更することはできません。

• CopyObject操作を呼び出してシンボリックリンクをコピーする場合、次の制限が適用されます。

  シンボリックリンクのみがコピーされます。 シンボリックリンクが指すオブジェクトはコピーされません。

• 階層的な名前空間機能が有効になっているバケット内のオブジェクトをコピーするCopyObject操作を呼び出す場合、次の制限が適用されます。

  バケット内のディレクトリはコピーできません。

課金ルール

• CopyObject操作を呼び出すたびに、宛先バケットへのPUTリクエストに対して課金されます。

• CopyObject操作を呼び出すと、宛先バケットのストレージ使用量が増加します。

• CopyObject操作がオブジェクトを上書きしてオブジェクトのストレージクラスを変更する場合にも課金されます。 たとえば、IAオブジェクトが作成されてから10日以内にIAオブジェクトを上書きして低頻度アクセス (IA) オブジェクトを標準オブジェクトに変換するCopyObject操作を呼び出した場合、最小保存期間である10日以内に保存されたIAオブジェクトのストレージ使用量に対して課金されます。 ストレージ料金の詳細については、「ストレージ料金」をご参照ください。

リクエスト構文

PUT /DestObjectName HTTP/1.1
ホスト: DestBucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue
x-oss-copy-source: /SourceBucketName/SourceObjectName 

リクエストヘッダー

CopyObjectリクエストのすべてのヘッダーはx-oss- で始まります。 これらのヘッダーは署名文字列に追加する必要があります。 次の表に、ヘッダーを示します。

CopyObjectリクエストに含まれる一般的なリクエストヘッダー (ホストや日付など) の詳細については、「一般的なリクエストヘッダー」をご参照ください。

レスポンスヘッダー

CopyObject要求に対する応答は、共通の応答ヘッダのみを含む。 詳細については、「共通レスポンスヘッダー」をご参照ください。

レスポンス要素

例

• バージョン化されていないバケット内のオブジェクトのコピー

  リクエストの例

  PUT /test%2FAK.txt HTTP/1.1
  ホスト: tesx.oss-cn-zhangjiakou.aliyuncs.com
  Accept-Encoding: ID
  ユーザーエージェント: aliyun-sdk-python/2.6.0(Windows/7/AMD64;3.7.0)
  受け入れる: text/html
  接続: キープアライブ
  x-oss-copy-source: /test/AK.txt
  日付: 12月28日金曜日2018 09:41:55 GMT
  承認: OSS qn6qrrqxo2oawuk53otfjbyc:gmnwPKuu20LQEjd + iPkL259A ****
  コンテンツ長: 0 

  レスポンスの例

  x-oss-hash-crc64ecmaは、オブジェクトの64ビットCRC値を示します。 この値は、ECMA-182基準に基づいて計算されます。 CopyObject操作によって生成されたオブジェクトは、この値を持たない可能性があります。

  HTTP/1.1 200 OK
  サーバー: AliyunOSS
  日付: 12月28日金曜日2018: 09:41:56 GMT
  Content-Type: application/xml
  コンテンツ-長さ: 184
  接続: キープアライブ
  x-oss-request-id: 5C25EFE4462CE00EC6D87156
  ETag: "F2064A169EE92E9775EE5324D0B1 ****"
  x-oss-hash-crc64ecma: 12753002859196105360
  x-oss-server-time: 150
  <?xml version="1.0" encoding="UTF-8"?>
  <CopyObjectResult>
    <ETag>"F2064A169EE92E9775EE5324D0B1****"</ETag>
    <LastModified>2018-12-28T09:41:56.000Z</LastModified>
  </CopyObjectResult> 

• バージョンIDを指定せずにバージョン管理されたバケット内のオブジェクトをコピーする

  リクエストの例

  PUT /dest-object-例HTTP/1.1
  ホスト: versioning-copy.oss-cn-hangzhou.aliyuncs.com
  日付: 4月2019日火曜日03:45:32 GMT
  権限付与: OSS qeyxjc9arppwa0t:QqwOjq7U7j04NVpPqdfcVk0I ****
  x-oss-copy-source: /versioning-copy-source/source-object 

  レスポンスの例

  応答のx-oss-copy-source-version-idは、ソースオブジェクトのバージョンIDを示します。 この例では、バージョンIDはソースオブジェクトの現在のバージョンです。 x-oss-version-idは、ターゲットオブジェクトのバージョンIDを示します。

  HTTP/1.1 200 OK
  x-oss-copy-source-version-id: CAEQNRiBgIC28uaA0BYiIDY5OGIwNmNlNjYyMTRjNTc4N2M2OGNiMjZkZTQ2 ****
  x-oss-version-id: CAEQNxiBgIDG8uaA0BYiIGZhZDRkZTk5Zjg3YzRhNzdiMWEwZGViNDM1NTFh ****
  x-oss-request-id: 5CAC155CB7AEADE01700 ****
  Content-Type: application/xml
  コンテンツ-長さ: 184
  接続: キープアライブ
  日付: 4月2019日火曜日03:45:32 GMT
  サーバー: AliyunOSS
  <?xml version="1.0" encoding="UTF-8"?>
  <CopyObjectResult>
    <ETag>"C81E728D9D4C2F636F067F89CC14****"</ETag>
    <LastModified>2019-04-09T03:45:32.000Z</LastModified>
  </CopyObjectResult> 

• バージョンIDを指定してバージョン管理されたバケット内のオブジェクトをコピーする

  リクエストの例

  PUT /dest-object-例HTTP/1.1
  ホスト: versioning-copy.oss-cn-hangzhou.aliyuncs.com
  日付: 4月2019日火曜日03:45:32 GMT
  権限付与: OSS qeyxjc9arppwa0t:5qG4DLaHjxDPtpLlf2e8fBfX ****
  x-oss-copy-source: /versioning-copy-source/source-object?versionId=CAEQNRiBgICv8uaA0BYiIDliZDc3MTc1NjE5MjRkMDI4ZGU4MTZkYjY1ZDgy **** 

  レスポンスの例

  応答のx-oss-copy-source-version-idは、ソースオブジェクトのバージョンIDを示します。 この例では、ソースオブジェクトのバージョンIDは、x-oss-copy-sourceのversionIdで指定します。 x-oss-version-idは、ターゲットオブジェクトのバージョンIDを示します。

  HTTP/1.1 200 OK
  x-oss-copy-source-version-id: CAEQNRiBgICv8uaA0BYiIDliZDc3MTc1NjE5MjRkMDI4ZGU4MTZkYjY1ZDgy ****
  x-oss-version-id: CAEQNxiBgMDP8uaA0BYiIDIyNGNhZDQ1M2M3NzRkZThiNzE0N2I3ZDkxOWY4 ****
  x-oss-request-id: 5CAC155CB7AEADE01700 ****
  Content-Type: application/xml
  コンテンツ-長さ: 184
  接続: キープアライブ
  日付: 4月2019日火曜日03:45:32 GMT
  サーバー: AliyunOSS
  <?xml version="1.0" encoding="UTF-8"?>
  <CopyObjectResult>
    <ETag>"C4CA4238A0B923820DCC509A6F75****"</ETag>
    <LastModified>2019-04-09T03:45:32.000Z</LastModified>
  </CopyObjectResult> 

OS SDK

次のプログラミング言語のOSS SDKを使用して、CopyObject操作を呼び出すことができます。

• Java

• Python

• PHP

• 行く

• C

• . NET

• アンドロイド

• iOS

• Node.js

• ルビー

エラーコード

よくある質問

CopyObject操作を呼び出して、一度に複数のオブジェクトをコピーできますか?

いいえ。CopyObject操作を呼び出して、一度に複数のオブジェクトをコピーすることはできません。 CopyObject操作は、一度に1つのオブジェクトをコピーするために使用される。 一度に複数のオブジェクトをコピーする場合は、ossutilを使用できます。 詳細については、「オブジェクトのコピー」をご参照ください。