Container verwijderen

De Delete Container operatie verwijdert de opgegeven container.

Verzoek

U kunt de Delete Container aanvraag als volgt samenstellen. HTTPS wordt aanbevolen. Vervang myaccount- door de naam van uw opslagaccount.

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

Geëmuleerde opslagservice-URI

Wanneer u een aanvraag indient voor de geëmuleerde opslagservice, geeft u de hostnaam van de emulator en de Azure Blob Storage-poort op als 127.0.0.1:10000, gevolgd door de naam van het geëmuleerde opslagaccount.

Methode	URI-aanvraag	HTTP-versie
`DELETE`	`http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container`	HTTP/1.1

Zie Azurite-emulator gebruiken voor lokale Azure Storage-ontwikkeling voor meer informatie.

URI Parameters

Je kunt de volgende extra parameter opgeven op de request URI.

Parameter	Description
`timeout`	Optional. De parameter `timeout` wordt uitgedrukt in seconden. Zie Time-outs instellen voor Blob Storage-bewerkingen voor meer informatie.

Headers aanvragen

In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven.

Header van het verzoek	Description
`Authorization`	Required. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie.
`Date` of `x-ms-date`	Required. Hiermee geeft u de Coordinated Universal Time (UTC) voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie.
`x-ms-lease-id: <ID>`	Vereist voor versie 2012-02-12 en later als de container een actieve lease heeft. Om een container aan te roepen `Delete Container` met een actieve lease, specificeer je de lease-ID in deze header. Als deze header niet is gespecificeerd wanneer er een actieve lease is, `Delete Container` geeft deze een 409 (Conflict) foutmelding terug. Als je de verkeerde lease-ID opgeeft, of een lease-ID op een container zonder actieve lease, `Delete Container` krijg je een 412 (Precondition failed) foutmelding.
`x-ms-version`	Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking die moet worden gebruikt voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
`x-ms-client-request-id`	Optional. Biedt een door de client gegenereerde, ondoorzichtige waarde met een tekenlimiet van 1 kibibyte (KiB) die wordt vastgelegd in de logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Azure Blob Storage-bewaken voor meer informatie.

Deze operatie ondersteunt ook het gebruik van conditionele headers om de container alleen te verwijderen als aan een bepaalde voorwaarde is voldaan. Zie Voorwaardelijke headers opgeven voor Blob Storage-bewerkingen voor meer informatie.

aanvraaginhoud

None.

Voorbeeldaanvraag

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=

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Statuscode

Een geslaagde bewerking retourneert statuscode 202 (Geaccepteerd). Zie Status en foutcodesvoor meer informatie over statuscodes.

Antwoordkopteksten

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende, standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Antwoordheader	Description
`x-ms-request-id`	Deze header identificeert de aanvraag die is gemaakt en kan worden gebruikt voor het oplossen van problemen met de aanvraag. Zie Problemen met API-bewerkingen oplossen voor meer informatie.
`x-ms-version`	Geeft de versie van Blob Storage aan die wordt gebruikt om de aanvraag uit te voeren. Deze header wordt geretourneerd voor aanvragen die zijn ingediend tegen versie 2009-09-19 en hoger.
`Date`	Een UTC-datum/tijd-waarde die de tijd aangeeft waarop het antwoord is gestart. De service genereert deze waarde.
`x-ms-client-request-id`	U kunt deze header gebruiken om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de `x-ms-client-request-id` header, als deze aanwezig is in de aanvraag. De waarde is maximaal 1.024 zichtbare ASCII-tekens. Als de `x-ms-client-request-id` header niet aanwezig is in de aanvraag, is deze header niet aanwezig in het antwoord.

Antwoordlichaam

None.

Voorbeeldantwoord

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

Autorisatie is vereist bij het aanroepen van een bewerking voor gegevenstoegang in Azure Storage. U kunt de Delete Container bewerking autoriseren zoals hieronder wordt beschreven.

Important

Microsoft raadt aan om Microsoft Entra ID met beheerde identiteiten te gebruiken om aanvragen voor Azure Storage te autoriseren. Microsoft Entra ID biedt superieure beveiliging en gebruiksgemak in vergelijking met autorisatie van gedeelde sleutels.

