Container löschen

Die Operation Delete Container löscht den angegebenen Container.

Anfrage

Sie können die Delete Container Anforderung wie folgt erstellen. HTTPS wird empfohlen. Ersetzen Sie myaccount durch den Namen Ihres Speicherkontos.

Methode URI anfordern HTTP-Version
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1

Emulierter Speicherdienst-URI

Wenn Sie eine Anforderung an den emulierten Speicherdienst senden, geben Sie den Hostnamen des Emulators und den Azure Blob Storage-Port als 127.0.0.1:10000an, gefolgt vom Namen des emulierten Speicherkontos.

Methode URI anfordern HTTP-Version
DELETE http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container HTTP/1.1

Weitere Informationen finden Sie unter Verwenden des Azurite-Emulators für die lokale Azure Storage-Entwicklung.

URI-Parameter

Sie können den folgenden zusätzlichen Parameter auf der Anfrage-URI angeben.

Parameter Description
timeout Dies ist optional. Der parameter timeout wird in Sekunden ausgedrückt. Weitere Informationen finden Sie unter Festlegen von Timeouts für Blob Storage-Vorgänge.

Anforderungsheader

In der folgenden Tabelle werden die erforderlichen und optionalen Anforderungsheader beschrieben.

Anforderungs-Header Description
Authorization Required. Gibt das Autorisierungsschema, den Kontonamen und die Signatur an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
Date oder x-ms-date Required. Gibt die koordinierte Weltzeit (UTC) für die Anforderung an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
x-ms-lease-id: <ID> Erforderlich für Version 2012-02-12 und später, wenn der Container einen aktiven Mietvertrag hat. Um einen Container mit aktivem Lease aufzurufen Delete Container , geben Sie in diesem Header die Lease-ID an. Wenn dieser Header nicht angegeben ist, wenn ein aktiver Mietvertrag besteht, Delete Container erhält er einen 409 (Konflikt)-Fehler. Wenn du die falsche Lease-ID oder eine Lease-ID auf einem Container angibst, der keinen aktiven Lease hat, Delete Container ergibt das einen 412-Fehler (Precondition fehlgeschlagen).
x-ms-version Erforderlich für alle autorisierten Anfragen. Gibt die Version des Vorgangs an, der für diese Anforderung verwendet werden soll. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure-Speicherdienste.
x-ms-client-request-id Dies ist optional. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem 1-Kibibyte-Zeichenlimit (KiB) bereit, der in den Protokollen aufgezeichnet wird, wenn die Protokollierung konfiguriert ist. Es wird dringend empfohlen, diesen Header zu verwenden, um clientseitige Aktivitäten mit Anforderungen zu korrelieren, die der Server empfängt. Weitere Informationen finden Sie unter Überwachen von Azure Blob Storage.

Diese Operation unterstützt auch die Verwendung von bedingten Headern, um den Container nur dann zu löschen, wenn eine bestimmte Bedingung erfüllt ist. Weitere Informationen finden Sie unter Angeben bedingter Header für Blob Storage-Vorgänge.

Anforderungstext

Keiner.

Musteranforderung

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=

Antwort

Die Antwort enthält einen HTTP-Statuscode und eine Reihe von Antwortheadern.

Statuscode

Ein erfolgreicher Vorgang gibt den Statuscode 202 (Akzeptiert) zurück. Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

Antwortkopfzeilen

