Blob'u Sil

İşlem Delete Blob belirtilen blobu veya anlık görüntüyü siler.

Blobu silmek için tüm anlık görüntülerini silmeniz gerektiğini unutmayın. İşlem ile Delete Blob ikisini aynı anda silebilirsiniz.

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Delete Blob . HTTPS önerilir. myaccount değerini depolama hesabınızın adıyla değiştirin.

DELETE yöntemi istek URI'si	HTTP sürümü
`https://myaccount.blob.core.windows.net/mycontainer/myblob` `https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>` `https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>`	HTTP/1.1

Öykünülmüş depolama hizmeti URI'si

Öykünülmüş depolama hizmetine yönelik bir istekte bulunduğunuzda, öykünücü ana bilgisayar adını ve Azure Blob Depolama bağlantı noktasını ve ardından öykünülen depolama hesabı adını olarak 127.0.0.1:10000belirtin.

DELETE yöntemi istek URI'si	HTTP sürümü
`http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob`	HTTP/1.1

Daha fazla bilgi için bkz.

URI parametreleri

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

Parametre	Description
`snapshot`	Optional. snapshot parametresi, mevcut olduğunda silinecek blob anlık görüntüsünü belirten opak `DateTime` bir değerdir. Blob anlık görüntüleriyle çalışma hakkında daha fazla bilgi için bkz.
`versionid`	İsteğe bağlı, sürüm 2019-12-12 ve üzeri. parametresi `versionid` , mevcut olduğunda silinecek blob sürümünü belirten opak `DateTime` bir değerdir.
`timeout`	Optional. Parametre `timeout` saniye cinsinden ifade edilir. Daha fazla bilgi için bkz: Blob Depolama işlemleri için zaman aşımlarını ayarlama.
`deletetype`	İsteğe bağlı, sürüm 2020-02-10 veya üzeri. Değeri `deletetype` sadece .`permanent`

İstek başlıkları

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.

İstek başlığı	Description
`Authorization`	Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz.
`Date` veya `x-ms-date`	Gerekli. İstek için Eşgüdümlü Evrensel Saat'i (UTC) belirtir. Daha fazla bilgi için bkz.
`x-ms-version`	Tüm yetkili talepler için gereklidir. Daha fazla bilgi için bkz.
`x-ms-lease-id:<ID>`	Blob etkin bir kiraya sahipse gereklidir. Bu işlemi etkin kirası olan bir blobda gerçekleştirmek için bu üst bilgi için geçerli kira kimliğini belirtin. İstekte bu üst bilgi belirtilmezse Blob Depolama 412 (`LeaseIdMissing`, Önkoşul Başarısız) durum kodunu döndürür. İstekte yanlış biçimlendirilmiş bir kira kimliği belirtilirse, işlem 400 (`InvalidHeaderValue`, Hatalı İstek) durum koduyla başarısız olur. Düzgün biçimlendirilmiş bir kira kimliği belirtilirse ancak belirtilen kira kimliği blobla ilişkilendirilmemişse, işlem 412 (`LeaseIdMismatchWithBlobOperation`, Önkoşul Başarısız) durum koduyla başarısız olur
`x-ms-delete-snapshots: {include, only}`	Blob ilişkili anlık görüntülere sahipse gereklidir. Aşağıdaki seçeneklerden birini belirleyin: - `include`: Temel blobu ve tüm anlık görüntülerini silin. - `only`: Blobun kendisini değil, yalnızca blobun anlık görüntülerini silin. Bu üst bilgiyi yalnızca temel blob kaynağına yönelik bir istek için belirtin. Tek bir anlık görüntüyü silme isteğinde bu üst bilgi belirtilirse Blob Depolama 400 (Hatalı İstek) durum kodunu döndürür. İstekte bu üst bilgi belirtilmezse ve blobun ilişkili anlık görüntüleri varsa, Blob Depolama 409 (Çakışma) durum kodunu döndürür.
`x-ms-client-request-id`	Optional. Günlük kaydı yapılandırıldığında günlüklere kaydedilen 1 kibibayt (KiB) karakter sınırına sahip istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinliklerini sunucunun aldığı isteklerle ilişkilendirmek için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz.
`x-ms-access-tier-if-modified-since`	Optional. 2025-05-05 ve sonrası sürümler. Bu başlığı, yalnızca blobun erişim seviyesi belirlenen zamandan beri değiştirilmişse işlemi yapması için belirtin. Değer RFC 1123 formatında `DateTime` ve ona göre geçerlidir. Daha fazla bilgi için, başlıklarda tarih-saat değerlerinin temsili bölümüne bakınız.
`x-ms-access-tier-if-unmodified-since`	Optional. 2025-05-05 ve sonrası sürümler. Bu başlığı, yalnızca blobun erişim seviyesi belirlenen zamandan beri değiştirilmemişse işlemi yapması için belirtin. Değer RFC 1123 formatında `DateTime` ve ona göre geçerlidir. Daha fazla bilgi için, başlıklarda tarih-saat değerlerinin temsili bkz.

