Object Storage Service:AppendObject

Versionamento

Quando o versionamento está ativado ou suspenso para um bucket, observe o seguinte comportamento para objetos Appendable:

• É possível anexar dados apenas à versão atual de um objeto Appendable. O OSS não cria versões anteriores para esse objeto.

  Uma operação PutObject ou DeleteObject na versão atual salva o objeto Appendable como uma versão anterior. Após isso, não é mais possível anexar dados ao objeto.

• A operação AppendObject não pode ser executada em objetos que não sejam do tipo Appendable, como objetos Normal ou marcadores de exclusão.

• Uma nova versão Appendable só pode ser criada quando o objeto não existe ou quando a versão mais recente é um marcador de exclusão. Defina position como 0.

Limites

• O tamanho máximo de um objeto Appendable é de 5 GB.

• Não é possível usar a operação AppendObject em objetos protegidos por uma política de retenção.

• Objetos Appendable não suportam criptografia no lado do servidor com CMK ID por meio do KMS.

• O desempenho de download de objetos Appendable é significativamente inferior ao de objetos Normal ou Multipart. Avalie se esse comportamento atende aos seus requisitos.

Permissões

Por padrão, uma conta Alibaba Cloud possui permissões totais. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não têm nenhuma permissão por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de políticas do RAM ou Bucket Policy.

Sintaxe da solicitação

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

Cabeçalhos da solicitação

Esta operação também suporta Cabeçalhos comuns de solicitação.

Parâmetros da solicitação

Cabeçalhos da resposta

Esta operação também suporta Cabeçalhos comuns de resposta.

Cálculo CRC-64

Métodos de cálculo suportados:

• Cálculo usando o módulo 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();
  }

• Cálculo usando crcmod do Python

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

Operações relacionadas

Exemplos

• Exemplo de solicitação

  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]

  Exemplo de resposta

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

• Exemplo de solicitação com versionamento

  Quando o versionamento está ativado, a resposta do AppendObject inclui x-oss-version-id, que especifica o ID da versão do objeto atual.

  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

  Exemplo de resposta

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

SDKs

SDKs para esta operação:

• Java

• Python V2

• PHP V2

• Go V2

• Node.js

• Harmony

• C

• .NET

• iOS

• Ruby

• Browser.js

• C++

Interface de linha de comando ossutil

Use o comando append-object no ossutil.

Códigos de erro