Object Storage Service:AppendObject

バージョン管理

バージョン管理が有効または一時停止されているバケット内の追加可能オブジェクトに対して操作を実行する場合は、次の点にご注意ください。

• オブジェクトの現在のバージョンが追加可能オブジェクトである場合にのみ、データを追加できます。OSS は、この追加可能オブジェクトの旧バージョンを作成しません。

  追加可能オブジェクトの現在のバージョンに対して PutObject または DeleteObject 操作を実行すると、OSS は追加可能オブジェクトを旧バージョンとして保存します。ただし、このオブジェクトにデータを追加することはできなくなります。

• 通常オブジェクトや削除マーカーなど、追加可能でないオブジェクトに対して AppendObject 操作を実行することはできません。

• オブジェクトが存在しない場合、または最新バージョンが削除マーカーである場合にのみ、新しい追加可能バージョンを作成できます。そのためには、AppendObject を呼び出し、position パラメーターを 0 に設定します。

制限事項

• AppendObject を使用して作成されたオブジェクトの最終的なサイズは 5 GB を超えることはできません。

• 保持ポリシーによって保護されているオブジェクトに対して AppendObject 操作を使用することはできません。

• 追加可能オブジェクトに対して、CMK ID を指定して Key Management Service (KMS) によるサーバー側暗号化を有効にすることはできません。

• 追加可能オブジェクトのダウンロードパフォーマンスは、通常オブジェクトやマルチパートオブジェクトよりも大幅に低くなります。ビジネスシナリオに基づいてこれを評価する必要があります。

権限

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

リクエスト構文

POST /ObjectName?append&position=Position HTTP/1.1
Content-Length: ContentLength
Content-Type: ContentType
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

この操作の他の共通リクエストヘッダーの詳細については、「共通リクエストヘッダー」をご参照ください。

リクエストパラメーター

レスポンスヘッダー

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

CRC-64 の計算方法

次の方法を使用して計算を実行できます。

• Boost CRC モジュールを使用した計算

  typedef boost::crc_optimal<64, 0x42F0E1EBA9EA3693ULL, 0xffffffffffffffffULL, 0xffffffffffffffffULL, true, true> boost_ecma;
  uint64_t do_boost_crc(const char* buffer, int length)
  {
      boost_ecma crc;
      crc.process_bytes(buffer, length);
      return crc.checksum();
  }

• Python crcmod を使用した計算

  import crcmod
  do_crc64 = crcmod.mkCrcFun(0x142F0E1EBA9EA3693, initCrc=0, xorOut=0xffffffffffffffff, rev=True)
  print(do_crc64(b"123456789"))

他の操作との関連性

例

• リクエスト例

  POST /oss.jpg?append&position=0 HTTP/1.1 
  Host: oss-example.oss.aliyuncs.com 
  Cache-control: no-cache 
  Expires: Wed, 08 Jul 2015 16:57:01 GMT 
  x-oss-storage-class: Archive
  Content-Disposition: attachment;filename=oss_download.jpg 
  Date: Wed, 08 Jul 2015 06:57:01 GMT 
  Content-Type: image/jpg 
  Content-Length: 1717 
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-disposition;content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e  
  [1717 バイトのオブジェクトデータ]

  レスポンス例

  HTTP/1.1 200 OK
  Date: Wed, 08 Jul 2015 06:57:01 GMT
  ETag: "0F7230CAA4BE94CCBDC99C550000****"
  Connection: keep-alive
  Content-Length: 0  
  Server: AliyunOSS
  x-oss-hash-crc64ecma: 14741617095266562575
  x-oss-next-append-position: 1717
  x-oss-request-id: 559CC9BDC755F95A6448****

• バージョン管理リクエストの例

  バケットでバージョン管理が有効になっている場合、AppendObject リクエストへのレスポンスには x-oss-version-id レスポンスヘッダーが含まれます。このヘッダーは、現在のオブジェクトバージョンのバージョン ID を指定します。

  POST /example?append&position=0 HTTP/1.1 
  Host: versioning-append.oss.aliyuncs.com 
  Date: Tue, 09 Apr 2019 03:59:33 GMT
  Content-Length: 3
  Content-Type: application/octet-stream
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  レスポンス例

  HTTP/1.1 200 OK
  Date: Tue, 09 Apr 2019 03:59:33 GMT
  ETag: "2776271A4A09D82CA518AC5C0000****"
  Connection: keep-alive
  Content-Length: 0  
  Server: AliyunOSS
  x-oss-version-id: CAEQGhiBgIC_k6aV5RgiIGI3YTY2ZmMzYWJlMzQ3YjM4YTljOTk5YjUyZGF****
  x-oss-hash-crc64ecma: 3231342946509354535
  x-oss-next-append-position: 47
  x-oss-request-id: 5CAC18A5B7AEADE01700****

SDK

この操作の SDK は、次の言語で利用できます。

• Java

• Python V2

• PHP V2

• Go V2

• Node.js

• Harmony

• C

• .NET

• iOS

• Ruby

• Browser.js

• C++

ossutil コマンドラインインターフェイス

ossutil を使用してこの操作を実行するには、「append-object」コマンドをご参照ください。

エラーコード