İkili Büyük Nesne Koyma

  • Makale

İşlem Put Blob yeni bir blok, sayfa veya ekleme blobu oluşturur ya da mevcut bir blok blobunun içeriğini güncelleştirir. İşlem, Put Blob aynı ada sahip mevcut bir blobun tüm içeriğinin üzerine yazar.

Mevcut bir blok blobunu güncelleştirdiğinizde, blobdaki mevcut meta verilerin üzerine yazarsınız. Mevcut blobun içeriğinin üzerine yeni blobun içeriği yazılır. Ile kısmi güncelleştirmeler desteklenmez Put Blob. Blok blobu içeriğinin kısmi güncelleştirmesini gerçekleştirmek için Blok Listesi Koy işlemini kullanın.

Yalnızca 2015-02-21 ve sonraki sürümlerde ekleme blobu oluşturabilirsiniz.

Put Blob Sayfa blobu veya ekleme blobu oluşturmak için çağrısı yalnızca blobu başlatır. Blob zaten varsa, içerik temizlenir. Sayfa blob'una içerik eklemek için Sayfa Koy işlemini çağırın. Ekleme blob'una içerik eklemek için Ekleme Bloğu işlemini çağırın.

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Put Blob . 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 HTTP/1.1

Öykünülmüş depolama hizmeti isteği

Öykünülen depolama hizmetine karşı istekte bulunulduğunda öykünücü konak adını ve Blob hizmeti 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 HTTP/1.1

Depolama öykünücüsü yalnızca 2 gibibayta (GiB) kadar blob boyutlarını destekler.

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 parametreler belirtilebilir:

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

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

Tüm blob türleri için gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştı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.
Content-Length Gereklidir. İsteğin uzunluğu.

Bir sayfa blobu veya ekleme blobu için bu üst bilginin değeri sıfır olarak ayarlanmalıdır, çünkü Blob Koy yalnızca blobu başlatmak için kullanılır. Var olan bir sayfa blob'una içerik yazmak için Sayfa Koy'u çağırabilirsiniz. Ekleme blob'una içerik yazmak için Ekleme Bloğu'na çağrı ekleyin.
Content-Type İsteğe bağlı. Blobun MIME içerik türü. Varsayılan tür şeklindedir application/octet-stream.
Content-Encoding İsteğe bağlı. Bloba hangi içerik kodlamalarının uygulandığını belirtir. Blob kaynağında Blob Al işlemi gerçekleştirildiğinde bu değer istemciye döndürülür. Bu değer döndürülürse, istemci blob içeriğinin kodunu çözmek için bunu kullanabilir.
Content-Language İsteğe bağlı. Bu kaynak tarafından kullanılan doğal dilleri belirtir.
Content-MD5 İsteğe bağlı. Blob içeriğinin MD5 karması. Bu karma, taşıma sırasında blobun bütünlüğünü doğrulamak için kullanılır. Bu üst bilgi belirtildiğinde, depolama hizmeti gönderilen karmaya göre gelen karmayı denetler. İki karma eşleşmezse işlem 400 (Hatalı İstek) hata koduyla başarısız olur.

Üst bilgi 2012-02-12 veya sonraki bir sürümde atlandığında, Blob Depolama bir MD5 karması oluşturur.

Blob Al, BlobÖzelliklerini Al ve Liste Bloblarından elde edilen sonuçlar MD5 karmasıdır.
x-ms-content-crc64 İsteğe bağlı. Blob içeriğinin CRC64 karması. Bu karma, taşıma sırasında blobun bütünlüğünü doğrulamak için kullanılır. Bu üst bilgi belirtildiğinde, depolama hizmeti gönderilen karmaya göre gelen karmayı denetler. İki karma eşleşmezse işlem 400 (Hatalı İstek) hata koduyla başarısız olur. Bu üst bilgi 02-02-2019 ve sonraki sürümlerde desteklenir.

