Ta bort container

Operationen Delete Container tar bort den angivna containern.

Förfrågan

Du kan skapa begäran på Delete Container följande sätt. HTTPS rekommenderas. Ersätt myaccount- med namnet på ditt lagringskonto.

Metod	Begäran om URI	HTTP-version
`DELETE`	`https://myaccount.blob.core.windows.net/mycontainer?restype=container`	HTTP/1.1

Emulerad URI för lagringstjänsten

När du gör en begäran mot den emulerade lagringstjänsten anger du emulatorns värdnamn och Azure Blob Storage-port som 127.0.0.1:10000, följt av namnet på det emulerade lagringskontot.

Metod	Begäran om URI	HTTP-version
`DELETE`	`http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container`	HTTP/1.1

Mer information finns i Använda Azurite-emulatorn för lokal Azure Storage-utveckling.

URI parametrar

Du kan ange följande tilläggsparameter på begäran om URI.

Parameter	Description
`timeout`	Optional. Parametern `timeout` uttrycks i sekunder. Mer information finns i Ange tidsgränser för Blob Storage-åtgärder.

Förfrågningsrubriker

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

Förfrågningshuvudrad	Description
`Authorization`	Required. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage.
`Date` eller `x-ms-date`	Required. Anger UTC (Coordinated Universal Time) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage.
`x-ms-lease-id: <ID>`	Krävs för version 2012-02-12 och senare om containern har ett aktivt leasingavtal. För att anropa `Delete Container` en container som har ett aktivt lease, ange lease-ID:t i denna header. Om denna header inte specificeras när det finns en aktiv leasing, `Delete Container` returnerar ett 409 (Conflict)-fel. Om du anger fel leasing-ID, eller ett lease-ID på en container som inte har ett aktivt lease `Delete Container` , returneras ett 412-fel (Precondition failed failed).
`x-ms-version`	Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänsterna.
`x-ms-client-request-id`	Optional. Ger ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggning har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Blob Storage.

Denna operation stöder också användningen av villkorliga headers för att ta bort containern endast om ett specificerat villkor är uppfyllt. Mer information finns i Ange villkorsstyrda huvuden för Blob Storage-åtgärder.

Begärandetext

None.

Exempelbegäran

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=

Svar

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Statuskod

En lyckad åtgärd returnerar statuskoden 202 (godkänd). Mer information om statuskoder finns i Status- och felkoder.

Svarsrubriker

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.

Svarsrubrik	Description
`x-ms-request-id`	Det här huvudet identifierar unikt den begäran som gjordes och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder.
`x-ms-version`	Anger vilken version av Blob Storage som används för att köra begäran. Det här huvudet returneras för begäranden som görs mot version 2009-09-19 och senare.
`Date`	Ett UTC-datum/tid-värde som anger den tid då svaret initierades. Tjänsten genererar det här värdet.
`x-ms-client-request-id`	Du kan använda den här rubriken för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet för rubriken `x-ms-client-request-id` , om det finns i begäran. Värdet är högst 1 024 synliga ASCII-tecken. Om `x-ms-client-request-id`-huvudet inte finns i begäran visas inte det här huvudet i svaret.

Svarsdel

None.

Exempelsvar

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

Auktorisering krävs när du anropar en dataåtkomståtgärd i Azure Storage. Du kan auktorisera åtgärden enligt Delete Container beskrivningen nedan.

Important

Microsoft rekommenderar att du använder Microsoft Entra-ID med hanterade identiteter för att auktorisera begäranden till Azure Storage. Microsoft Entra ID ger överlägsen säkerhet och användarvänlighet jämfört med auktorisering med delad nyckel.

Azure Storage stöder användning av Microsoft Entra-ID för att auktorisera begäranden till blobdata. Med Microsoft Entra ID kan du använda rollbaserad åtkomstkontroll i Azure (Azure RBAC) för att bevilja behörigheter till ett säkerhetsobjekt. Säkerhetsobjektet kan vara en användare, grupp, programtjänstens huvudnamn eller Azure-hanterad identitet. Säkerhetsprincipen autentiseras av Microsoft Entra ID för att returnera en OAuth 2.0-token. Token kan sedan användas för att auktorisera en begäran mot Blob-tjänsten.

Mer information om auktorisering med hjälp av Microsoft Entra ID finns i Auktorisera åtkomst till blobar med hjälp av Microsoft Entra ID.

Permissions

Nedan visas den RBAC-åtgärd som krävs för att en Microsoft Entra-användare, grupp, hanterad identitet eller tjänstens huvudnamn ska kunna anropa åtgärden och den minst privilegierade inbyggda Azure RBAC-rollen som innehåller den Delete Container här åtgärden:

Azure RBAC action:Microsoft. Storage/storageAccounts/blobServices/containers/delete
Minst privilegierad inbyggd roll:Storage Blob Data-deltagare

Mer information om hur du tilldelar roller med hjälp av Azure RBAC finns i Tilldela en Azure-roll för åtkomst till blobdata.

En signatur för delad åtkomst (SAS) ger säker delegerad åtkomst till resurser i ett lagringskonto. Med en SAS har du detaljerad kontroll över hur en klient kan komma åt data. Du kan ange vilken resurs klienten kan komma åt, vilka behörigheter de har till dessa resurser och hur länge SAS är giltigt.

Åtgärden Delete Container stöder auktorisering med hjälp av ett konto-SAS.

När åtkomst till delad nyckel inte tillåts för lagringskontot tillåts inte en SAS-token för kontot på en begäran till Blob Storage. Mer information finns i Förstå hur SAS-token påverkas om SAS-token inte tillåts.

Konto SAS

Ett SAS-konto skyddas med lagringskontonyckeln. Ett SAS-konto delegerar åtkomst till resurser i en eller flera av lagringstjänsterna. Alla operationer som är tillgängliga via ett tjänst-SAS eller ett SAS för användardelegering är också tillgängliga via ett konto-SAS.

I följande tabell visas den signerade resurstypen och de signerade behörigheter som ska anges vid delegering av åtkomst:

Operation	Signerad tjänst	Signerad resurstyp	Signerad behörighet
Ta bort container	Blobben (b)	Behållare (c)	Ta bort (d)

Mer information om kontots SAS finns i Skapa ett konto-SAS.

Remarks

När en container tas bort kan en container med samma namn inte skapas på minst 30 sekunder. Containern kanske inte är tillgänglig på mer än 30 sekunder om tjänsten fortfarande bearbetar begäran. Medan containern raderas misslyckas försök att skapa en container med samma namn med statuskod 409 (Konflikt). Tjänsten anger att containern tas bort. Operationer på blobs inom containern, inklusive läsningar och skrivningar, kan fortsätta att lyckas i upp till 30 sekunder efter att borttagningsbegäran har accepterats. Efter denna period misslyckas alla operationer på containern och dess blobs med statuskod 404 (Ej hittad).

Billing

Lagringskonton debiteras inte för Delete Container begäranden.

Se även

Status och felkoderBlob Storage-felkoder Specificerar villkorliga huvuden för Blob Storage-operationer

Last updated on 2026-07-08