Supprimer le conteneur

L’opération Delete Container supprime le conteneur spécifié.

Requête

Vous pouvez construire la requête Delete Container comme suit. HTTPS est recommandé. Remplacez mon compte par le nom de votre compte de stockage.

Method	URI de la requête	Version HTTP
DELETE	https://myaccount.blob.core.windows.net/mycontainer?restype=container	HTTP/1.1

URI du service de stockage émulé

Lorsque vous effectuez une requête sur le service de stockage émulé, spécifiez le nom d’hôte de l’émulateur et le port stockage Blob Azure comme 127.0.0.1:10000, suivi du nom du compte de stockage émulé.

Method	URI de la requête	Version HTTP
DELETE	http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container	HTTP/1.1

Pour plus d’informations, consultez Utiliser l’émulateur Azurite pour le développement de stockage Azure local.

Paramètres d’URI

Vous pouvez spécifier le paramètre supplémentaire suivant sur l’URI de la requête.

Paramètre	Description
timeout	Optional. Le paramètre timeout est exprimé en secondes. Pour plus d’informations, consultez Définition des délais d’expiration pour les opérations de Stockage Blob.

En-têtes de requête

Le tableau suivant décrit les en-têtes de requête obligatoires et facultatifs.

En-tête de requête	Description
Authorization	Obligatoire. Spécifie le schéma d’autorisation, le nom du compte et la signature. Pour plus d’informations, consultez Autoriser les demandes vers le stockage Azure.
Date ou x-ms-date	Obligatoire. Spécifie le temps universel coordonné (UTC) de la requête. Pour plus d’informations, consultez Autoriser les demandes vers le stockage Azure.
x-ms-lease-id: <ID>	Obligatoire pour la version 2012-02-12 et ultérieure si le conteneur a un bail actif. Pour appeler Delete Container un conteneur ayant un bail actif, spécifiez l’identifiant du bail dans cet en-tête. Si cet en-tête n’est pas spécifié lorsqu’il y a un bail actif, Delete Container une erreur 409 (Conflit) renvoie un message 409. Si vous spécifiez le mauvais identifiant de location, ou un identifiant de location sur un conteneur qui n’a pas de bail actif, Delete Container cela renvoie une erreur 412 (Échec de la précondition).
x-ms-version	Obligatoire pour toutes les demandes autorisées. Spécifie la version de l’opération à utiliser pour cette requête. Pour plus d'informations, consultez la page Contrôle de version pour les services de Stockage Microsoft Azure.
x-ms-client-request-id	Optional. Fournit une valeur opaque générée par le client avec une limite de caractères de 1 kibioctet (KiB) enregistrée dans les journaux lors de la configuration de la journalisation. Nous vous recommandons vivement d’utiliser cet en-tête pour mettre en corrélation les activités côté client avec les demandes reçues par le serveur. Pour plus d’informations, consultez Monitor Stockage Blob Azure.

Cette opération permet également l’utilisation d’en-têtes conditionnels pour supprimer le conteneur uniquement si une condition spécifiée est remplie. Pour plus d’informations, consultez Spécification d’en-têtes conditionnels pour les opérations de stockage d’objets blob.

Corps de la demande

Aucun.

Exemple de requête

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

La réponse inclut un code d’état HTTP et un ensemble d’en-têtes de réponse.

Code de statut

Une opération réussie retourne le code d’état 202 (accepté). Pour plus d’informations sur les codes d’état, consultez Les codes d’état et d’erreur.

En-têtes de réponse

La réponse de cette opération inclut les en-têtes suivants. La réponse peut également inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification de protocole HTTP/1.1.

En-tête de réponse	Description
x-ms-request-id	Cet en-tête identifie de manière unique la demande qui a été effectuée et peut être utilisé pour résoudre les problèmes de la demande. Pour plus d’informations, consultez Résolution des problèmes liés aux opérations d’API.
x-ms-version	Indique la version du Stockage Blob utilisé pour exécuter la requête. Cet en-tête est renvoyé pour les demandes effectuées sur la version 2009-09-19 et les versions ultérieures.
Date	Valeur de date/heure UTC qui indique l’heure à laquelle la réponse a été lancée. Le service génère cette valeur.
x-ms-client-request-id	Vous pouvez utiliser cet en-tête pour résoudre les demandes et les réponses correspondantes. La valeur de cet en-tête est égale à la valeur de l’en-tête x-ms-client-request-id , s’il est présent dans la requête. La valeur est d’au plus 1 024 caractères ASCII visibles. Si l’en-tête x-ms-client-request-id n’est pas présent dans la requête, cet en-tête ne sera pas présent dans la réponse.

Corps de réponse

Aucun.

Exemple de réponse

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