Die Antwort für diesen Vorgang enthält die folgenden Header. Die Antwort kann auch zusätzliche, standardmäßige HTTP-Header enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Antwortkopfzeile Description
x-ms-request-id Dieser Header identifiziert die anforderung eindeutig und kann für die Problembehandlung der Anforderung verwendet werden. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge.
x-ms-version Gibt die Version von Blob Storage an, die zum Ausführen der Anforderung verwendet wird. Dieser Header wird für Anforderungen zurückgegeben, die mit Version 2009-09-19 und höher vorgenommen wurden.
Date Ein UTC-Datums-/Uhrzeitwert, der die Uhrzeit angibt, zu der die Antwort initiiert wurde. Der Dienst generiert diesen Wert.
x-ms-client-request-id Sie können diesen Header verwenden, um Anfragen und entsprechende Antworten zu behandeln. Der Wert dieses Headers ist gleich dem Wert des x-ms-client-request-id-Headers, wenn er in der Anforderung vorhanden ist. Der Wert beträgt maximal 1.024 sichtbare ASCII-Zeichen. Wenn der x-ms-client-request-id-Header in der Anforderung nicht vorhanden ist, ist dieser Header in der Antwort nicht vorhanden.

Antwortkörper

Keiner.

Beispielantwort

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

Die Autorisierung ist beim Aufrufen eines Datenzugriffsvorgangs in Azure Storage erforderlich. Sie können den Delete Container Vorgang wie unten beschrieben autorisieren.

Important

Microsoft empfiehlt die Verwendung der Microsoft Entra-ID mit verwalteten Identitäten, um Anforderungen an Azure Storage zu autorisieren. Die Microsoft Entra-ID bietet eine bessere Sicherheit und Benutzerfreundlichkeit im Vergleich zur Shared Key-Autorisierung.

Azure Storage unterstützt die Verwendung der Microsoft Entra-ID zum Autorisieren von Anforderungen an BLOB-Daten. Mit Microsoft Entra ID können Sie mithilfe der rollenbasierten Zugriffssteuerung von Azure (Azure RBAC) einem Sicherheitsprinzipal Berechtigungen gewähren. Der Sicherheitsprinzipal kann ein Benutzer, eine Gruppe, ein Anwendungsdienstprinzipal oder eine von Azure verwaltete Identität sein. Der Sicherheitsprinzipal wird von Microsoft Entra ID authentifiziert, und gibt ein OAuth 2.0-Token zurück. Das Token kann dann verwendet werden, um eine Anforderung gegen den Blob-Dienst zu autorisieren.

Weitere Informationen zur Autorisierung mithilfe der Microsoft Entra-ID finden Sie unter Autorisieren des Zugriffs auf Blobs mithilfe von Microsoft Entra ID.

Erlaubnisse

Nachfolgend sind die RBAC-Aktion aufgeführt, die für einen Microsoft Entra-Benutzer, eine Gruppe, eine verwaltete Identität oder einen Dienstprinzipal erforderlich ist, um den Delete Container Vorgang aufzurufen, und die integrierte Azure RBAC-Rolle, die diese Aktion enthält:

Weitere Informationen zum Zuweisen von Rollen mithilfe von Azure RBAC finden Sie unter Zuweisen einer Azure-Rolle für den Zugriff auf BLOB-Daten.

Hinweise

Wenn ein Container gelöscht wird, kann ein Container mit demselben Namen mindestens 30 Sekunden lang nicht erstellt werden. Der Container ist möglicherweise nicht für mehr als 30 Sekunden verfügbar, wenn der Dienst die Anforderung noch verarbeitet. Während der Container gelöscht wird, scheitern Versuche, einen Container mit demselben Namen mit Statuscode 409 (Konflikt) zu erstellen. Der Dienst gibt an, dass der Container gelöscht wird. Operationen auf Blobs innerhalb des Containers, einschließlich Lesen und Schreiben, können bis zu 30 Sekunden nach Annahme der Löschanforderung erfolgreich sein. Nach dieser Phase schlagen alle Operationen am Container und seinen Blobs mit Statuscode 404 (Nicht gefunden) fehl.

Billing

Speicherkonten werden für Delete Container Anforderungen nicht in Rechnung gestellt.

Siehe auch

Status und FehlercodesBlobStorage-FehlercodesSpezifizierung bedingter Header für Blob Storage-Operationen

  • Last updated on