Hem Content-MD5 hem de x-ms-content-crc64 üst bilgileri varsa, istek 400 (Hatalı İstek) ile başarısız olur.
Cache-Control İsteğe bağlı. Blob Depolama bu değeri depolar ancak kullanmaz veya değiştirmez.
x-ms-blob-content-type İsteğe bağlı. Blob'un içerik türünü ayarlayın.
x-ms-blob-content-encoding İsteğe bağlı. Blob'un içerik kodlamasını ayarlayın.
x-ms-blob-content-language İsteğe bağlı. Blob'un içerik dilini ayarlayın.
x-ms-blob-content-md5 İsteğe bağlı. Blob'un MD5 karması ayarlayın.
x-ms-blob-cache-control İsteğe bağlı. Blob'un önbellek denetimini ayarlar.
x-ms-blob-type: <BlockBlob ¦ PageBlob ¦ AppendBlob> Gereklidir. Oluşturulacak blob türünü belirtir: blok blobu, sayfa blobu veya ekleme blobu. Ekleme blobu oluşturma desteği yalnızca 2015-02-21 ve sonraki sürümlerde kullanılabilir.
x-ms-meta-name:value İsteğe bağlı. Blob ile meta veri olarak ilişkili ad-değer çiftleri.

Not: 2009-09-19 sürümünden itibaren meta veri adları C# tanımlayıcıları için adlandırma kurallarına uymalıdır.
x-ms-encryption-scope İsteğe bağlı. İstek içeriğini şifrelemek için kullanılacak şifreleme kapsamını gösterir. Bu üst bilgi 2019-02-02 ve sonraki sürümlerde desteklenir.
x-ms-encryption-context İsteğe bağlı. Varsayılan değer "Boş" şeklindedir. Değer ayarlanırsa blob sistemi meta verilerini ayarlar. Maksimum uzunluk-1024. Yalnızca hesap için Hiyerarşik Ad Alanı etkinleştirildiğinde geçerlidir. Bu üst bilgi 2021-08-06 ve sonraki sürümlerde desteklenir.
x-ms-tags İsteğe bağlı. Blob üzerinde verilen sorgu dizesi kodlanmış etiketlerini ayarlar. Ek bilgi için Bkz. Açıklamalar. Sürüm 2019-12-12 ve sonraki sürümlerde desteklenir.
x-ms-lease-id:<ID> Blob etkin bir kiraya sahipse gereklidir. Bu işlemi etkin kiralaması olan bir blob üzerinde gerçekleştirmek için bu üst bilgi için geçerli kira kimliğini belirtin.
x-ms-blob-content-disposition İsteğe bağlı. Blob Content-Disposition üst bilgisini ayarlar. 2013-08-15 ve sonraki sürümler 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 bunu kullanarak ek meta veriler ekleyebilirsiniz. Örneğin, üst bilgi olarak attachmentayarlanırsa, kullanıcı aracısının yanıtı görüntülememesi gerektiğini gösterir. Bunun yerine, belirtilen blob adı dışında bir dosya adıyla Farklı Kaydet iletişim kutusu görüntülemelidir.

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ı (CORS) üst bilgileriyle sonuçlanır. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için CORS desteği.
x-ms-client-request-id İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında analiz günlüklerine kaydedilen 1 kibibayt (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 . Depolama analizi günlüğü hakkında.
x-ms-access-tier İsteğe bağlı. Blobda ayarlanacak katman. Yalnızca sürüm 2017-04-17 ve üzeri olan bir Premium Depolama hesabındaki sayfa blobları için. Sayfa blobu destekli katmanların tam listesi için bkz. Sanal makineler (VM) için yüksek performanslı premium depolama ve yönetilen diskler. Blok blobları için, yalnızca 2018-11-09 ve sonraki sürümlerde blob depolama veya genel amaçlı v2 hesaplarında desteklenir. Blok blobu katmanları için geçerli değerler : Hot, Cool, Coldve Archive. Not: Cold katman 2021-12-02 ve sonraki sürümler için desteklenir. Blok blobu katmanlama hakkında ayrıntılı bilgi için bkz . Sık erişimli, seyrek erişimli ve arşiv depolama katmanları.
x-ms-immutability-policy-until-date Sürüm 2020-06-12 ve üzeri. Blobda ayarlanacak saklama tarihine kadar olan tarihi belirtir. Bu, blob'un değiştirilmeye veya silinmeye karşı korunabileceği tarihtir. RFC1123 biçimi izler.
x-ms-immutability-policy-mode Sürüm 2020-06-12 ve üzeri. Blobda ayarlanacak değiştirilemezlik ilkesi modunu belirtir. Geçerli değerler ve lockeddeğerleridirunlocked. ile unlockedkullanıcılar bekletme tarihine kadar olan saklama süresini artırarak veya azaltarak ilkeyi değiştirebilir. ile lockedbu eylemler yasaktır.
x-ms-legal-hold Sürüm 2020-06-12 ve üzeri. Blobda ayarlanacak yasal saklamayı belirtir. Geçerli değerler ve falsedeğerleridirtrue.
x-ms-expiry-option İsteğe bağlı. Sürüm 2023-08-03 ve üzeri. İstek için sona erme tarihi seçeneğini belirtir. Daha fazla bilgi için bkz . ExpiryOption. Bu üst bilgi hiyerarşik ad alanı etkinleştirilmiş hesaplar için geçerlidir.
x-ms-expiry-time İsteğe bağlı. Sürüm 2023-08-03 ve üzeri. Blob'un süresinin dolmak üzere ayarlandığı saati belirtir. Son kullanma tarihi biçimi'ne x-ms-expiry-optiongöre değişir. Daha fazla bilgi için bkz . ExpiryOption. Bu üst bilgi hiyerarşik ad alanı etkinleştirilmiş hesaplar için geçerlidir.

Bu işlem, yalnızca belirtilen bir koşul karşılandığında blob yazmak 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ı)

