版本控制

在目标Bucket处于开启或暂停版本控制状态下，对Appendable类型Object执行相关操作时，有如下注意事项：

• 仅允许对当前版本为Appendable类型的Object执行追加上传（AppendObject）操作，且OSS不会为该Appendable类型的Object生成历史版本。

  对当前版本为Appendable类型的Object执行PutObject或DeleteObject操作时，OSS会将该Appendable类型的Object保留为历史版本，但该Object不允许继续追加。

• 不支持对Appendable类型Object执行拷贝操作。
• 不支持对非Appendable类型的Object，包括Normal Object、删除标记（Delete Marker）等执行AppendObject操作。

使用限制

• 通过AppendObject方式最后生成的Object大小不得超过5 GB。
• 处于合规保留策略保护期的Object不支持AppendObject操作。
• AppendableObject不支持指定CMK ID进行服务端KMS加密。

请求语法

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

请求头

关于此接口涉及的其他公共请求头的更多信息，请参见公共请求头（Common Request Headers）。

响应头

关于此接口涉及的其他公共响应头的更多信息，请参见公共响应头（Common Response Headers）。

CRC64的计算方式

Appendable Object的CRC64采用ECMA-182标准。您可以使用以下方法进行计算：

• 用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的方式计算

  do_crc64 = crcmod.mkCrcFun(0x142F0E1EBA9EA3693L, initCrc=0L, xorOut=0xffffffffffffffffL, rev=True)
  print do_crc64(“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 
  Content-Encoding: utf-8 
  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: OSS qn6qrrqxo2oawuk53otf****:kZoYNv66bsmc10+dcGKw5x2P****  
  [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****

• 版本控制请求示例

  对于开启或暂停了版本控制的Bucket，AppendObject的响应Header中会返回x-oss-version-id，且x-oss-version-id只能为null。

  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: OSS bwo4j5l8d3j****:MCY5nnfgfJU/f3Xe0odqBtG5****

  返回示例

  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: null
  x-oss-hash-crc64ecma: 3231342946509354535
  x-oss-next-append-position: 3
  x-oss-request-id: 5CAC18A5B7AEADE01700****

SDK

此接口所对应的各语言SDK如下：

• Java
• Python
• PHP
• Go
• C
• .NET
• Android
• iOS
• Ruby

错误码