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
Opérations sur le compte (Stockage Blob)
Opérations sur les objets blob
Opérations sur les objets blob (comptes avec espace de noms hiérarchiques)