Yalnızca sayfa bloblarındaki işlemler için geçerli olan istek üst bilgileri aşağıdaki tabloda açıklanmıştır:

İstek üst bilgisi Açıklama
x-ms-blob-content-length: bytes Sayfa blobları için gereklidir. Bu üst bilgi, sayfa blobu için en fazla 8 tebibayt (TiB) boyutu belirtir. Sayfa blobu boyutu 512 baytlık bir sınıra hizalanmalıdır.

Bu üst bilgi bir blok blobu veya ekleme blobu için belirtilirse, Blob Depolama 400 (Hatalı İstek) durum kodunu döndürür.
x-ms-blob-sequence-number: <num> İsteğe bağlı. Yalnızca sayfa blobları için ayarlayın. Sıra numarası, istekleri izlemek için kullanabileceğiniz kullanıcı tarafından denetlenen bir değerdir. Sıra numarasının değeri 0 ile 2^63 - 1 arası olmalıdır. Varsayılan değer 0’dır.
x-ms-access-tier Sürüm 2017-04-17 ve üzeri. Yalnızca premium depolama hesabındaki sayfa blobları için. Blobda ayarlanacak katmanı belirtir. Desteklenen katmanların tam listesi için bkz. VM'ler için yüksek performanslı premium depolama ve yönetilen diskler.
x-ms-client-request-id Bu üst bilgi, isteklerde ve ilgili 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.

İstek üst bilgileri (müşteri tarafından sağlanan şifreleme anahtarları)

2019-02-02 sürümünden itibaren, müşteri tarafından sağlanan bir anahtarla bir blobu şifreleme isteğinde aşağıdaki üst bilgiler belirtilebilir. Müşteri tarafından sağlanan anahtarla (ve ilgili üst bilgi kümesiyle) şifreleme isteğe bağlıdır.

İstek üst bilgisi Açıklama
x-ms-encryption-key Gereklidir. Base64 kodlamalı AES-256 şifreleme anahtarı.
x-ms-encryption-key-sha256 Gereklidir. Şifreleme anahtarının Base64 kodlamalı SHA256 karması.
x-ms-encryption-algorithm: AES256 Gereklidir. Şifreleme için kullanılacak algoritmayı belirtir. Bu üst bilginin değeri olmalıdır AES256.

İstek gövdesi

Blok blobu için istek gövdesi blobun içeriğini içerir.

Sayfa blobu veya ekleme blobu için istek gövdesi boş olur.

Örnek istek

Aşağıdaki örnekte blok blobu oluşturma isteği gösterilmektedir:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblockblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-content-disposition: attachment; filename="fname.ext"  
x-ms-blob-type: BlockBlob  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 11  
  
Request Body:  
hello world

