Object Storage Service:AppendObject

Sürüm Oluşturma

Bir paket için sürüm oluşturma etkinleştirildiğinde veya askıya alındığında, Eklenebilir nesnelerin davranışıyla ilgili aşağıdaki hususlara dikkat edin:

• Bir Eklenebilir nesneye yalnızca mevcut sürümüne veri ekleyebilirsiniz. OSS bu nesne için önceki sürümler oluşturmaz.

  Mevcut sürüm üzerinde PutObject veya DeleteObject işlemi uygulamak, Eklenebilir nesneyi önceki bir sürüm olarak kaydeder. Nesneye artık veri eklenemez.

• Normal nesneler veya silme işaretçileri gibi Eklenebilir olmayan nesnelerde AppendObject işlemi uygulanamaz.

• Yeni bir Eklenebilir sürüm, yalnızca nesne mevcut değilse veya en son sürüm bir silme işaretçisiyse oluşturulabilir. Bu durumda position parametresini 0 olarak ayarlayın.

Sınırlamalar

• Bir Eklenebilir nesnenin maksimum boyutu 5 GB'tır.

• Bir bekletme ilkesi ile korunan nesnelerde AppendObject işlemini kullanamazsınız.

• Eklenebilir nesneler, KMS üzerinden CMK Kimliği ile sunucu tarafı şifrelemeyi desteklemez.

• Eklenebilir nesnelerin indirme performansı, Normal veya Çok Parçalı nesnelere kıyasla önemli ölçüde daha düşüktür. Bu durumun gereksinimlerinizi karşılayıp karşılamadığını değerlendirin.

İzinler

Varsayılan olarak bir Alibaba Cloud hesabı tam izinlere sahiptir. Bir Alibaba Cloud hesabı altındaki RAM kullanıcıları veya RAM rolleri varsayılan olarak herhangi bir izne sahip değildir. Alibaba Cloud hesabı veya hesap yöneticisi, işlem izinlerini RAM ilkeleri veya Paket İlkesi aracılığıyla vermelidir.

İstek sözdizimi

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

İstek üst bilgileri

Bu işlem ayrıca Ortak istek üst bilgilerini da destekler.

İstek parametreleri

Yanıt üst bilgileri

Bu işlem ayrıca Ortak yanıt üst bilgilerini da destekler.

CRC-64 hesaplama

Desteklenen hesaplama yöntemleri:

• Boost CRC modülü kullanılarak hesaplama

  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 kullanılarak hesaplama

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

İlgili işlemler

Örnekler

• İstek örneği

  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]

  Yanıt örneği

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

• Sürüm oluşturma istek örneği

  Sürüm oluşturma etkinleştirildiğinde, AppendObject yanıtı mevcut nesnenin sürüm kimliğini belirten x-oss-version-id üst bilgisini içerir.

  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

  Yanıt örneği

  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'ler

Bu işlem için SDK'ler:

• Java

• Python V2

• PHP V2

• Go V2

• Node.js

• Harmony

• C

• .NET

• iOS

• Ruby

• Browser.js

• C++

ossutil komut satırı arayüzü

ossutil içindeki append-object komutunu kullanın.

Hata kodları