Partager via


Delete Blob

L’opération Delete Blob supprime l’objet blob ou le instantané spécifié.

Notez que pour supprimer un objet blob, vous devez supprimer tous ses instantanés. Vous pouvez supprimer les deux en même temps avec l'opération Delete Blob.

Requête

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

URI de demande de méthode DELETE Version HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>
HTTP/1.1

URI de service de stockage émulé

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

URI de demande de méthode DELETE Version HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1

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

Paramètres URI

Vous pouvez spécifier les paramètres supplémentaires suivants sur l’URI de requête.

Paramètre Description
snapshot facultatif. Le paramètre instantané est une valeur DateTime opaque qui, quand elle est présente, spécifie l'instantané de l'objet blob à supprimer. Pour plus d’informations sur l’utilisation des instantanés d’objets blob, consultez Création d’un instantané d’un objet blob.
versionid Facultatif, version 2019-12-12 et ultérieures. Le versionid paramètre est une valeur opaque DateTime qui, lorsqu’elle est présente, spécifie la version de l’objet blob à supprimer.
timeout facultatif. Le paramètre timeout est exprimé en secondes. Pour plus d’informations, consultez Définition de délais d’expiration pour les opérations de stockage Blob.
deletetype Facultatif, version 2020-02-10 ou ultérieure. La valeur de deletetype ne peut être permanentque .

En-têtes de requête

Le tableau suivant décrit les en-têtes de demande obligatoires ou 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 requêtes auprès du Stockage Azure.
Date ou x-ms-date Obligatoire. Spécifie la date/heure en temps universel coordonné (UTC) pour la requête. Pour plus d’informations, consultez Autoriser les requêtes auprès du Stockage Azure.
x-ms-version Obligatoire pour toutes les demandes autorisées. Pour plus d'informations, consultez la page Contrôle de version pour les services de Stockage Microsoft Azure.
x-ms-lease-id:<ID> Obligatoire si l'objet blob a un bail actif.

Pour effectuer cette opération sur un objet blob avec un bail actif, spécifiez l'ID de bail valide pour cet en-tête. Si aucun ID de bail valide n’est spécifié sur la demande, l’opération échoue avec status code 403 (Interdit).
x-ms-delete-snapshots: {include, only} Obligatoire si l'objet blob a des instantanés associés. Spécifiez l’une des options suivantes :

- include: supprimez l’objet blob de base et tous ses instantanés.
- only: supprime uniquement les instantanés de l’objet blob, et non l’objet blob lui-même.

Spécifiez cet en-tête uniquement pour une requête sur la ressource blob de base. Si cet en-tête est spécifié lors d’une demande de suppression d’un instantané individuel, stockage Blob retourne status code 400 (requête incorrecte).

Si cet en-tête n’est pas spécifié dans la demande et que l’objet blob a des instantanés associés, stockage Blob retourne status code 409 (Conflit).
x-ms-client-request-id facultatif. Fournit une valeur opaque générée par le client avec une limite de caractères de 1 kibioctet (Kio) 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 Surveiller Stockage Blob Azure.

Cette opération prend également en charge l'utilisation d'en-têtes conditionnels pour supprimer l'objet blob uniquement si une condition est remplie. Pour plus d’informations, consultez Spécification d’en-têtes conditionnels pour les opérations de stockage Blob.

Corps de la demande

Aucun.

response

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

Code d’état

Une opération réussie renvoie le code d'état 202 (Accepté). Pour plus d’informations sur les codes status, consultez État et codes d’erreur.

En-têtes de réponse

La réponse de l'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 du 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 la résolution des 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ée pour exécuter la demande. Cet en-tête est renvoyé pour les demandes effectuées avec la version 2009-09-19 ou une version ultérieure.
x-ms-delete-type-permanent Pour les versions 29-07-2017 et ultérieures, le stockage Blob retourne true si l’objet blob a été supprimé définitivement et false si l’objet blob a été supprimé de manière réversible.
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 demande. La valeur est au maximum de 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.