L’autorisation est requise lors de l’appel d’une opération d’accès aux données dans stockage Azure. Vous pouvez autoriser l’opération de Delete Container comme décrit ci-dessous.

Important

Microsoft recommande d’utiliser l’ID Microsoft Entra avec des identités managées pour autoriser les demandes adressées au stockage Azure. Microsoft Entra ID offre une sécurité et une facilité d’utilisation supérieures par rapport à l’autorisation de clé partagée.

Microsoft Entra ID (recommandé)

Le Stockage Azure prend en charge l’utilisation de Microsoft Entra ID pour autoriser les requêtes d’accès aux données d’objets blob. Avec l’ID Microsoft Entra, vous pouvez utiliser le contrôle d’accès en fonction du rôle Azure (Azure RBAC) pour accorder des autorisations à un principal de sécurité. Le principal de sécurité peut être un utilisateur, un groupe, un principal de service d’application ou une identité managée Azure. Le principal de sécurité est authentifié par Microsoft Entra ID pour retourner un jeton OAuth 2.0. Le jeton peut ensuite être utilisé pour autoriser une demande auprès du service Blob.

Pour en savoir plus sur l’autorisation à l’aide de l’ID Microsoft Entra, consultez Autoriser l’accès aux objets blob à l’aide de Microsoft Entra ID.

Permissions

Voici l’action RBAC nécessaire pour un utilisateur, un groupe, une identité managée ou un principal de service Microsoft Entra pour appeler l’opération de Delete Container et le rôle RBAC Azure intégré le moins privilégié qui inclut cette action :

• Azure RBAC action :Microsoft. Storage/storageAccounts/blobServices/conteneurs/supprimer
• rôle intégré moins privilégié :Contributeur aux données Blob de stockage

Pour en savoir plus sur l’attribution de rôles à l’aide d’Azure RBAC, consultez Attribuer un rôle Azure pour accéder aux données blob.

signatures d’accès partagé (SAP)

Une signature d’accès partagé (SAP) fournit un accès délégué sécurisé aux ressources d’un compte de stockage. Avec une SAP, vous avez un contrôle granulaire sur la façon dont un client peut accéder aux données. Vous pouvez spécifier la ressource à laquelle le client peut accéder, les autorisations dont il a besoin pour ces ressources et la durée pendant laquelle la SAP est valide.

L’opération Delete Container prend en charge les supports d’autorisation à l’aide d’un compte SAS.

Lorsque l’accès à la clé partagée n’est pas autorisé pour le compte de stockage, un jeton SAS de compte n’est pas autorisé sur une demande adressée au Stockage Blob. Pour plus d’informations, consultez Comprendre comment le refus de la clé partagée affecte les jetons SAP.

Compte SAS

Un SAS de compte est sécurisé à l’aide de la clé du compte de stockage. Un SAS de compte délègue l’accès aux ressources à un ou plusieurs des services de stockage. Toutes les opérations disponibles via une SAP de service ou de délégation d’utilisateur sont également disponibles via une SAP de compte.

Le tableau suivant indique le type de ressource signé et les autorisations signées à spécifier lors de la délégation de l’accès :

Operation	Service signé	Type de ressource signé	Autorisation signée
Supprimer le conteneur	Blob (b)	Conteneur (c)	Supprimer d)

Pour en savoir plus sur la SAP de compte, consultez Créer une SAP de compte.

L’opération de Delete Container prend en charge d’autorisation de clé partagée. L’autorisation avec des clés de compte n’est pas recommandée pour la plupart des scénarios, car elle est moins sécurisée.

Microsoft recommande de refuser l’autorisation de clé partagée pour le compte de stockage si possible. Pour plus d’informations, consultez Empêcher l’autorisation avec une clé partagée.

Remarks

Lorsqu’un conteneur est supprimé, un conteneur portant le même nom ne peut pas être créé pendant au moins 30 secondes. Le conteneur peut ne pas être disponible pendant plus de 30 secondes si le service traite toujours la demande. Pendant la suppression du conteneur, les tentatives de création d’un conteneur du même nom échouent avec le code d’état 409 (Conflit). Le service indique que le conteneur est en cours de suppression. Les opérations sur les blobs à l’intérieur du conteneur, y compris les lectures et écritures, peuvent continuer à réussir jusqu’à 30 secondes après l’acceptation de la demande de suppression. Après cette période, toutes les opérations sur le conteneur et ses blobs échouent avec le code d’état 404 (Non trouvé).

Billing

Les comptes de stockage ne sont pas facturés pour Delete Container les demandes.

Voir aussi

Codes d’état et d’erreurStockage Blob Codes d’erreurSpécifier les en-têtes conditionnels pour les opérations Stockage Blob