Share via


API REST d’Azure Blob Storage

Stockage Blob Azure stocke des données texte et binaires en tant qu’objets dans le cloud. Stockage Blob offre les ressources suivantes : le compte de stockage, les conteneurs et les objets blob. Dans votre compte de stockage, les conteneurs fournissent une façon d'organiser les ensembles d'objets blob.

Vous pouvez stocker du texte et des données binaires dans l'un des types d'objet blob suivants :

  • les objets blob de blocs, qui sont optimisés pour la diffusion ;

  • Objets blob d’ajout, qui sont optimisés pour les opérations d’ajout.

  • Objets blob de pages, qui sont optimisés pour les opérations de lecture/écriture aléatoires et qui offrent la possibilité d’écrire dans une plage d’octets dans un objet blob.

Pour plus d’informations, consultez Présentation des objets blob de blocs, des objets blob d’ajout et des objets blob de pages.

L’API REST pour le stockage Blob définit les opérations HTTP sur le compte de stockage, les conteneurs et les objets blob. L'API comprend les opérations répertoriées dans le tableau suivant.

Opération Type de ressource Description
Lister des conteneurs Compte Répertorie tous les conteneurs d'un compte de stockage.
Définir les propriétés du stockage Blob Compte Définit les propriétés du Stockage Blob, y compris les paramètres de journalisation et de métriques, ainsi que la version du service par défaut.
Obtenir les propriétés du stockage Blob Compte Obtient les propriétés Stockage Blob, y compris les paramètres de journalisation et de métriques, ainsi que la version du service par défaut.
Demande d’objet blob pré-survol Compte Interroge les règles CORS (Cross-Origin Resource Sharing) pour Stockage Blob, avant d’envoyer la requête réelle.
Obtenir les statistiques du stockage Blob Compte Récupère les statistiques relatives à la réplication pour le Stockage Blob. Cette opération est uniquement disponible sur le point de terminaison d'emplacement secondaire lorsque la réplication géographique redondante avec accès en lecture est activée pour le compte de stockage.
Obtenir des informations de compte Compte Retourne le nom de la référence SKU et le type de compte pour le compte spécifié.
Obtenir la clé de délégation d’utilisateur Compte Obtient une clé qui peut être utilisée pour signer une signature d’accès partagé de délégation d’utilisateur. Cette signature accorde l’accès aux ressources du Stockage Blob à l’aide des informations d’identification Microsoft Entra.
Créer un conteneur Conteneur Crée un conteneur dans un compte de stockage.
Get Container Properties Conteneur Renvoie toutes les métadonnées et propriétés système définies par l'utilisateur d'un conteneur.
Get Container Metadata Conteneur Renvoie uniquement les métadonnées définies par l'utilisateur d'un conteneur.
Définir les métadonnées d’un conteneur Conteneur Définit les métadonnées définies par l'utilisateur d'un conteneur.
Get Container ACL Conteneur Obtient la stratégie d'accès publique et toutes les stratégies d'accès stockées pour le conteneur.
Set Container ACL Conteneur Définit la stratégie d'accès publique et toutes les stratégies d'accès stockées pour le conteneur.
Lease Container Conteneur Établit et gère un verrou sur un conteneur pour les opérations de suppression.
Delete Container Conteneur Supprime le conteneur et tous les objets blob qu'il contient.
Lister les objets blob Conteneur Répertorie tous les objets blob dans un conteneur.
Put Blob Objets blob de blocs, d’ajouts et de pages Crée un nouvel objet blob ou remplace un objet blob existant au sein d'un conteneur.
Get Blob Objets blob de blocs, d’ajouts et de pages Lit ou télécharge un objet blob à partir du Stockage Blob, y compris ses métadonnées définies par l’utilisateur et ses propriétés système.
Get Blob Properties Objets blob de blocs, d’ajouts et de pages Renvoie toutes les propriétés système et les métadonnées définies par l'utilisateur dans l'objet blob.
Set Blob Properties Objets blob de blocs, d’ajouts et de pages Définit les propriétés système définies pour un objet blob existant.
Définir l’expiration de l’objet blob Objets blob de blocs Définit l’heure d’expiration d’un objet blob existant.
Get Blob Metadata Objets blob de blocs, d’ajouts et de pages Récupère toutes les métadonnées définies par l'utilisateur d'un objet blob ou d'un instantané existant.
Set Blob Metadata Objets blob de blocs, d’ajouts et de pages Définit les métadonnées définies par l'utilisateur d'un objet blob existant.
Obtenir les étiquettes d’objet blob Objets blob de blocs, d’ajouts et de pages Récupère les étiquettes définies par l’utilisateur d’un objet blob existant.
Définir des étiquettes d’objet blob Objets blob de blocs, d’ajouts et de pages Définit les balises définies par l’utilisateur d’un objet blob existant qui forment un index secondaire.
Rechercher des objets blob par étiquettes Objets blob de blocs, d’ajouts et de pages Listes les objets blob par leurs balises définies par l’utilisateur.
Delete Blob Objets blob de blocs, d’ajouts et de pages Marque un objet blob pour suppression.
Annuler la suppression d’un objet blob Objets blob de blocs, d’ajouts et de pages Restaure le contenu et les métadonnées d’un objet blob supprimé de manière réversible ou de tous les instantanés supprimés de manière réversible associés.
Bail Blob Objets blob de blocs, d’ajouts et de pages Établit et gère un verrou sur les opérations de lecture et de suppression. Pour supprimer ou écrire dans un objet blob verrouillé, un client doit fournir l'ID du bail.
Snapshot Blob Objets blob de blocs, d’ajouts et de pages Crée un instantané en lecture seule d'un objet blob.
Copy Blob Objets blob de blocs, d’ajouts et de pages Copie un objet blob source vers un objet blob de destination dans ce compte de stockage ou dans un autre.
Abort Copy Blob Objets blob de blocs, d’ajouts et de pages Arrête une opération en attente Copy Blob et laisse un objet blob de destination avec une longueur nulle et des métadonnées complètes.
Put Block Objets blob de blocs uniquement Crée un bloc à valider en tant qu’élément d’un objet blob de blocs.
Put Block From URL Objets blob de blocs uniquement Crée un bloc à commiter dans le cadre d’un objet blob de blocs où le contenu est lu à partir d’une URL.
Put Block List Objets blob de blocs uniquement Valide un objet blob en spécifiant le jeu d’ID de bloc composant cet objet blob de blocs.
Get Block List Objets blob de blocs uniquement Récupère la liste de blocs qui ont été téléchargés dans le cadre d'un objet blob de blocs.
Contenu de l’objet blob de requête Objets blob de blocs uniquement Applique une instruction langage SQL simple (SQL) sur le contenu d’un objet blob et retourne uniquement le sous-ensemble interrogé des données.
Set Blob Tier Objets blob de blocs et de pages Définit le niveau d’un objet blob.
Put Page Objets blob de pages uniquement Écrit une plage de pages dans un objet blob de pages.
Obtenir les portées de page Objets blob de pages uniquement Renvoie une liste des plages de page valides pour un objet blob de pages ou un instantané d'un objet blob de pages.
Copie incrémentielle BLOB Objets blob de pages uniquement Copie un instantané d’un objet blob de pages source dans un objet blob de page de destination. Seules les modifications différentielles sont transférées.
Append Block Objets blob d'ajout uniquement Écrit un bloc de données à la fin d’un objet blob d’ajout.

Contenu de cette section

Concepts du stockage Blob

Opérations sur le compte (Stockage Blob)

Opérations sur les conteneurs

Opérations sur les objets blob

Opérations sur les objets blob (comptes avec espace de noms hiérarchiques)

Voir aussi

REST des services de stockage