Bu örnek istek bir sayfa blobu oluşturur ve en büyük boyutunu 1.024 bayt olarak belirtir. Sayfa blob'una içerik eklemek için Sayfa Koy'u çağırmanız gerekir:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/mypageblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: PageBlob  
x-ms-blob-content-length: 1024  
x-ms-blob-sequence-number: 0  
Authorization: SharedKey   
Origin: http://contoso.com  
Vary: Origin  
myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 0

Bu örnek istek bir ekleme blobu oluşturur. Ekleme blob'una içerik eklemek için Ekleme Bloğunu çağırmanız gerekir:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myappendblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: AppendBlob  
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Origin: http://contoso.com  
Vary: Origin  
Content-Length: 0

Yanıt

Yanıt bir HTTP durum kodu ve yanıt üst bilgileri kümesi içerir.

Durum kodu

Başarılı bir işlem 201 (Oluşturuldu) 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.

Yanıt üst bilgisi Description
ETag İstemcinin istek üst bilgisini kullanarak If-Match koşullu PUT işlemler gerçekleştirmek için kullanabileceği bir değer içerir. İ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.
Content-MD5 İstemcinin ileti içeriğinin bütünlüğünü denetleyebilmesi için blok blobu için döndürülür. Döndürülen Content-MD5 değer Blob Depolama tarafından hesaplanır. 2012-02-12 ve sonraki sürümlerde, istek veya x-ms-blob-content-md5 üst bilgileri içermese Content-MD5 bile bu üst bilgi döndürülür.
x-ms-content-crc64 İstemcinin ileti içeriğinin bütünlüğünü denetleyebilmesi için blok blobu için döndürüldü. Döndürülen x-ms-content-crc64 değer Blob Depolama tarafından hesaplanır. Bu üst bilgi her zaman 2019-02-02 sürümünden itibaren 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 bunu kullanabilirsiniz. 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. 2009-09-19 ve sonraki sürümlerde yapılan istekler için döndürüldü.
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. Bu üst bilgi, eşleşme varsa 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. Bu üst bilgi true olarak ayarlanmıştır.
x-ms-request-server-encrypted: true/false Sürüm 2015-12-11 ve üzeri. İsteğin içeriği belirtilen algoritma kullanılarak başarıyla şifrelenirse bu üst bilginin değeri olarak ayarlanır true . Aksi takdirde, değeri olur false.
x-ms-encryption-key-sha256 Sürüm 2019-02-02 ve üzeri. İstek şifreleme için müşteri tarafından sağlanan bir anahtar kullandıysa döndürülür; böylece istemci, isteğin içeriğinin sağlanan anahtar kullanılarak başarıyla şifrelenmesini sağlayabilir.
x-ms-encryption-scope Sürüm 2019-02-02 ve üzeri. İstek bir şifreleme kapsamı kullandıysa döndürülür; böylece istemci, isteğin içeriğinin şifreleme kapsamı kullanılarak başarıyla şifrelenmesini sağlayabilir.
x-ms-version-id: <DateTime> Sürüm 2019-12-12 ve üzeri. Bu üst bilgi, blobu benzersiz olarak tanımlayan opak DateTime bir değer döndürür. Bu üst bilginin değeri blobun sürümünü gösterir ve bloba erişmek için sonraki isteklerde kullanılabilir.

Yanıt gövdesi

Yok.

Örnek yanıt

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-MD5: sQqNsWTgdUEFt6mb5y4/5Q==  
x-ms-content-crc64: 77uWZTolTHU
Date: <date>  
ETag: "0x8CB171BA9E94B0B"  
Last-Modified: <date>  
Access-Control-Allow-Origin: http://contoso.com  
Access-Control-Expose-Headers: Content-MD5  
Access-Control-Allow-Credentials: True  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-version-id: <DateTime>

Yetkilendirme

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

