Object Storage Service:AppendObject

バージョン管理

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

• データを追加できるのは、追加可能オブジェクトのカレントバージョンのみです。この操作中、OSS はオブジェクトの旧バージョンを作成しません。

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

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

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

注意事項

• AppendObject 操作で作成されるオブジェクトのサイズは 5 GB を超えることはできません。

• AppendObject 操作は、バケットレベルの保持ポリシーで保護されているオブジェクトではサポートされていません。

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

• 追加可能オブジェクトのダウンロードパフォーマンスは、標準オブジェクトやマルチパートアップロードでアップロードされたオブジェクトよりも大幅に低くなります。追加可能オブジェクトを使用する前に、ビジネス要件を評価してください。

• バケットでオブジェクトレベルの保持ポリシーが有効になっている場合、AppendObject 操作を使用してオブジェクトをアップロードすることはできません。

権限

デフォルトでは、Alibaba Cloud アカウント (root ユーザー) は完全な権限を持っています。Alibaba Cloud アカウント (root ユーザー) 配下の RAM ユーザーまたは RAM ロールは、デフォルトでは何の権限も持っていません。Alibaba Cloud アカウント (root ユーザー) またはアカウント管理者は、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 の計算方法

次の方法を使用して 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 bytes of object data]

  レスポンス例

  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++

CLI (ossutil)

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

エラーコード