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:
Yalnızca nesne erişim kontrol listesini (ACL) değiştirmek için: Komut,
PutObjectAclAPI işlemini çağırır.Yalnızca nesne etiketlerini değiştirmek için: Komut,
PutObjectTaggingAPI 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çinGetObjectTaggingAPI işlemini çağırır.Nesne depolama sınıfını veya meta verilerini değiştirmek için: Bu işlem nesneyi yeniden yazar. Komut,
CopyObjectAPI işlemini çağırır veya çok parçalı kopyalama akışını (InitiateMultipartUpload->UploadPartCopy->CompleteMultipartUpload) kullanır.-
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
PutObjectAclvePutObjectTaggingiş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
CopyObjectAPI işlemini veya çok parçalı kopyalama API işlemlerini (InitiateMultipartUpload->UploadPartCopy->CompleteMultipartUpload) çağırır.
Bir nesnenin depolama sınıfını değiştirmek PUT isteği ücretlerine yol açar:
--bigfile-thresholdile belirtilen eşikten büyük olmayan nesneler için ossutil,CopyObjectiş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
UploadPartCopyiş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.
UploadPartCopyisteklerini azaltmak için--bigfile-thresholdveya--part-sizedeğerlerini artırın. Bir nesnenin depolama sınıfını değiştirirkenCopyObjectyalnı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:
|
|
--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 |
|
--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:
|
|
--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
|
|
--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
|
|
--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
|
|
--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 |
|
-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:
|
|
--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:
|
|
--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 |
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
CopyObjectkullanmak ü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 -r1 GB'dan büyük nesneler çok parçalı kopyalama gerektirir.
UploadPartCopyisteklerini 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 -rUploadPartCopyisteklerinin 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 1Gile her biri 10 GiB olan 1000 nesneyi dönüştürmek, nesne başına 10UploadPartCopyisteği ve toplamda 10000 istek oluşturur.UploadPartCopyhedef 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ıcaInitiateMultipartUploadveCompleteMultipartUploadiş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.
NotListe 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/key2ossutil set-props list://list.txt -
Nesne özelliklerini bir bildirim dosyasından ayarlayın.
NotBir envanter görevini çalıştırdıktan sonra envanter sonuçlarında bir
csv.gzdosyası ve birmanifest.jsondosyası 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