Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:set-props (Set object properties)

Son Güncelleme:Oct 01, 2026

set-props komutu; erişim izinleri, depolama sınıfları, meta veriler ve etiketler dahil olmak üzere nesne özelliklerini ayarlar.

Dikkat Edilmesi Gerekenler

set-props komutu, değiştirdiğiniz nesne özelliğine bağlı olarak farklı API işlemlerini çağırır. Gerekli izinlere sahip olduğunuzdan emin olun. Örneğin, PutObjectAcl API işlemini çağırmak için oss:PutObjectAcl iznine ihtiyacınız vardır. Çağrılan belirli API işlemleri aşağıda listelenmiştir:

  1. Yalnızca nesne erişim kontrol listesini (ACL) değiştirmek için: Komut, PutObjectAcl API işlemini çağırır.

  2. Yalnızca nesne etiketlerini değiştirmek için: Komut, PutObjectTagging API işlemini çağırır. Etiket değiştirme talimatı, artımlı ekleme gibi mevcut etiketlerin güncellenmesini içeriyorsa sistem önce orijinal etiketleri almak için GetObjectTagging API işlemini çağırır.

  3. Nesne depolama sınıfını veya meta verilerini değiştirmek için: Bu işlem nesneyi yeniden yazar. Komut, CopyObject API işlemini çağırır veya çok parçalı kopyalama akışını (InitiateMultipartUpload -> UploadPartCopy -> CompleteMultipartUpload) kullanır.

  4. Aynı anda birden fazla özelliği değiştirmek için: Komut, en verimli API işlemi kombinasyonunu seçer. Örneğin:

    • Hem nesne izinlerini hem de etiketleri değiştirmek için: Komut PutObjectAcl ve PutObjectTagging işlemlerini çağırır.

    • Hem nesne izinlerini hem de depolama sınıfını değiştirmek için: Komut, izinleri ve depolama sınıfını aynı anda güncellemek amacıyla doğrudan CopyObject API işlemini veya çok parçalı kopyalama API işlemlerini (InitiateMultipartUpload -> UploadPartCopy -> CompleteMultipartUpload) çağırır.

Not

Bir nesnenin depolama sınıfını değiştirmek PUT isteği ücretlerine yol açar:

  • --bigfile-threshold ile belirtilen eşikten büyük olmayan nesneler için ossutil, CopyObject işlemini çağırır. İstek, kaynak nesnenin depolama sınıfına göre faturalandırılır.

  • Eşiği aşan nesneler için ossutil çok parçalı kopyalama kullanır. Her parça UploadPartCopy işlemini çağırır. İstek, hedef nesnenin depolama sınıfına göre faturalandırılır.

  • Çok sayıda nesneyi Deep Cold Archive'a dönüştürmek yüksek PUT isteği ücretlerine neden olabilir. UploadPartCopy isteklerini azaltmak için --bigfile-threshold veya --part-size değerlerini artırın. Bir nesnenin depolama sınıfını değiştirirken CopyObject yalnızca 1 GB'dan büyük olmayan nesneleri destekler.

Faturalandırma kuralları için bkz. İstek ücretleri. Deep Cold Archive için faturalandırma ve kullanım rehberliği için bkz. Deep Cold Archive kullanımı için en iyi uygulamalar.

Komut biçimi

ossutil set-props oss://bucket[/prefix] [flags]

Parametre

Tür

Açıklama

--acl

string

Nesnenin erişim kontrol listesi (ACL). Geçerli değerler:

  • private: özel.

  • public-read: genel okuma.

  • public-read-write: Genel okuma ve yazma erişimi.

  • default: paketten devralır.

--bigfile-threshold

SizeSuffix

Çok parçalı yükleme, indirme veya kopyalama için nesne boyutu eşiği. Eşiği aşan nesneler çok parçalı kopyalama kullanır. Varsayılan değer: 100 MiB. Desteklenen son ekler: B, K, M, G, T ve P.

--cache-control

string

Nesne indirildiğinde web sayfası önbelleğe alma davranışını belirtir.

--content-disposition

string

Nesnenin nasıl görüntüleneceğini belirtir.

--content-encoding

string

Nesnenin kodlama biçimini belirtir.

--content-type

string

Nesnenin içerik türü.

-d, --dirs

/

Geçerli dizindeki dosyaları ve alt dizinleri döndürür. Tüm alt dizinlerdeki tüm dosyaları yinelemeli olarak görüntülemez.

--encoding-type

string

Giriş nesnesi adının veya dosya adının kodlama türü. Geçerli değer: url.

--end-with

string

Nesneleri alfabetik olarak sıralar ve belirtilen değere kadar veya bu değerdeki nesneleri döndürür.

--exclude

stringArray

Yolları veya dosya adlarını hariç tutma kuralları.

--exclude-from

stringArray

Hariç tutma kurallarını bir kural dosyasından okur.

