Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:append-object

Son Güncelleme:Oct 01, 2026

Verileri artımlı olarak ekleyerek bir nesne yükler.

Kullanım notları

  • append-object ile oluşturulan son nesnenin boyutu 5 GB'ı aşamaz.

  • append-object, belirtilen bir müşteri ana yöneticisi anahtarı (CMK) kimliği kullanarak Key Management Service (KMS) ile sunucu tarafı şifrelemeyi desteklemez.

İzinler

Varsayılan olarak bir Alibaba Cloud hesabı tüm 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öneticisinin, RAM ilkeleri veya Bucket Policy aracılığıyla işlem izinleri vermesi gerekir.

API

Action

Description

AppendObject

oss:PutObject

Mevcut bir nesneye veri ekleyerek nesne yüklemek için bu işlemi çağırın.

oss:PutObjectTagging

Mevcut bir nesneye ek yaparak nesne yüklerken x-oss-tagging üzerinden nesne etiketleri belirtirseniz bu izin gereklidir.

Komut sözdizimi

ossutil api append-object --bucket value --key value --position value [flags]


Parametre


Tür


Açıklama


--body


dize


İstek gövdesi.


--bucket


dize


Paket adı.


--cache-control


dize


Nesne için önbelleğe alma davranışı.


--content-disposition


dize


İndirildiğinde nesnenin görüntülenecek adı.


--content-encoding


dize


Nesnenin kodlama biçimi.


--content-md5


dize


Veri bütünlüğünü doğrulamak için kullanılan nesne içeriğinin MD5 karması.


--expires


dize


Son kullanma zamanı.


--key


dize


Nesnenin tam yolu.


--metadata


dizeDizisi


Nesnenin meta verileri. x-oss-meta-* ön ekiyle başlayan parametrelerle özel meta veriler belirtin.


--object-acl


dize


Nesnenin erişim kontrol listesi (ACL).


--position


dize


Veri ekleme işleminin başlayacağı bayt cinsinden konum.


--server-side-encryption


dize


Sunucu tarafı şifreleme yöntemi.


--storage-class


dize


Nesnenin depolama sınıfı.


--tagging


dize


Nesne etiketleri. Birden çok etiket belirtebilirsiniz. Örnek: TagA=A&TagB=B.

Not
  • append-object komutu AppendObject API işlemine karşılık gelir. API işleminin parametreleri hakkında daha fazla bilgi için bkz. AppendObject.

  • Desteklenen genel komut satırı seçenekleri hakkında daha fazla bilgi için bkz. Global command-line options.

Örnekler

  • exampleobject nesnesine bir dize ekleyin.

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss"
  • Bir dosyadan gelen verileri exampleobject nesnesine ekleyin.

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body file://appendFile
  • Özel meta verilerle exampleobject nesnesine bir dize ekleyin.

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --metadata user=aliyun --metadata email=ali***@aliyuncs.com
  • Nesne etiketleriyle exampleobject nesnesine bir dize ekleyin.

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --tagging "TagA=A&TagB=B"
  • exampleobject nesnesine bir dize ekleyin ve ACL ile depolama sınıfını ayarlayın.

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --object-acl private --storage-class IA
  • Sunucu tarafı şifreleme ile exampleobject nesnesine bir dize ekleyin.

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --body "hi oss" --server-side-encryption AES256
  • Bir dize ekleyin ve nesne için cache-control davranışını ayarlayın.

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --cache-control no-cache
  • Bir dize ekleyin ve nesne için indirme dosya adını ayarlayın.

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --content-disposition "attachment;filename=oss_download.jpg"
  • Content-MD5 bütünlük denetimiyle exampleobject nesnesine bir dize ekleyin.

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --content-md5 ohhnqLBJFiKkPSBO1eNaUA==