Odstranění kontejneru

Operace Delete Container smaže specifikovaný kontejner.

Prosba

Požadavek Delete Container můžete vytvořit následujícím způsobem. Doporučuje se protokol HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště.

Metoda Požadavek na URI Verze protokolu HTTP
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1

Identifikátor URI emulované služby úložiště

Když vytvoříte požadavek na emulovanou službu úložiště, zadejte název hostitele emulátoru a port Azure Blob Storage jako 127.0.0.1:10000, následovaný názvem emulovaného účtu úložiště.

Metoda Požadavek na URI Verze protokolu HTTP
DELETE http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container HTTP/1.1

Další informace najdete v tématu Použití emulátoru Azurite pro místní vývoj Azure Storage.

Parametry identifikátoru URI

Na URI požadavku můžete zadat následující dodatečný parametr.

Parametr Description
timeout Optional. Parametr timeout je vyjádřen v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Blob Storage.

Hlavičky žádosti

Následující tabulka popisuje povinné a volitelné hlavičky požadavků.

Hlavička požadavku Description
Authorization Required. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
Date nebo x-ms-date Required. Určuje standard UTC (Coordinated Universal Time) pro požadavek. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
x-ms-lease-id: <ID> Vyžadováno pro verzi 2012-02-12 a pozdější, pokud má kontejner aktivní nájem. Pro volání Delete Container kontejneru s aktivním nájemem zadejte ID pronájmu v této hlavičce. Pokud tato hlavička není specifikována při aktivní nájmu, Delete Container vrátí se chyba 409 (Conflict). Pokud zadáte špatné ID leasingu nebo ID leasingu u kontejneru, Delete Container který nemá aktivní nájem, vrátí se chyba 412 (předpodmínka selhala).
x-ms-version Vyžadováno pro všechny autorizované požadavky. Určuje verzi operace, která se má pro tento požadavek použít. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-client-request-id Optional. Poskytuje hodnotu vygenerovanou klientem, neprůshlenou hodnotou s limitem znaků 1 kibibajtů (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování služby Azure Blob Storage.

Tato operace také podporuje použití podmíněných hlaviček pro smazání kontejneru pouze v případě splnění specifikované podmínky. Další informace najdete v tématu Určení podmíněných hlaviček pro operace služby Blob Storage.

Text požadavku

None.

Ukázkový požadavek

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

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 202 (přijato). Informace o stavových kódech naleznete v tématu Stav a kódy chyb.

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi Description
x-ms-request-id Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a lze ho použít k řešení potíží s požadavkem. Další informace naleznete v tématu Řešení potíží s operacemi rozhraní API.
x-ms-version Označuje verzi služby Blob Storage použitou ke spuštění požadavku. Tato hlavička se vrátí pro požadavky provedené ve verzi 2009-09-19 a novější.
Date Hodnota data a času UTC, která označuje čas, kdy byla odpověď zahájena. Služba tuto hodnotu vygeneruje.
x-ms-client-request-id Tato hlavička slouží k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě hlavičky x-ms-client-request-id , pokud je v požadavku přítomna. Hodnota je maximálně 1 024 viditelných znaků ASCII. Pokud v požadavku není hlavička x-ms-client-request-id, nebude tato hlavička v odpovědi k dispozici.

Obsah odpovědi

None.

Ukázková odpověď

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

Autorizace se vyžaduje při volání jakékoli operace přístupu k datům ve službě Azure Storage. Operaci Delete Container můžete autorizovat, jak je popsáno níže.

Important

Microsoft doporučuje používat Microsoft Entra ID se spravovanými identitami k autorizaci požadavků do služby Azure Storage. Microsoft Entra ID poskytuje vynikající zabezpečení a snadné použití v porovnání s autorizací sdíleného klíče.

Azure Storage podporuje použití Microsoft Entra ID k autorizaci přístupů k datům blobů. S ID Microsoft Entra můžete pomocí řízení přístupu na základě role v Azure (Azure RBAC) udělit oprávnění k objektu zabezpečení. Objekt zabezpečení může být uživatel, skupina, instanční objekt aplikace nebo spravovaná identita Azure. Instanční objekt zabezpečení je ověřený pomocí ID Microsoft Entra pro vrácení tokenu OAuth 2.0. Token se pak dá použít k autorizaci požadavku ve službě Blob Service.

Další informace o autorizaci pomocí ID Microsoft Entra najdete v tématu Autorizace přístupu k objektům blob pomocíMicrosoft Entra ID .

Permissions

Níže je uvedena akce RBAC potřebná pro uživatele, skupinu, spravovanou identitu nebo instanční objekt Microsoftu pro volání operace Delete Container a nejméně privilegované předdefinované role Azure RBAC, která zahrnuje tuto akci:

Další informace o přiřazování rolí pomocí Azure RBAC najdete v tématu Přiřazení role Azure pro přístup k datům objektů blob.

Poznámky

Když je kontejner smazán, nelze vytvořit kontejner se stejným názvem alespoň 30 sekund. Pokud služba stále zpracovává požadavek, nemusí být kontejner po dobu delší než 30 sekund k dispozici. Během mazání kontejneru pokusy o vytvoření kontejneru se stejným názvem selžou s kódem stavu 409 (Konflikt). Služba označuje, že se kontejner odstraňuje. Operace s bloby uvnitř kontejneru, včetně čtení a zápisu, mohou pokračovat v úspěchu až 30 sekund po přijetí žádosti o odstranění. Po této době všechny operace na kontejneru a jeho blobech selžou s kódem stavu 404 (Nenalezeno).

Billing

Účty úložiště se za Delete Container požadavky neúčtují.

Viz také

Stavové a chybové kódyBlob StorageSpecifikace podmíněných hlaviček pro operace Blob Storage

  • Last updated on