Blob Özelliklerini Ayarlama

  • Makale

İşlem, Set Blob Properties blob üzerindeki sistem özelliklerini ayarlar.

İstek

İstek Set Blob Properties aşağıdaki gibi oluşturulabilir. HTTPS kullanmanızı öneririz. myaccount değerini depolama hesabınızın adıyla değiştirin:

PUT yöntemi istek URI'si HTTP sürümü
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=properties HTTP/1.1

Öykünülmüş Depolama Hizmeti URI'si

Öykünülen depolama hizmetine karşı istekte bulunulduğunda öykünücü konak adını ve Blob Depolama bağlantı noktasını olarak 127.0.0.1:10000ve ardından öykünülen depolama hesabı adını belirtin:

PUT yöntemi istek URI'si HTTP sürümü
http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=properties HTTP/1.1

Daha fazla bilgi için bkz . Yerel Azure Depolama geliştirmesi için Azurite öykünücüsü kullanma.

URI parametreleri

İstek URI'sinde aşağıdaki ek parametreleri belirtebilirsiniz:

Parametre Açıklama
timeout İsteğe bağlı. timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Blob Depolama işlemleri için zaman aşımlarını ayarlama.

İstek üst bilgileri (tüm blob türleri)

Aşağıdaki tabloda tüm blob türleri için gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.

İstek üst bilgisi Açıklama
Authorization Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
Date veya x-ms-date Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
x-ms-version Tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
x-ms-blob-cache-control İsteğe bağlı. Blob için önbellek denetim dizesini değiştirir.

bu özellik istekte belirtilmezse, blob için özellik temizlenir. Blob Özelliklerini Al'a yapılan sonraki çağrılar, blob üzerinde açıkça yeniden ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-blob-content-type İsteğe bağlı. Blob'un içerik türünü ayarlar.

bu özellik istekte belirtilmezse, blob için özellik temizlenir. Blob Özelliklerini Al'a yapılan sonraki çağrılar, blob üzerinde açıkça yeniden ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-blob-content-md5 İsteğe bağlı. Blob'un MD5 karması olarak ayarlar.

bu özellik istekte belirtilmezse, blob için özellik temizlenir. Blob Özelliklerini Al'a yapılan sonraki çağrılar, blob üzerinde açıkça yeniden ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-blob-content-encoding İsteğe bağlı. Blob'un içerik kodlamasını ayarlar.

bu özellik istekte belirtilmezse, blob için özellik temizlenir. Blob Özelliklerini Al'a yapılan sonraki çağrılar, blob üzerinde açıkça yeniden ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-blob-content-language İsteğe bağlı. Blob'un içerik dilini ayarlar.

bu özellik istekte belirtilmezse, blob için özellik temizlenir. Blob Özelliklerini Al'a yapılan sonraki çağrılar, blob üzerinde açıkça yeniden ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-lease-id:<ID> Blob etkin bir kiraya sahipse gereklidir. Etkin kiralaması olan bir blobda bu işlemi gerçekleştirmek için bu üst bilgi için geçerli kira kimliğini belirtin.
x-ms-client-request-id İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. İzleme Azure Blob Depolama.
x-ms-blob-content-disposition İsteğe bağlı. Blob Content-Disposition üst bilgisini ayarlar. Sürüm 2013-08-15 ve üzeri için kullanılabilir.

Yanıt Content-Disposition üst bilgisi alanı, yanıt yükünün nasıl işlendiği hakkında ek bilgiler sağlar ve ek meta veriler eklemek için kullanılabilir. Örneğin, olarak ayarlandıysa attachment, kullanıcı aracısının yanıtı görüntülememesi gerektiğini, bunun yerine belirtilen blob adından farklı bir dosya adıyla Farklı Kaydet iletişim kutusunu göstermesi gerektiğini gösterir.

Blob Al ve BlobÖzelliklerini Al işlemlerinden gelen yanıt üst bilgisini içerircontent-disposition.
Origin İsteğe bağlı. İsteğin verildiği kaynağı belirtir. Bu üst bilginin varlığı, yanıtta çıkış noktaları arası kaynak paylaşımı üst bilgileriyle sonuçlanır. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için CORS (çıkış noktaları arası kaynak paylaşımı) desteği.

Bu işlem, yalnızca belirli bir koşul karşılandığında blob özelliklerini ayarlamak için koşullu üst bilgilerin kullanımını da destekler. Daha fazla bilgi için bkz. Blob Depolama işlemleri için koşullu üst bilgileri belirtme.

İstek üst bilgileri (yalnızca sayfa blobları)

Aşağıdaki tabloda yalnızca sayfa blobları üzerindeki işlemler için geçerli olan istek üst bilgileri açıklanmaktadır:

İstek üst bilgisi Açıklama
x-ms-blob-content-length: byte value İsteğe bağlı. Sayfa blobunu belirtilen boyuta yeniden boyutlandırıyor. Belirtilen değer blobun geçerli boyutundan küçükse, belirtilen değerden büyük değerlere sahip tüm sayfa blobları temizlenir.