--expires

string

Önbelleğe alınan içerik için mutlak sona erme zamanını belirtir.

--files-from

stringArray

Kaynak dosya adlarının listesini bir dosyadan okur. Boş satırlar veya yorum satırları yoksayılır.

--files-from-raw

stringArray

Kaynak dosya adlarının listesini bir dosyadan okur.

--filter

stringArray

Yolları veya dosya adlarını filtreleme kuralları.

--filter-from

stringArray

Filtreleme kurallarını bir kural dosyasından okur.

-f, --force

/

Onay istemi olmadan işlemi zorla.

--include

stringArray

Yolları veya dosya adlarını dahil etme kuralları.

--include-from

stringArray

Dahil etme kurallarını bir kural dosyasından okur.

-j, --job

int

Eşzamanlı görev sayısı. Varsayılan değer 3'tür.

Önemli

Bu parametre yalnızca -f, --update, --size-only veya --ignore-existing parametresini belirttiğinizde etkili olur.

--list-objects

/

Nesneleri listelemek için ListObjects API işlemini kullanır.

--max-size

SizeSuffix

Aktarılacak bir dosyanın maksimum boyutu. Varsayılan birim bayttır. Son ek kullanabilirsiniz: B, K, M, G, T veya P. 1 K (KiB) = 1024 B.

--metadata

strings

Nesnenin kullanıcı meta verilerini key=value biçiminde belirtir.

Örnek: --metadata test=value,test1=value1.

--metadata-directive

string

Meta verileri değiştirmeye yönelik talimat. Geçerli değerler:

  • replace: Yalnızca komut satırı seçeneklerinde belirtilen meta verileri korur.

  • update: Komut satırındaki meta veriler ile nesnenin meta verilerinin birleşimini alır.

  • purge: Tüm meta verileri temizler.

  • delete: Komut satırı seçeneklerinde belirtilen meta verileri siler ve geri kalanını korur.

--metadata-exclude

stringArray

Nesne meta verilerini hariç tutma kuralları.

--metadata-filter

stringArray

Nesne meta verilerini filtreleme kuralları.

--metadata-filter-from

stringArray

Nesne meta verisi filtreleme kurallarını bir kural dosyasından okur.

--metadata-include

stringArray

Nesne meta verilerini dahil etme kuralları.

--min-age

Duration

Özellikleri yalnızca belirtilen zaman aralığından önce değiştirilen dosyalar için ayarlar. Varsayılan birim saniyedir. Saat başına 1 saat için 1h gibi bir birim son eki kullanabilirsiniz.

Not

--min-age 1h özellikleri yalnızca 1 saat veya daha önce değiştirilen dosyalar için ayarlar.

--max-age

Duration

Özellikleri yalnızca belirtilen zaman aralığı içinde değiştirilen dosyalar için ayarlar. Varsayılan birim saniyedir. Saat başına 1 saat için 1h gibi bir birim son eki kullanabilirsiniz.

Not

--max-age 1h özellikleri yalnızca son bir saat içinde değiştirilen dosyalar için ayarlar.

--min-mtime

Time

Özellikleri yalnızca belirtilen zamandan sonra değiştirilen dosyalar için ayarlar. Zaman UTC biçiminde olmalıdır. Örneğin, 2006-01-02T15:04:05.

Not

--min-mtime "2006-01-02T15:04:05" özellikleri yalnızca 2 Ocak 2006 tarihinde UTC ile 15:04:05'ten sonra değiştirilen dosyalar için ayarlar.

--max-mtime

Time

Özellikleri yalnızca belirtilen zamandan önce değiştirilen dosyalar için ayarlar. Zaman UTC biçiminde olmalıdır. Örneğin, 2006-01-02T15:04:05.

--min-size

SizeSuffix

Aktarılacak bir dosyanın minimum boyutu. Varsayılan birim bayttır. Son ek kullanabilirsiniz: B, K, M, G, T veya P. 1 K (KiB) = 1024 B.

--no-progress

/

İlerleme çubuğunu görüntülemez.

--page-size

int

Toplu işleme sırasında her sayfada listelenecek maksimum nesne sayısı. Varsayılan değer 1000'dir. Değer 1 ile 1000 arasında olabilir.

--parallel

int

Tek bir dosyadaki işlemler için eşzamanlı görev sayısı.

--part-size

SizeSuffix

Parça boyutu. Varsayılan olarak ossutil, nesne boyutuna göre parça boyutunu hesaplar. Daha büyük parçalar UploadPartCopy isteklerinin sayısını azaltır. Geçerli aralık: 100 KiB ila 5 GiB.

-r, --recursive

/

İşlemi yinelemeli olarak gerçekleştirir. Bu seçeneği belirttiğinizde komut, paketteki tüm eşleşen nesnelere uygulanır. Aksi takdirde komut yalnızca yol tarafından belirtilen nesneye uygulanır.