Bu işlem, yalnızca belirtilen koşul karşılandığında blobu silmek 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 içeriği

Yok.

Yanıt

Yanıt, bir HTTP durum kodu ve bir dizi yanıt başlığı içerir.

Durum kodu

Başarılı bir işlem 202 (Kabul Edildi) durum kodunu döndürür. Durum kodları hakkında bilgi için bkz: Durum ve hata kodları.

Yanıt başlıkları

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

Yanıt başlığı	Description
`x-ms-request-id`	Bu üst bilgi, yapılan isteği benzersiz olarak tanımlar ve istekte sorun gidermek için kullanılabilir. Daha fazla bilgi için API işlemlerinde sorun giderme başlıklı makaleyi inceleyin.
`x-ms-version`	İsteği çalıştırmak için kullanılan Blob Depolama sürümünü gösterir. Bu üst bilgi, 2009-09-19 ve sonraki sürümlere karşı yapılan istekler için döndürülür.
`x-ms-delete-type-permanent`	Sürüm 2017-07-29 ve üzeri için Blob Depolama, blob kalıcı olarak silinmişse ve `true` blob geçici olarak silinmişse döndürür`false`.
`Date`	Yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri. Hizmet bu değeri oluşturur.
`x-ms-client-request-id`	İsteklerde ve ilgili yanıtlarda sorun gidermek için bu başlığı kullanabilirsiniz. Bu üst bilginin değeri, istekte varsa üst bilginin değerine `x-ms-client-request-id` eşittir. Değer en fazla 1.024 görünür ASCII karakteridir. `x-ms-client-request-id` Üst bilgi istekte yoksa, bu üst bilgi yanıtta mevcut olmaz.

Authorization

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

Önemli

Microsoft, Azure Depolama isteklerini yetkilendirmek için yönetilen kimliklerle Microsoft Entra Id kullanılmasını önerir. Microsoft Entra ID, Shared Key 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 bir güvenlik sorumlusuna izin vermek için Azure rol tabanlı erişim denetimini (Azure RBAC) kullanabilirsiniz. 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. Daha sonra belirteç, 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.

Permissions

Bir Microsoft Entra kullanıcısının, grubunun, yönetilen kimliğinin veya hizmet sorumlusunun işlemi çağırması için gereken RBAC eylemi Delete Blob ve bu eylemi içeren en az ayrıcalıklı yerleşik Azure RBAC rolü aşağıda listelenmiştir:

Azure RBAC eylemi:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/delete
En az ayrıcalıklı yerleşik rol:Depolama Blob Veri Katkıda Bulunanı

Azure RBAC kullanarak rol atama hakkında daha fazla bilgi edinmek için bkz.

