Kapsayıcıyı Sil

İşlem, Delete Container belirtilen konteyneri siler.

İstek

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

Method İstenilen URI HTTP sürümü
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1

Öykünmüş 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ı şu şekilde 127.0.0.1:10000belirtin ve ardından öykünülmüş depolama hesabı adını belirtin.

Method İstenilen URI HTTP sürümü
DELETE http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container HTTP/1.1

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

URI parametreleri

Aşağıdaki ek parametreyi istek URI'de belirtebilirsiniz.

Parametre Description
timeout Optional. timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz: Blob Depolama işlemleri için zaman aşımlarını ayarlama.

İstek başlıkları

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

İstek üst bilgisi Description
Authorization Required. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri yetkilendirme .
Date veya x-ms-date Required. İstek için Eşgüdümlü Evrensel Saati (UTC) belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri yetkilendirme .
x-ms-lease-id: <ID> 2012-02-12 ve sonrasında aktif bir kiralama varsa 2012-02-12 ve sonrasında gereklidir. Aktif kira sözleşmesi olan bir konteyneri çağırmak Delete Container için, bu başlıkta kira kimliğini belirtin. Aktif kira olduğunda bu başlık belirtilmemişse, Delete Container 409 (Çatışma) hatası döner. Yanlış kira kimliği veya aktif kira sözleşmesi olmayan bir konteynerde bir kira kimliği belirtirseniz, Delete Container 412 (Ön koşul başarısız oldu) hatası döner.
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 Azure Depolama hizmetleri için sürümleme bölümüne bakın.
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ı 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.

Bu işlem ayrıca, yalnızca belirli bir koşul sağlandığında konteyneri silmek için koşullu başlıkların kullanılmasını destekler. Daha fazla bilgi için bkz: Blob Depolama işlemleri için koşullu üst bilgileri belirtme.

İstek içeriği

None.

Numune isteği

Request Syntax:  
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1  
  
Request Headers:  
x-ms-version: 2011-08-18  
x-ms-date: Sun, 25 Sep 2011 21:44:34 GMT  
Authorization: SharedKey devstoreaccount1:t7mf5htNuwLFX9g0S2LDdRtRn1FQzMAluBvHy1QPpnM=  

Response

Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi 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 üst bilgilerHTTP/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 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.
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 karakteridir. İstekte x-ms-client-request-id üst bilgisi yoksa, yanıtta bu üst bilgi bulunmaz.

Yanıt içeriği

None.

Örnek yanıt

Response Status:  
HTTP/1.1 202 Accepted  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-Type: application/xml  
Date: Sun, 25 Sep 2011 21:45:00 GMT  
x-ms-version: 2011-08-18  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  

Authorization

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

Important

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. 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.Microsoft Entra Id kullanarak bloblara erişimi yetkilendirme .

Permissions

Aşağıda bir Microsoft Entra kullanıcısı, grubu, yönetilen kimliği veya hizmet sorumlusunun Delete Container işlemini çağırması 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

Bir konteyner silindiğinde, aynı isimli bir konteyner en az 30 saniye boyunca oluşturulamaz. Hizmet isteği işlemeye devam ediyorsa kapsayıcı 30 saniyeden uzun süre kullanılamayabilir. Konteyner silinirken, aynı isimde bir konteyner oluşturma girişimleri 409 (Çatışma) durum koduyla başarısız olur. Hizmet, kapsayıcının silinmekte olduğunu belirtir. Konteyner içindeki bloblar üzerindeki işlemler, okuma ve yazma dahil, silme isteği kabul edildikten sonra 30 saniyeye kadar başarılı olmaya devam edebilir. Bu dönemden sonra, konteyner ve bloblarındaki tüm işlemler 404 (Bulunmadı) durum kodu ile başarısız olur.

Billing

İstekler için Delete Container depolama hesapları ücretlendirilmez.

Ayrıca bakınız

Durum ve hatakodları Blob Depolama hata kodlarıBlob Depolama işlemleri için koşullu başlıkların belirtilmesi