bir istek, istek üst bilgisine x-ms-tags sahip etiketleri belirtirse, çağıranın Blob Etiketlerini Ayarla işleminin yetkilendirme gereksinimlerini karşılaması gerekir.

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 güvenlik sorumlusuna izinler verilmektedir. Güvenlik sorumlusu bir kullanıcı, grup, uygulama hizmet sorumlusu veya Azure yönetilen kimliği olabilir. Güvenlik sorumlusunun kimliği, OAuth 2.0 belirtecini döndürmek için 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 veya hizmet sorumlusunun işlemi çağırması Put Blob 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 oluşturduğunuzda, üst bilginin değerini belirterek blobun blok blobu mu, ekleme blobu mu yoksa sayfa blobu x-ms-blob-type mu olduğunu belirtmeniz gerekir. Bir blob oluşturulduktan sonra, blobun türü silinip yeniden oluşturulmadığı sürece değiştirilemez.

Aşağıdaki tabloda hizmet sürümüne göre izin verilen en fazla blok ve blob boyutu açıklanmaktadır:

Hizmet sürümü En büyük blok boyutu (aracılığıyla Put Block) Maksimum blob boyutu (aracılığıyla Put Block List) Tek yazma işlemi aracılığıyla maksimum blob boyutu (aracılığıyla Put Blob)
Sürüm 2019-12-12 ve üzeri 4.000 mebibayt (MiB) Yaklaşık 190,7 TiB (4.000 MiB × 50.000 blok) 5.000 MiB
Sürüm 2016-05-31 - 2019-07-07 100 MiB Yaklaşık 4,75 TiB (100 MiB × 50.000 blok) 256 MiB
2016-05-31'den önceki sürümler 4 MiB Yaklaşık 195 GiB (4 MiB × 50.000 blok) 64 MiB

Bu hizmet sürümü için izin verilen en büyük boyuttan büyük bir blok blobunu veya 8 TiB'den büyük bir sayfa blobunu karşıya yüklemeye çalışırsanız, hizmet 413 durum kodunu (İstek Varlığı Çok Büyük) döndürür. Blob Depolama ayrıca bayt cinsinden izin verilen blob boyutu üst sınırı da dahil olmak üzere yanıttaki hata hakkında ek bilgiler döndürür.

Yeni bir sayfa blobu oluşturmak için önce çağrısı Put Blobyaparak blobu başlatın ve ardından en fazla 8 TiB boyutu belirtin. Sayfa blobu oluştururken istek gövdesine içerik eklemeyin. Blob oluşturulduktan sonra bloba içerik eklemek veya blobu değiştirmek için Sayfa Koy'u çağırın.

Yeni bir ekleme blobu oluşturmak için 0 bayt içerik uzunluğuyla oluşturmak üzere çağrısında Put Blob bulunur. Ekleme blobu oluşturulduktan sonra sonuna içerik eklemek için Ekleme Bloğunu çağırın.

Aynı ada sahip mevcut bir blob'un üzerine yazmayı çağırırsanız Put Blob , özgün blobla ilişkilendirilmiş tüm anlık görüntüler korunur. İlişkili anlık görüntüleri kaldırmak için önce Delete Blob'u çağırın ve ardından blobu yeniden oluşturmak için çağrısı Put Blob yapın.

Blob özel özellikleri

Blob, standart HTTP üst bilgileriyle ilişkili değerleri depolamak için kullanabileceğiniz özel özelliklere (üst bilgiler aracılığıyla ayarlanır) sahiptir. Bu değerleri daha sonra Blob Özelliklerini Al'ı çağırarak okuyabilir veya Blob Özelliklerini Ayarla'yı çağırarak değiştirebilirsiniz. Özel özellik üst bilgileri ve buna karşılık gelen standart HTTP üst bilgileri aşağıdaki tabloda listelenmiştir:

HTTP üst bilgisi Özel blob özellik üst bilgisi
Content-Type x-ms-blob-content-type
Content-Encoding x-ms-blob-content-encoding
Content-Language x-ms-blob-content-language
Content-MD5 x-ms-blob-content-md5
Cache-Control x-ms-blob-cache-control