Microsoft Entra ID (aanbevolen)
Sas- (Shared Access Signatures)
gedeelde sleutel

Azure Storage ondersteunt het gebruik van Microsoft Entra ID om aanvragen voor blobgegevens te autoriseren. Met Microsoft Entra ID kunt u op rollen gebaseerd toegangsbeheer van Azure (Azure RBAC) gebruiken om machtigingen te verlenen aan een beveiligingsprincipaal. De beveiligingsprincipaal kan een door een gebruiker, groep, toepassingsservice-principal of door Azure beheerde identiteit zijn. De beveiligingsprincipaal wordt geverifieerd door Microsoft Entra ID om een OAuth 2.0-token terug te geven. Het token kan vervolgens worden gebruikt om een aanvraag te autoriseren voor de Blob-service.

Zie Toegang tot blobs autoriseren met behulp van Microsoft Entra IDvoor meer informatie over autorisatie met Behulp van Microsoft Entra ID.

Permissions

Hieronder vindt u de RBAC-actie die nodig is voor een Microsoft Entra-gebruiker, groep, beheerde identiteit of service-principal om de Delete Container-bewerking aan te roepen, en de minst bevoorrechte ingebouwde Azure RBAC-rol die deze actie omvat:

Azure RBAC action:Microsoft. Storage/storageAccounts/blobServices/containers/delete
Ingebouwde rol met minste bevoegdheden:Storage Blob Data Contributor

Zie Een Azure-rol toewijzen voor toegang tot blobgegevensvoor meer informatie over het toewijzen van rollen met behulp van Azure RBAC.

Een Shared Access Signature (SAS) biedt beveiligde gedelegeerde toegang tot resources in een opslagaccount. Met een SAS hebt u gedetailleerde controle over hoe een client toegang heeft tot gegevens. U kunt opgeven tot welke resource de client toegang heeft, tot welke machtigingen deze resources beschikken en hoe lang de SAS geldig is.

De Delete Container bewerking ondersteunt ondersteuning voor autorisatie met behulp van een account SAS.

Wanneer toegang tot gedeelde sleutels niet is toegestaan voor het opslagaccount, is een SAS-token van het account niet toegestaan voor een aanvraag voor Blob Storage. Zie Begrijpen hoe de toewijzing van gedeelde sleutels van invloed is op SAS-tokensvoor meer informatie.

Account-SAS

Een account-SAS wordt beveiligd met de sleutel van het opslagaccount. Een account SAS delegeert toegang van resources in een of meer van de opslagservices. Alle bewerkingen die beschikbaar zijn via een service of gebruikersdelegering-SAS, zijn ook beschikbaar via een account-SAS.

De volgende tabel geeft het ondertekende resourcetype en de ondertekende machtigingen aan die moeten worden opgegeven bij het delegeren van toegang:

Operation	Ondertekende service	Ondertekend resourcetype	Ondertekende machtiging
Container verwijderen	Klodder (b)	Container (c)	Schrappen (d)

Zie Een SAS-account makenvoor meer informatie over de ACCOUNT-SAS.

Remarks

Wanneer een container wordt verwijderd, kan een container met dezelfde naam minstens 30 seconden niet worden aangemaakt. De container is mogelijk niet langer dan 30 seconden beschikbaar als de service de aanvraag nog steeds verwerkt. Terwijl de container wordt verwijderd, mislukken pogingen om een container met dezelfde naam aan te maken met statuscode 409 (Conflict). De service geeft aan dat de container wordt verwijderd. Bewerkingen op blobs binnen de container, inclusief lezen en schrijven, kunnen tot 30 seconden na acceptatie van het verwijderverzoek succesvol blijven. Na deze periode falen alle bewerkingen op de container en zijn blobs met statuscode 404 (Niet gevonden).

Billing

Opslagaccounts worden niet in rekening gebracht voor Delete Container aanvragen.

Zie ook

Status en foutcodes Blob Storage foutcodes Het specificeren van conditionele headers voor Blob Storage-operaties

Last updated on 2026-07-08