Autorisation

Une 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 Delete Blob comme décrit ci-dessous.

Important

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

Stockage Azure prend en charge l’utilisation de Microsoft Entra ID pour autoriser les demandes de données blob. Avec Microsoft Entra ID, 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 requête auprès du service BLOB.

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

Autorisations

Vous trouverez ci-dessous l’action RBAC nécessaire pour qu’un utilisateur, un groupe, une identité managée ou un principal de service Microsoft Entra appelle l’opérationDelete Blob, ainsi que le rôle RBAC Azure intégré le moins privilégié qui inclut cette action :

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

Remarques

Si l'objet blob a un bail actif, le client doit spécifier un ID de bail valide dans la demande afin de le supprimer.

Si un objet blob a un grand nombre d’instantanés, il est possible que l’opération Delete Blob expire. Si cela se produit, le client doit réessayer la demande.

Pour les versions 2013-08-15 et ultérieures, le client peut appeler Delete Blob pour supprimer les objets blob non validés. Un objet blob non validé est un objet blob qui a été créé avec des appels à l’opération Put Block , mais jamais validé à l’aide de l’opération Put Block List . Pour les versions antérieures, le client doit valider l'objet blob avant de le supprimer.

Fonctionnalité de suppression réversible désactivée

Lorsqu’un objet blob est supprimé avec succès, il est immédiatement supprimé de l’index du compte de stockage et il n’est plus accessible aux clients.

Fonctionnalité de suppression réversible activée

Lorsqu’un objet blob est supprimé avec succès, il est supprimé de manière réversible et il n’est plus accessible aux clients. Stockage Blob conserve l’objet blob ou le instantané pendant le nombre de jours spécifié pour la DeleteRetentionPolicy propriété stockage Blob. Pour plus d’informations sur la lecture des propriétés du stockage Blob, consultez Définir les propriétés du stockage Blob.

Après le nombre de jours spécifié, les données de l’objet blob sont supprimées du service. Vous pouvez accéder à un objet blob ou à un instantané supprimés de manière réversible en appelant l’opération Répertorier les objets blob et en spécifiant l’optioninclude=deleted.

Vous pouvez restaurer des objets blob ou des instantanés supprimés de manière réversible à l’aide de Annuler la suppression d’un objet blob. Pour toute autre opération sur des objets blob ou des instantanés supprimés de manière réversible, le stockage Blob retourne l’erreur 404 (ressource introuvable).

Suppression définitive

Avec les versions 2020-02-10 et ultérieures, vous pouvez supprimer définitivement une instantané ou une version supprimée de manière réversible. Pour ce faire, vous activez la fonctionnalité. Pour plus d’informations, consultez Définir les propriétés du stockage Blob.

Notes

Le contrôle de version ou les captures instantanées du compte de stockage doivent être activés. La suppression réversible doit également être activée sur le compte de stockage pour supprimer de manière réversible des versions ou des instantanés d’objets blob dans le compte. La suppression permanente supprime uniquement les captures instantanées ou versions supprimées de manière réversible.

Les comptes de stockage avec la suppression permanente activée peuvent utiliser le deletetype=permanent paramètre de requête pour supprimer définitivement une instantané supprimée de manière réversible ou une version d’objet blob supprimée.

Si le paramètre de requête présente l’un des éléments suivants, Stockage Blob renvoie une erreur 409 (Conflit) :

  • La fonctionnalité de suppression définitive n’est pas activée pour le compte de stockage.
  • snapshot Ni ne versionid sont fournis.
  • La instantané ou la version spécifiée n’est pas supprimée de manière réversible.

La suppression permanente inclut également une autorisation de signature d’accès partagé pour supprimer définitivement un instantané d’objet blob ou une version d’objet blob. Pour plus d’informations, consultez Create une SAP de service.

Facturation

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

Voir aussi

Autoriser les demandes à Stockage Azure

Codes d’état et d’erreur

Codes d’erreur Stockage Blob

Annuler la suppression d’un objet blob

Lister les objets blob