Object Storage Service:CopyObject

バージョン管理

デフォルトでは、x-oss-copy-source はオブジェクトの現在のバージョンをコピーします。特定のバージョンをコピーするには、バージョン ID を x-oss-copy-source に追加します。指定されたソースオブジェクトのバージョンが削除マーカーである場合、Object Storage Service (OSS) は 404 エラーを返します。

以前のバージョンのオブジェクトを現在のバージョンとして復元するには、以前のバージョンを同じバケットにコピーします。OSS はコピーされたバージョンを現在のバージョンとして設定します。

コピー先バケットでバージョン管理が有効になっている場合、OSS はコピーされたオブジェクトに一意のバージョン ID を生成します。この ID は x-oss-version-id レスポンスヘッダーで返されます。コピー先バケットでバージョン管理が無効または一時停止されている場合、OSS はコピーされたオブジェクトに対して null のバージョン ID を持つバージョンを生成します。この新しいバージョンは、null のバージョン ID を持つ既存のバージョンを上書きします。

制限事項

• オブジェクトサイズの制限

  • ソースバケットとコピー先バケットが同じで、コピー操作中にオブジェクトの暗号化方式やストレージクラスを変更しない場合、オブジェクトサイズは 5 GB を超えることができます。

  • ソースバケットとコピー先バケットが異なり、コピー操作中にオブジェクトの暗号化方式やストレージクラスを変更しない場合、オブジェクトサイズは 5 GB を超えることはできません。

  • コピー操作中にオブジェクトの暗号化方式やストレージクラスを変更する場合、オブジェクトサイズは 1 GB を超えることはできません。オブジェクトが 1 GB より大きい場合は、UploadPartCopy 操作を使用してください。

• 権限

  CopyObject と UploadPartCopy の両方の操作には、ソースオブジェクトに対する読み取り権限が必要です。

• バージョン管理が無効になっているバケットで CopyObject を使用し、ソースオブジェクトとコピー先オブジェクトが同じ場合：

  • ソースオブジェクトの暗号化方式またはストレージクラスが変更されない場合、OSS はソースオブジェクトのメタデータのみを変更し、その内容はコピーしません。

  • ソースオブジェクトの暗号化方式またはストレージクラスが変更された場合、OSS はメタデータを変更し、ソースオブジェクトの内容をコピーします。

• ソースオブジェクトがシンボリックリンクの場合

  シンボリックリンクに対して CopyObject 操作を使用する場合、リンクが指すファイルではなく、リンク自体のみがコピーされます。

• バケットで階層型名前空間が有効になっている場合

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

権限

デフォルトでは、Alibaba Cloud アカウントは完全な権限を持っています。Alibaba Cloud アカウント配下の RAM ユーザーまたは RAM ロールは、デフォルトではいかなる権限も持っていません。Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたはバケットポリシーを通じて操作権限を付与する必要があります。

課金

• CopyObject 操作の各呼び出しは、コピー先バケットへの 1 回の Put リクエストとして課金されます。

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

• CopyObject を使用してオブジェクトのストレージクラスを変更すると、データは上書きされます。たとえば、作成から 10 日後に低頻度アクセス (IA) オブジェクトのストレージクラスを標準に変更した場合でも、IA オブジェクトの最低ストレージ期間の残り 20 日分が課金されます。詳細については、「ストレージ料金」をご参照ください。

• CopyObject 操作を呼び出す際、ソースオブジェクトが IA オブジェクトである場合、データ取得料金が発生します。ソースオブジェクトが RestoreObject 操作を使用して復元されていないアーカイブオブジェクトである場合、バケットでこの機能が有効になっていれば、アーカイブオブジェクトのリアルタイムアクセスのためのデータ取得料金が発生します。これらの料金は、ソースバケットを所有するアカウントに請求されます。詳細については、「データ処理料金」をご参照ください。

リクエスト構文

PUT /DestObjectName HTTP/1.1
Host: DestBucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
x-oss-copy-source: /SourceBucketName/SourceObjectName

リクエストヘッダー

コピー操作のすべてのリクエストヘッダーは x-oss- で始まります。したがって、これらのリクエストヘッダーはすべて署名文字列に含める必要があります。

この操作では、Host や Date などの共通リクエストヘッダーも使用します。詳細については、「共通リクエストヘッダー」をご参照ください。

レスポンスヘッダー

この操作では、共通レスポンスヘッダーのみを使用します。詳細については、「共通レスポンスヘッダー」をご参照ください。

レスポンス要素

例

• バージョン管理が無効

  リクエスト例

  PUT /test%2FAK.txt HTTP/1.1
  Host: tesx.oss-cn-zhangjiakou.aliyuncs.com
  Accept-Encoding: identity
  User-Agent: aliyun-sdk-python/2.6.0(Windows/7/AMD64;3.7.0)
  Accept: text/html
  Connection: keep-alive
  x-oss-copy-source: /test/AK.txt
  date: Fri, 28 Dec 2018 09:41:55 GMT
  authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  Content-Length: 0

  レスポンス例

  x-oss-hash-crc64ecma はオブジェクトの 64 ビット CRC 値を示します。この値は CRC-64/XZ アルゴリズムに基づいて計算されます。CopyObject 操作を使用する場合、コピーされたオブジェクトが 64 ビット CRC 値を持つことは保証されません。

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Date: Fri, 28 Dec 2018 09:41:56 GMT
  Content-Type: application/xml
  Content-Length: 184
  Connection: keep-alive
  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-example HTTP/1.1
  Host: versioning-copy.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 03:45:32 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  x-oss-copy-source: /versioning-copy-source/source-object

  レスポンス例

  この例では、x-oss-copy-source-version-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
  Content-Length: 184
  Connection: keep-alive
  Date: Tue, 09 Apr 2019 03:45:32 GMT
  Server: 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-example HTTP/1.1
  Host: versioning-copy.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 03:45:32 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  x-oss-copy-source: /versioning-copy-source/source-object?versionId=CAEQNRiBgICv8uaA0BYiIDliZDc3MTc1NjE5MjRkMDI4ZGU4MTZkYjY1ZDgy****

  レスポンス例

  この例では、x-oss-copy-source-version-id はソースオブジェクトのバージョン ID であり、x-oss-copy-source で指定されたバージョンです。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
  Content-Length: 184
  Connection: keep-alive
  Date: Tue, 09 Apr 2019 03:45:32 GMT
  Server: AliyunOSS
  <?xml version="1.0" encoding="UTF-8"?>
  <CopyObjectResult>
    <ETag>"C4CA4238A0B923820DCC509A6F75****"</ETag>
    <LastModified>2019-04-09T03:45:32.000Z</LastModified>
  </CopyObjectResult>

SDK

この操作に対応する各言語の SDK は次のとおりです：

• Java

• Python V2

• PHP V2

• Go V2

• Harmony

• C

• .NET

• Android

• iOS

• Node.js

• Ruby

• Browser.js

• C++

ossutil

CopyObject 操作に対応する ossutil コマンドの詳細については、「copy-object」をご参照ください。

エラーコード

よくある質問

CopyObject 操作はファイルのバッチコピーをサポートしていますか？

いいえ、サポートしていません。CopyObject 操作は単一のファイルのみをコピーします。一度に複数のファイルをコピーするには、ossutil を使用できます。詳細については、「cp (ファイルのコピー)」をご参照ください。