Paylaşılan erişim imzası (SAS), depolama hesabındaki kaynaklara güvenli temsilci erişimi sağlar. SAS ile istemcinin verilere nasıl erişebileceği üzerinde ayrıntılı denetime sahip olursunuz. İstemcinin hangi kaynağa erişebileceğini, bu kaynaklar üzerinde hangi izinlere sahip olduğunu ve SAS'nin ne kadar süreyle geçerli olacağını belirtebilirsiniz.

İşlem Delete Blob üç tür paylaşılan erişim imzasını destekler: kullanıcı temsilcisi SAS'si, hizmet SAS'ı ve hesap SAS'si.

En iyi güvenlik uygulaması olarak, güvenliği daha kolay aşılabilir depolama hesabı anahtarı yerine Microsoft Entra kimlik bilgilerini kullanmanızı öneririz. Uygulama tasarımınız paylaşılan erişim imzaları gerektiriyorsa, mümkün olduğunda kullanıcı temsilcisi SAS'si oluşturmak için Microsoft Entra kimlik bilgilerini kullanın.

Depolama hesabı için Paylaşılan Anahtar erişimine izin verilmediğinde, Blob Depolama isteğinde hizmet SAS belirtecine veya hesap SAS belirtecine izin verilmez. Daha fazla bilgi edinmek için Paylaşılan Anahtara izin vermemenin SAS belirteçlerini nasıl etkilediğini anlama bölümüne bakın.

Kullanıcı temsilcisi SAS

Kullanıcı temsilcisi SAS'sinin güvenliği Microsoft Entra kimlik bilgileriyle ve ayrıca SAS için belirtilen izinlerle sağlanır.

Kapsayıcıya veya blob kaynağına temsilci olarak atanan bir SAS belirteci kullanarak işlemi çağırmak Delete Blob , kullanıcı temsilcisi SAS belirtecinin bir parçası olarak Sil (d) iznini gerektirir.

Kullanıcı temsilcisi SAS'si hakkında daha fazla bilgi edinmek için bkz: Kullanıcı temsilcisi SAS'si oluşturma.

Hizmet SAS

Bir hizmet SAS'sinin güvenliği depolama hesabı anahtarıyla sağlanır. Hizmet SAS'si, blob depolama gibi tek bir Azure Depolama hizmetindeki bir kaynağa erişim yetkisi verir.

Kapsayıcıya Delete Blob veya blob kaynağına temsilci olarak atanan bir SAS belirteci kullanarak işlemi çağırmak, hizmet SAS belirtecinin bir parçası olarak Sil (d) iznini gerektirir.

Hizmet SAS'si hakkında daha fazla bilgi edinmek için bkz: Hizmet SAS'ı oluşturma.

Hesap SAS'i

Hesap SAS'sinin güvenliği depolama hesabı anahtarıyla sağlanır. Hesap SAS ise bir veya daha fazla depolama hizmetindeki kaynaklara erişim atar. Bir hizmet veya kullanıcı temsilcisi SAS'si aracılığıyla kullanılabilen tüm işlemler bir hesap SAS'si aracılığıyla da kullanılabilir.

Aşağıdaki tabloda, erişim temsilcisi seçerken belirtilmesi gereken imzalı kaynak türü ve imzalı izinler gösterilmektedir:

Operation	İmzalı hizmet	İmzalı kaynak türü	İmzalı izin
Blob'u Sil	Kabarcık (b)	Nesne (o)	Sil (d)

Hesap SAS'si hakkında daha fazla bilgi edinmek için bkz: Hesap SAS'si oluşturma.

Açıklamalar

Blobun etkin bir kirası varsa, istemcinin isteği silmek için istekte geçerli bir kira kimliği belirtmesi gerekir.

Blobun çok sayıda anlık görüntüsü varsa, işlemin zaman aşımına Delete Blob uğraması mümkündür. Bu durumda, istemcinin isteği yeniden denemesi gerekir.

