Object Storage Service:CopyObject

バージョン管理

デフォルトでは、x-oss-copy-source はオブジェクトの現在のバージョンをコピーします。特定のバージョンをコピーするには、x-oss-copy-source にバージョン ID を含めます。指定されたコピー元バージョンが削除マーカーである場合、OSS は 404 エラーを返し、オブジェクトが存在しないことを示します。

オブジェクトの以前のバージョンを復元するには、そのバージョンを同じバケットにコピーします。この操作により、コピーされたバージョンが新しい現在のバージョンになります。

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

制限事項

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

  • 暗号化方式またはストレージクラスを変更しない場合、5 GB を超えるオブジェクトを同じバケット内でコピーできます。

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

  • コピー中にオブジェクトの暗号化方式またはストレージクラスを変更する場合、オブジェクトサイズは 1 GB に制限されます。より大きなオブジェクトの場合は、UploadPartCopy 操作を使用する必要があります。

• 権限

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

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

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

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

• コピー元オブジェクトがシンボリックリンクの場合

  シンボリックリンクに対して CopyObject 操作を使用すると、シンボリックリンクのみがコピーされます。シンボリックリンクが指すオブジェクトの内容はコピーされません。

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

  階層型名前空間が有効になっているバケット内でディレクトリをコピーすることはできません。

• オブジェクトの上書き競合の防止

  「ファイルの上書き禁止」を有効にすると、CopyObject を使用してオブジェクトのストレージクラス (標準からアーカイブストレージなど) を変更することはできません。代わりに、ライフサイクルルールを使用してストレージクラスを自動的に移行します。

• ObjectWorm の制限事項

  追加可能オブジェクトをコピーする場合、リクエストに ObjectWorm 関連のパラメーターを含めることはできません。

権限

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

課金

• CopyObject 操作の各呼び出しは、コピー先バケットに対する 1 回の PUT リクエストとしてカウントされます。

• CopyObject 操作により、コピー先バケットのストレージ使用量が増加します。

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

• 低頻度アクセス (IA) オブジェクトに対して CopyObject 操作を呼び出すと、IA ストレージのデータ取得料金が発生します。コピー元オブジェクトが、リアルタイムアクセスが有効なバケット内の未解凍のアーカイブストレージオブジェクトである場合、リアルタイムアクセスのデータ取得料金が発生します。これらの料金は、コピー元バケットを所有するアカウントに請求されます。課金の詳細については、「データ処理料金」をご参照ください。

リクエスト構文

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 CLI

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

エラーコード

よくある質問

CopyObject は一度に複数のオブジェクトのコピーをサポートしていますか？

CopyObject 操作は単一のオブジェクトのみをコピーします。複数のオブジェクトをバッチでコピーするには、ossutil コマンドラインツールを使用します。