--request-payer

string

İstek için ödeme yöntemi. İstekte bulunan tarafından ödeme modunu kullanıyorsanız bu parametreyi ayarlayın. Geçerli değer: requester.

--start-after

string

Nesneleri alfabetik olarak sıralar ve belirtilen değerden sonraki nesneleri döndürür.

--storage-class

string

Nesnenin depolama sınıfı. Geçerli değerler:

  • Standard: Standart.

  • IA: Seyrek Erişim.

  • Archive: Arşiv Depolama.

  • ColdArchive: Soğuk Arşiv.

  • DeepColdArchive: Derin Soğuk Arşiv.

--tagging

strings

Nesnenin etiketlerini key=value biçiminde belirtir.

Örnek: --tagging tag1=value1,tag2=value2.

--tagging-directive

string

Etiketleri değiştirmeye yönelik talimat. Geçerli değerler:

  • replace: Yalnızca komut satırı seçeneklerinde belirtilen etiketleri korur.

  • update: Komut satırındaki etiketler ile nesnenin etiketlerinin birleşimini alır.

  • purge: Tüm etiketleri temizler.

  • delete: Komut satırı seçeneklerinde belirtilen etiketleri siler ve geri kalanını korur.

--version-id

string

Nesnenin sürüm kimliği.

--list-format

string

Liste dosyasının biçimi. Geçerli değerler: plain, inventory.

--list-manifest-from

string

Liste dosyası biçiminin açıklamasını bir dosyadan okur. Liste dosyası biçimi inventory olduğunda bu parametre gereklidir.

Daha fazla bilgi için bkz. Komut satırı seçenekleri.

Örnekler

  • Bir nesnenin erişim izinlerini özel olarak ayarlayın.

    ossutil set-props oss://examplebucket/exampleobject.txt --acl private
  • Bir nesnenin depolama sınıfını Arşiv Depolama olarak ayarlayın.

    ossutil set-props oss://examplebucket/exampleobject.txt --storage-class Archive
  • Nesneleri toplu olarak Deep Cold Archive'a dönüştürün ve PUT isteği ücretlerini tahmin edin.

    1 GB'dan büyük olmayan nesneler için CopyObject kullanmak üzere çok parçalı eşiğini artırın. Aşağıdaki örnek eşiği 1 GB olarak ayarlar:

    ossutil set-props oss://examplebucket/exampledir/ --storage-class DeepColdArchive --bigfile-threshold 1G -r

    1 GB'dan büyük nesneler çok parçalı kopyalama gerektirir. UploadPartCopy isteklerini azaltmak için parça boyutunu artırın. Aşağıdaki örnek parça boyutunu 1 GiB olarak ayarlar:

    ossutil set-props oss://examplebucket/exampledir/ --storage-class DeepColdArchive --part-size 1G -r

    UploadPartCopy isteklerinin sayısını aşağıdaki formüllerle tahmin edin:

    Parts per object = ceil(object size / part size)
    UploadPartCopy requests = number of objects × parts per object

    Örneğin, --part-size 1G ile her biri 10 GiB olan 1000 nesneyi dönüştürmek, nesne başına 10 UploadPartCopy isteği ve toplamda 10000 istek oluşturur. UploadPartCopy hedef nesnenin depolama sınıfına göre faturalandırılır. Bu nedenle, bu ücret bölümünü Deep Cold Archive PUT istekleri için faturalandırma kurallarına göre tahmin edin. Çok parçalı kopyalama ayrıca InitiateMultipartUpload ve CompleteMultipartUpload işlemlerini çağırır. Nesne listeleme ve yeniden denemeler de istek ücretlerine neden olabilir.

  • .txt uzantısına sahip nesneler için content-type değerini text/plain olarak değiştirin.

    ossutil set-props oss://bucket/prefix --content-type text/plain --include "*.txt" --metadata-directive update -r
  • Bir nesnenin etiketlerini ayarlayın.

    ossutil set-props oss://examplebucket/exampleobject.txt --tagging tag1=value1 --tagging-directive update
  • Nesne özelliklerini bir liste dosyasından ayarlayın.

    Not

    Liste dosyasındaki her satır bir nesneyi temsil eder ve oss://{bucket}/{key} OSS yol biçimini kullanır. Örneğin, list.txt dosyası aşağıdaki içeriği içerir:

    oss://examplebucket/key1
    oss://examplebucket/key2
    ossutil set-props list://list.txt 
  • Nesne özelliklerini bir bildirim dosyasından ayarlayın.

    Not

    Bir envanter görevini çalıştırdıktan sonra envanter sonuçlarında bir csv.gz dosyası ve bir manifest.json dosyası oluşturulur. Bildirim dosyasından nesne özelliklerini ayarlamak için bu iki dosyayı kullanmanız gerekir.

    ossutil set-props list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json