Bu özellik blok blobunun veya ekleme blobunun boyutunu değiştirmek için kullanılamaz. Blok blobu veya ekleme blobu için bu özelliğin ayarlanması 400 (Hatalı İstek) durum kodunu döndürür.
x-ms-sequence-number-action: {max, update, increment} İsteğe bağlı, ancak istek için üst bilgi ayarlandıysa x-ms-blob-sequence-number gereklidir. Bu özellik yalnızca sayfa blobları için geçerlidir.

Bu özellik, hizmetin blob'un sıra numarasını nasıl değiştirmesi gerektiğini gösterir. Bu özellik için aşağıdaki seçeneklerden birini belirtin:

- max: Dizi numarasını istekle birlikte verilen değerin ve blob için şu anda depolanan değerin daha yüksek olacak şekilde ayarlar.
- update: Sıra numarasını isteğe dahil edilen değere ayarlar.
- increment: Sıra numarasının değerini 1 artırır. Bu seçeneği belirtiyorsanız, öğesini eklemeyin x-ms-blob-sequence-number header. Bunu yaptığınızda durum kodu 400 (Hatalı İstek) döndürülüyor.
x-ms-blob-sequence-number: <num> İsteğe bağlı, ancak özelliği veya updateolarak ayarlandıysa maxx-ms-sequence-number-action gereklidir. Bu özellik yalnızca sayfa blobları için geçerlidir.

özelliği blob'un sıra numarasını ayarlar. Sıra numarası, istekleri izlemek ve eşzamanlılık sorunlarını yönetmek için kullanabileceğiniz kullanıcı tarafından denetlenen bir özelliktir. Daha fazla bilgi için Sayfa Koy işlemine bakın.

Bu özelliği ile x-ms-sequence-number-action birlikte kullanarak blobun sıra numarasını belirtilen değere veya istekle belirtilen veya şu anda blob ile depolanan değerlerin daha yüksek bir değerine güncelleştirin. bu üst bilgi olarak ayarlanırsa x-ms-sequence-number-actionincrementbelirtilmemelidir. Bu durumda hizmet, sıra numarasını otomatik olarak bir artırır.

Sıra numarasını seçtiğiniz bir değere ayarlamak için bu özelliğin istekte ile x-ms-sequence-number-actionbirlikte belirtilmesi gerekir.

İstek gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi içerir.

Durum kodu

Başarılı bir işlem 200 (Tamam) durum kodunu döndürür.

Durum kodları hakkında daha fazla bilgi için bkz. Durum ve hata kodları.

Yanıt üst bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Syntax Description
ETag İşlemleri koşullu olarak gerçekleştirmek için kullanabileceğiniz bir değer içerir. Daha fazla bilgi için bkz. Blob Depolama işlemleri için koşullu üst bilgileri belirtme . İstek sürümü 2011-08-18 veya üzeriyse, ETag değeri tırnak içine alınır.
Last-Modified Blob'un en son değiştirildiği tarih/saat. Tarih biçimi RFC 1123'e göredir. Daha fazla bilgi için bkz. Üst bilgilerde tarih/saat değerlerini temsil edin.

Blob üzerindeki herhangi bir yazma işlemi (blobun meta verileri veya özelliklerindeki güncelleştirmeler dahil) blobun son değiştirme zamanını değiştirir.
x-ms-blob-sequence-number Blob bir sayfa blobuysa, blob'un geçerli sıra numarası bu üst bilgiyle döndürülür.
x-ms-request-id Yapılan isteği benzersiz olarak tanımlar ve isteğin sorunlarını gidermek için kullanılabilir. Daha fazla bilgi için bkz . API işlemleriyle ilgili sorunları giderme.
x-ms-version İsteği yürütmek için kullanılan Blob Depolama sürümünü gösterir. Bu üst bilgi, 2009-09-19 ve sonraki sürümlerde yapılan istekler için döndürülür.
Date Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.
Access-Control-Allow-Origin İstek bir Origin üst bilgi içeriyorsa ve CORS eşleşen bir kuralla etkinleştirildiyse döndürülür. Eşleşme varsa, bu üst bilgi kaynak isteği üst bilgisinin değerini döndürür.
Access-Control-Expose-Headers İstek bir Origin üst bilgi içeriyorsa ve CORS eşleşen bir kuralla etkinleştirildiyse döndürülür. İsteğin istemcisine veya verene sunulacak yanıt üst bilgilerinin listesini döndürür.
Access-Control-Allow-Credentials İstek bir Origin üst bilgi içeriyorsa ve CORS tüm çıkış noktalarına izin vermeyecek bir eşleştirme kuralıyla etkinleştirildiyse döndürülür. Üst bilgi olarak trueayarlanır.
x-ms-client-request-id İsteklerde ve karşılık gelen yanıtlarda sorun gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa üst bilginin değerine x-ms-client-request-id eşittir. İstekte x-ms-client-request-id üst bilgi yoksa yanıtta bulunmaz.

Yanıt gövdesi

Yok.

Yetkilendirme

Azure Depolama'da herhangi bir veri erişim işlemi çağrılırken yetkilendirme gereklidir. İşlemi aşağıda açıklandığı gibi yetki Set Blob Properties verebilirsiniz.

