İkili Büyük Nesneyi Silme

Makale
05/22/2024

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

Bir blobu silmek için tüm anlık görüntülerini silmeniz gerektiğini unutmayın. İşlemle Delete Blob ikisini de 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ünmüş depolama hizmeti URI'si

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

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 . 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
`snapshot`	İsteğe bağlı. 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. Blobun anlık görüntüsünü oluşturma.
`versionid`	İsteğe bağlı, sürüm 2019-12-12 ve üzeri. `versionid` parametresi, mevcut olduğunda silinecek blobun sürümünü belirten opak `DateTime` bir değerdir.
`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.
`deletetype`	İsteğe bağlı, sürüm 2020-02-10 veya üzeri. değeri `deletetype` yalnızca olabilir `permanent`.

İstek üst bilgileri

Aşağıdaki tabloda 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. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
`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. İstekte geçerli bir kira kimliği belirtilmezse işlem 403 (Yasak) durum koduyla başarısız olur.
`x-ms-delete-snapshots: {include, only}`	Blobda ilişkili anlık görüntüler varsa gereklidir. Aşağıdaki seçeneklerden birini belirtin: - `include`: Temel blobu ve tüm anlık görüntülerini silin. - `only`: Yalnızca blob'un anlık görüntülerini silin, blobu silin. Bu üst bilgiyi yalnızca temel blob kaynağına yönelik bir istek için belirtin. Bu üst bilgi tek bir anlık görüntüyü silme isteğinde belirtilirse, Blob Depolama 400 (Hatalı İstek) durum kodunu döndürür. bu üst bilgi istekte belirtilmezse ve blob ilişkili anlık görüntülere sahipse, Blob Depolama 409 (Çakışma) durum kodunu döndürür.
`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.

Bu işlem, yalnızca belirtilen bir 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 gövdesi

Yok.

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 202 (Kabul Edildi) durum kodunu döndürür. Durum kodları hakkında 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
`x-ms-request-id`	Bu üst bilgi, 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 ç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ümlerde yapılan istekler için döndürülür.
`x-ms-delete-type-permanent`	2017-07-29 ve sonraki sürümler için blob kalıcı olarak silinmişse ve `false` blob geçici olarak silinmişse Blob Depolama döndürür`true`.
`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`	İstekler ve karşılık gelen yanıtlarla ilgili sorunları gidermek için bu üst bilgiyi 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 karakterdir. `x-ms-client-request-id` Üst bilgi istekte yoksa, yanıtta bu üst bilgi bulunmaz.

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 Delete Blob 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 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, yönetilen kimlik veya hizmet sorumlusunun işlemi çağırması Delete 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 eylemi:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/delete
En az ayrıcalıklı yerleşik rol:Depolama Blob Verileri Katkıda Bulunanı

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

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 sahipsiniz. İstemcinin erişebileceği kaynağı, bu kaynaklara hangi izinlere sahip olduğunu ve SAS'nin ne kadar süre geçerli olduğunu belirtebilirsiniz.

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

En iyi güvenlik uygulaması olarak, daha kolay ele geçirilebilen 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 Microsoft Entra kimlik bilgilerini kullanarak kullanıcı temsilcisi SAS oluşturun.

Depolama hesabı için Paylaşılan Anahtar erişimine izin verilmediğinde, Blob Depolama isteğinde hizmet SAS belirteci veya hesap SAS belirteci kullanılamaz. Daha fazla bilgi edinmek için bkz. Paylaşılan Anahtara izin vermenin SAS belirteçlerini nasıl etkilediğini anlama.

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.

Delete Blob Kapsayıcı veya blob kaynağına temsilci olarak atanan bir SAS belirtecini kullanarak işlemi çağırmak için kullanıcı temsilcisi SAS belirtecinin bir parçası olarak Silme (d) izni gerekir.

Kullanıcı temsilcisi SAS hakkında daha fazla bilgi edinmek için bkz. Kullanıcı temsilcisi SAS İçerik Oluşturucu.

Hizmet SAS'i

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

Delete Blob Kapsayıcı veya blob kaynağına temsilci olarak atanan SAS belirtecini kullanarak işlemi çağırmak için hizmet SAS belirtecinin bir parçası olarak Silme (d) izni gerekir.

Hizmet SAS'i hakkında daha fazla bilgi edinmek için bkz. Hizmet SAS'sini İçerik Oluşturucu.

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 aracılığıyla kullanılabilen tüm işlemler, hesap SAS'sı aracılığıyla da kullanılabilir.

Aşağıdaki tabloda, erişim için temsilci seçme sırasında belirtilmesi gereken imzalı kaynak türü ve imzalı izinler gösterilir:

İşlem	İmzalı hizmet	İmzalı kaynak türü	İmzalı izin
İkili Büyük Nesneyi Silme	Blob (b)	Nesne (o)	Sil (d)

Hesap SAS'i hakkında daha fazla bilgi edinmek için bkz. Hesap SAS'sini İçerik Oluşturucu.

Açıklamalar

Blob etkin bir kiraya sahipse, 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şlem zaman aşımına Delete Blob uyacaktır. Bu durumda istemcinin isteği yeniden denemesi gerekir.

2013-08-15 ve sonraki sürümler için istemci, kaydedilmemiş blobları silmek için çağrısı Delete Blob yapabilir. Kaydedilmemiş blob, Blok Koy işlemine yapılan çağrılarla oluşturulmuş ancak Hiçbir zaman Blok Listesi Koy işlemi kullanılarak işlenmeyen bir blobdur. Önceki sürümler için, istemcinin silmeden önce blobu işlemesi gerekir.

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

Bir 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

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

Belirtilen gün sayısından sonra blobun verileri hizmetten kaldırılır. Geçici olarak silinen bloba veya anlık görüntüye erişmek için Blobları Listele işlemini çağırabilir ve seçeneğini belirtebilirsiniz include=deleted .

Geçici olarak silinen blobları veya anlık görüntüleri Geri Alma Blobu'yu kullanarak geri yükleyebilirsiniz. Geçici olarak silinen bloblar veya anlık görüntülerdeki diğer 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 üzeri ile geçici olarak silinen 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. Blob Depolama özelliklerini ayarlama.

Not

Depolama hesabında sürüm oluşturma veya anlık görüntüler etkinleştirilmelidir. Geçici silme, hesaptaki blobların sürümlerini veya anlık görüntülerini geçici olarak silmek için depolama hesabında da 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 etkin olan depolama hesapları, 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 deletetype=permanent .

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

Kalıcı silme özelliği depolama hesabı için etkinleştirilmedi.
Ne de versionidsnapshot sağlanmadı.
Belirtilen anlık görüntü veya sürüm geçici olarak silinmedi.

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ı izni de içerir. Daha fazla bilgi için bkz. hizmet SAS'sini İçerik Oluşturucu.