Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:appendfromfile

Son Güncelleme:Oct 01, 2026

Bu konu, Object Storage Service (OSS) içindeki eklenebilir bir nesneye içerik eklemek için appendfromfile komutunun nasıl çalıştırılacağını açıklar.

Kullanım notları

  • Ekleme yüklemesi yapmak için oss:GetObject ve oss:PutObject izinlerine sahip olmanız gerekir. Daha fazla bilgi için bkz. Özel ilke atama.

  • ossutil 1.6.16 ve sonraki sürümlerde, komut satırında ikili dosya adı olarak doğrudan ossutil kullanabilirsiniz. İşletim sistemine göre ikili dosya adını güncellemeniz gerekmez. 1.6.16'dan önceki ossutil sürümlerinde ise işletim sistemine göre ikili dosya adını güncellemeniz gerekir. Daha fazla bilgi için bkz. ossutil komut referansı.

Komut sözdizimi

ossutil appendfromfile localfilename oss://bucketname/objectname
[--meta <value>]

Aşağıdaki tabloda parametreler ve seçenekler açıklanmıştır.


Parametre/Seçenek


Açıklama


localfilename


Yüklemek istediğiniz yerel dosyanın tam yolu.


bucketname


İçerik eklemek istediğiniz nesneyi barındıran paketin adı.


objectname


İçerik eklemek istediğiniz nesnenin adı. appendfromfile komutunu kullanarak ekleme yüklemesi yaparken nesne için yerel dosyanın özgün adını koruyabilir veya başka bir ad belirtebilirsiniz.


--meta

Nesnenin meta verileri. Bu parametreyi yalnızca appendfromfile komutunu kullanarak bir nesneyi ilk kez yüklediğinizde yapılandırabilirsiniz. Örnek: --meta "x-oss-object-acl:private".

Nesne için meta verileri yapılandırdıktan sonra nesnenin meta verilerini değiştirmek için set-meta (Nesne meta verilerini yönetme) komutunu çalıştırabilirsiniz.

Örnekler

Aşağıdaki örneklerde, önce appendfromfile komutu kullanılarak kök dizindeki exampleobject.txt adlı yerel dosya examplebucket paketine yüklenir ve bu dosya pakette exampleobject.txt nesnesi olarak depolanır. Ardından, exampleobject.txt nesnesine içerik eklemek için appendfromfile komutu kullanılır.

  1. exampleobject.txt dosyasını yüklemek ve yüklenen nesnenin erişim kontrol listesini (ACL) özel olarak ayarlamak için aşağıdaki komutu çalıştırın:

    ossutil appendfromfile exampleobject.txt oss://examplebucket/exampleobject.txt --meta "x-oss-object-acl:private"

    Aşağıdaki örnek çıktı, yerel dosyanın pakete yüklendiğini ve exampleobject.txt nesnesi olarak depolandığını gösterir. exampleobject.txt nesnesinin boyutu 5 bayttır.

    total append 5(100.00%) byte,speed is 0.00(KB/s)
    local file size is 5,the object new size is 5,average speed is 0.04(KB/s)
  2. dest.txt adlı bir dosyanın içeriğini exampleobject.txt nesnesine eklemek için aşağıdaki komutu çalıştırın.

    exampleobject.txt nesnesine daha fazla içerik eklemek isterseniz dest.txt yerine, içeriğini exampleobject.txt nesnesine eklemek istediğiniz dosyanın adını yazın:

    ossutil appendfromfile dest.txt oss://examplebucket/exampleobject.txt

    Aşağıdaki örnek çıktı, exampleobject.txt nesnesine içerik eklendiğini ve ekleme yükleme işleminden sonraki nesne boyutunun 150 bayt olduğunu gösterir.

    total append 150(100.00%) byte,speed is 0.00(KB/s)
    local file size is 150,the object new size is 150,average speed is 1.19(KB/s)

Ortak seçenekler

Farklı bir bölgedeki bir pakete erişmek için uç noktayı belirtmek üzere -e seçeneğini kullanın. Farklı bir Alibaba Cloud hesabına ait bir pakete erişmek için AccessKey ID için -i ve AccessKey Secret için -k seçeneğini kullanın.

Örneğin, China (Shanghai) bölgesinde bulunan ve başka bir Alibaba Cloud hesabına ait olan examplebucket paketine exampleobject.txt dosyasını ekleme yüklemesiyle yüklemek için aşağıdaki komutu çalıştırabilirsiniz:

ossutil appendfromfile exampleobject.txt oss://examplebucket/exampleobject.txt -e shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Ortak seçenekler.