Önemli

Microsoft, Azure Depolama'ya yönelik istekleri yetkilendirmek için yönetilen kimliklerle Microsoft Entra ID kullanılmasını önerir. Microsoft Entra ID, Paylaşılan Anahtar yetkilendirmesine kıyasla üstün güvenlik ve kullanım kolaylığı sağlar.

Azure Depolama, blob verilerine yönelik istekleri yetkilendirmek için Microsoft Entra ID kullanılmasını destekler. Microsoft Entra ID ile Azure rol tabanlı erişim denetimini (Azure RBAC) kullanarak bir güvenlik sorumlusuna izin vekleyebilirsiniz. Güvenlik sorumlusu bir kullanıcı, grup, uygulama hizmet sorumlusu veya Azure yönetilen kimliği olabilir. OAuth 2.0 belirtecini döndürmek için güvenlik sorumlusunun kimliği Microsoft Entra ID tarafından doğrulanır. Belirteç daha sonra Blob hizmetine karşı bir isteği yetkilendirmek için kullanılabilir.

Microsoft Entra ID kullanarak yetkilendirme hakkında daha fazla bilgi edinmek için bkz. Microsoft Entra ID kullanarak bloblara erişimi yetkilendirme.

İzinler

Aşağıda, Microsoft Entra kullanıcı, grup, yönetilen kimlik veya hizmet sorumlusunun işlemi çağırması Set Blob Properties için gereken RBAC eylemi ve bu eylemi içeren en az ayrıcalıklı yerleşik Azure RBAC rolü verilmiştir:

Azure RBAC kullanarak rol atama hakkında daha fazla bilgi edinmek için bkz. Blob verilerine erişim için Azure rolü atama.

Açıklamalar

Blob'un özelliklerini güncelleştirme semantiği aşağıdaki gibidir:

  • Sayfa blobunun sıra numarası yalnızca istek aşağıdaki koşullardan birini karşılıyorsa güncelleştirilir:

    • İstek veya updateolarak ayarlar x-ms-sequence-number-actionmax ve üst bilgi için x-ms-blob-sequence-number bir değer belirtir.

    • İstek, hizmetin sıra numarasını bir artırması gerektiğini belirten değerini olarak ayarlar x-ms-sequence-number-actionincrement.

  • Sayfa blobunun boyutu yalnızca istek üst bilgi için x-ms-content-length bir değer belirtiyorsa değiştirilir.

  • Premium depolama hesabında sayfa blobunun boyutunu değiştirmek için yeni boyutun mevcut katmanın izin verdiği içerik uzunluğunu aşmaması gerekir. Blobu yeniden boyutlandırmadan önce Blob KatmanıNı Ayarla'yı çağırın. Katmanların ve izin verilen içerik uzunluğunun listesi için bkz. VM'ler için yüksek performanslı premium depolama ve yönetilen diskler.

  • Bir istek yalnızca x-ms-blob-sequence-number veya x-ms-content-lengtholarak ayarlanırsa blobun diğer özelliklerinden hiçbiri değiştirilmez.

  • İstekte aşağıdaki özelliklerden biri veya daha fazlası ayarlanırsa, tüm özellikler birlikte ayarlanır. En az biri ayarlandığında bir özellik için değer sağlanmazsa, bu özellik blob için temizlenir.

    • x-ms-blob-cache-control
    • x-ms-blob-content-type
    • x-ms-blob-content-md5
    • x-ms-blob-content-encoding
    • x-ms-blob-content-language
    • x-ms-blob-content-disposition

Not

Paylaşılan erişim imzası (SAS) için, paylaşılan erişim imzasının bir parçası olarak sorgu parametrelerini belirterek blob için depolanan belirli özellikleri geçersiz kılabilirsiniz. Bu özellikler , , content-type, content-encodingcontent-languageve content-disposition özelliklerini içerircache-control. Daha fazla bilgi için bkz. hizmet SAS'sini İçerik Oluşturucu.

Faturalama

Fiyatlandırma istekleri, Blob Depolama API'lerini kullanan istemcilerden, doğrudan Blob Depolama REST API'si aracılığıyla veya bir Azure Depolama istemci kitaplığından kaynaklanabilir. Bu istekler işlem başına ücret tahakkuk eder. İşlem türü, hesabın ücretlendirilmeyi etkiler. Örneğin, okuma işlemleri yazma işlemlerinden farklı bir faturalama kategorisine tahakkuk eder. Aşağıdaki tabloda, depolama hesabı türüne göre istekler için Set Blob Properties faturalama kategorisi gösterilmektedir:

İşlem Depolama hesabı türü Faturalama kategorisi
Blob Özelliklerini Ayarlama Premium blok blobu
Standart genel amaçlı v2		 Diğer işlemler
Blob Özelliklerini Ayarlama Standart genel amaçlı v1 Yazma işlemleri

Belirtilen faturalama kategorisinin fiyatlandırması hakkında bilgi edinmek için bkz. fiyatlandırma Azure Blob Depolama.

Ayrıca bkz.