Blob ile bu özellik değerlerini ayarlama veya kalıcı hale ekleme semantiği aşağıdaki gibidir:

  • İstemci ön ekte gösterildiği x-ms-blob gibi özel bir özellik üst bilgisi belirtirse, bu değer blob ile birlikte depolanır.

  • İstemci standart bir HTTP üst bilgisi belirtiyorsa ancak özel özellik üst bilgisini belirtmiyorsa, değer blob ile ilişkili ilgili özel özellikte depolanır ve çağrısı Get Blob Propertiestarafından döndürülür. Örneğin, istemci istekte Content-Type üst bilgiyi ayarlarsa, bu değer blob'un x-ms-blob-content-type özelliğinde depolanır.

  • İstemci aynı istekte hem standart HTTP üst bilgisini hem de buna karşılık gelen özellik üst bilgisini ayarlarsa, PUT isteği standart HTTP üst bilgisi için sağlanan değeri kullanır, ancak özel özellik üst bilgisi için belirtilen değer blob ile kalıcı hale getirilir ve sonraki GET istekleri tarafından döndürülür.

Etiketler üst bilgide x-ms-tags sağlanıyorsa, bunların sorgu dizesi kodlanmış olması gerekir. Etiket anahtarları ve değerleri, içinde Set Blob Tagsbelirtilen adlandırma ve uzunluk gereksinimlerine uygun olmalıdır. Ayrıca, x-ms-tags üst bilgi en fazla 2 kb etiket içerebilir. Daha fazla etiket gerekiyorsa Blob Etiketlerini Ayarla işlemini kullanın.

Blob etkin bir kiraya sahipse, istemcinin blob üzerine yazmak için istekte geçerli bir kira kimliği belirtmesi gerekir. İstemci bir kira kimliği belirtmezse veya geçersiz bir kira kimliği belirtirse, Blob Depolama 412 (Önkoşul Başarısız) durum kodunu döndürür. İstemci bir kira kimliği belirtiyorsa ancak blob etkin bir kiraya sahip değilse, Blob Depolama 412 durum kodunu da döndürür (Önkoşul Başarısız oldu). İstemci henüz var olmayan bir blob üzerinde kira kimliği belirtirse, Blob Depolama sürüm 2013-08-15 ve sonraki sürümlerde yapılan istekler için 412 (Önkoşul Başarısız) durum kodunu döndürür. 2013-08-15'ten önceki sürümler için Blob Depolama, 201 (Oluşturuldu) durum kodunu döndürür.

Etkin kirası olan bir bloba işlem Put Blob tarafından üzerine yazılırsa, kira süresi dolana veya serbest bırakılana kadar güncelleştirilmiş blobda kalır.

İşlemin Put Blob tamamlanması için MiB başına 10 dakika izin verilir. İşlem MiB başına ortalama 10 dakikadan uzun sürüyorsa işlem zaman aşımına uysa.

Blob archive üzerine yazma işlemi başarısız olur ve bir hot veya cool blobunun üzerine yazmak, üst bilgi sağlanmazsa katmanı eski blobdan x-ms-access-tier devralır.

Süre SonuSeçenek

Aşağıdaki değerleri üst x-ms-expiry-option bilgi olarak gönderebilirsiniz. Bu üst bilgi büyük/küçük harfe duyarlı değildir.

Süre sonu seçeneği Description
RelativeToNow Son kullanma tarihini geçerli saate göre ayarlar. x-ms-expiry-time şu anda geçmesi gereken milisaniye sayısı olarak belirtilmelidir.
Absolute x-ms-expiry-time rfc 1123 biçiminde mutlak saat olarak belirtilmelidir.
NeverExpire Blobu hiçbir zaman sona ermeyecek şekilde ayarlar veya geçerli son kullanma tarihini kaldırır. x-ms-expiry-time belirtilmemiş olmalıdır.

Blobda son kullanma tarihi ayarlama semantiği aşağıdaki gibidir:

  • Set Expiry yalnızca bir blob üzerinde ayarlanabilir ve dizinde ayarlanamaz.
  • Set ExpiryexpiryTime ile geçmişe izin verilmez.
  • ExpiryTime değeriyle expiryOptionNeverbelirtilemiyor.

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 nasıl ücretlendirildiğinden etkilenir. Ö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 Put Blob faturalama kategorisi gösterilmektedir:

İşlem Depolama hesabı türü Faturalama kategorisi
İkili Büyük Nesne Koyma Premium blok blobu
Standart genel amaçlı v2
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.

Azure Depolama'ya yönelik istekleri yetkilendirme
Durum ve hata kodları
Blob hizmeti hata kodları
Blob hizmeti işlemleri için zaman aşımlarını ayarlama