Sürüm 2013-08-15 ve üzeri için istemci, kaydedilmemiş blobları silmek için çağrı Delete Blob yapabilir. Kaydedilmemiş blob, Put Block işlemine yapılan çağrılarla oluşturulmuş, ancak işlem kullanılarak hiçbir zaman Put Block List işlenmemiş bir blobdur. Önceki sürümlerde, istemcinin blobu silmeden önce işlemesi gerekir.

Access Tier Koşullu Başlıklar

2025-05-05 ve sonrasında olan sürümler için istemciler istek başlıklarını x-ms-access-tier-if-modified-since kullanabilir veya x-ms-access-tier-if-unmodified-since erişim katmanındaki değişikliklere göre bir blobu koşullu olarak silebilir.

Get Blob Properties tarafından döndürülen yanıt başlığıx-ms-access-tier-change-time, blobun erişim katmanının en son ne zaman değiştirildiğini gösterir. Bu zaman damgası, yukarıdaki koşulların değerlendirilmesi için kullanılır.

DeleteBlob API, bir istekte hem Last-Modified-Time hem de Access-Tier-Change-Time koşullu başlıkların belirtilmesine olanak tanır. Her iki koşul da belirtilmişse, Blob servisi mantıksal bir AND işlemiyle koşulları değerlendirir; yani talebin başarılı olması için her iki koşulun da doğru olması gerekir.

Geçici silme özelliği devre dışı bırakıldı

Blob başarıyla silindiğinde, depolama hesabının dizininden hemen kaldırılır ve artık istemciler tarafından erişilemez.

Geçici silme özelliği etkin

Blob başarıyla silindiğinde geçici olarak silinir ve artık istemciler tarafından erişilemez. Blob Depolama, Blob Depolama özelliği için DeleteRetentionPolicy belirtilen gün sayısı boyunca blobu veya anlık görüntüyü korur. Blob Depolama özelliklerini okuma hakkında bilgi için bkz.

Belirtilen gün sayısından sonra blob verileri hizmetten kaldırılır. Blobları Listele işlemini çağırarak ve seçeneği belirterek geçici olarak silinen bloba veya anlık görüntüye include=deleted erişebilirsiniz.

Geçici olarak silinen blobları veya anlık görüntüleri Geri Alma Blobu'nu kullanarak geri yükleyebilirsiniz. Geçici olarak silinen bloblar veya anlık görüntüler üzerindeki diğer tüm işlemler için Blob Depolama 404 (Kaynak Bulunamadı) hatasını döndürür.

Kalıcı olarak silme

Sürüm 2020-02-10 ve üzerinde, geçici olarak silinen bir anlık görüntüyü veya sürümü kalıcı olarak silebilirsiniz. Bunu yapmak için özelliği etkinleştirirsiniz. Daha fazla bilgi için bkz.

Uyarı

Depolama hesabında sürüm oluşturma veya anlık görüntüler etkinleştirilmiş olmalıdır. Hesaptaki blobların sürümlerini veya anlık görüntülerini geçici olarak silmek için depolama hesabında geçici silme etkinleştirilmelidir. Kalıcı silme yalnızca geçici olarak silinen anlık görüntüleri veya sürümleri siler.

Kalıcı silme özelliği etkinleştirilmiş depolama hesapları, deletetype=permanent geçici olarak silinen anlık görüntüyü veya silinen blob sürümünü kalıcı olarak silmek için sorgu parametresini kullanabilir.

Sorgu parametresi aşağıdakilerden herhangi birini sunuyorsa Blob Depolama 409 hatası (Çakışma) döndürür:

Depolama hesabı için kalıcı silme özelliği etkinleştirilmedi.
Ne sağlanır ne versionid de snapshot sağlanır.
Belirtilen anlık görüntü veya sürüm geçici olarak silinmez.

Kalıcı silme, blob anlık görüntüsünü veya blob sürümünü kalıcı olarak silmek için paylaşılan erişim imzası iznini de içerir. Daha fazla bilgi için bkz: Hizmet SAS'ı oluşturma.