Obtenir des informations de compte

L’opération Get Account Information retourne le nom de la référence SKU et le type de compte pour le compte spécifié. Il est disponible sur la version 2018-03-28 et les versions ultérieures du service.

Requête

Vous pouvez construire la demande à l’aide Get Account Information d’une demande valide autorisée par le biais d’une autorisation de clé partagée ou de signature d’accès partagé (SAP).

Si vous ajoutez une restype valeur de account et une comp valeur de properties, la demande utilise l’opération Get Account Information . Le tableau suivant présente des exemples :

Méthode	URI de demande	Version HTTP
GET/HEAD	https://myaccount.blob.core.windows.net/?restype=account&comp=properties	HTTP/1.1
GET/HEAD	https://myaccount.blob.core.windows.net/?restype=account&comp=properties&sv=myvalidsastoken	HTTP/1.1
GET/HEAD	https://myaccount.blob.core.windows.net/mycontainer/?restype=account&comp=properties&sv=myvalidsastoken	HTTP/1.1
GET/HEAD	https://myaccount.blob.core.windows.net/mycontainer/myblob?restype=account&comp=properties&sv=myvalidsastoken	HTTP/1.1

Paramètres URI

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

Paramètre	Description
restype	Obligatoire. La valeur du restype paramètre doit être account.
comp	Obligatoire. La valeur du comp paramètre doit être properties.

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 requêtes auprès du Stockage Azure.
Date or 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. Spécifie la version de l'opération à utiliser pour cette demande. Pour cette opération, la version doit être 2018-03-28 ou ultérieure. Pour plus d'informations, consultez la page Contrôle de version pour les services de Stockage Microsoft Azure.
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 que le serveur reçoit.

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 envoie le code d'état 200 (OK).

Pour plus d’informations sur les codes status, consultez Codes d’état et 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	Identifie de manière unique la demande qui a été effectuée. Vous pouvez l’utiliser pour résoudre les problèmes liés à la demande. Pour plus d’informations, consultez Résoudre les problèmes liés aux opérations d’API.
x-ms-version	Version 2009-09-19 et ultérieures. Indique la version de Stockage Blob Azure utilisée pour exécuter la demande.
Date	Valeur de date/heure UTC qui indique l’heure à laquelle le service a envoyé la réponse.
Content-Length	Spécifie la longueur du corps de la demande. Pour cette opération, la longueur du contenu est toujours égale à zéro.
x-ms-sku-name	Identifie le nom de la référence SKU du compte spécifié.
x-ms-account-kind	Identifie le type de compte du compte spécifié. Les valeurs possibles sont : Storage, BlobStorage et StorageV2. L’en-tête fait la distinction entre les comptes de stockage usage général v1 (GPv1) et usage général v2 (GPv2) à l’aide de la sous-chaîne V2 pour les comptes GPv2.
x-ms-client-request-id	Peut être utilisé pour résoudre les problèmes liés aux demandes et aux réponses correspondantes. La valeur de cet en-tête est égale à la valeur de l’en-tête x-ms-client-request-id , si elle est présente dans la requête et que 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 demande, cet en-tête ne sera pas présent dans la réponse.
x-ms-is-hns-enabled	Version 2019-07-07 et ultérieure. Indique si un espace de noms hiérarchique est activé pour le compte.

Response body

Aucun.

Exemple de réponse

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Date: Sat, 28 Mar 2018 12:43:08 GMT  
x-ms-version: 2018-03-28  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
Content-Length: 0  
x-ms-sku-name: Standard_LRS  
x-ms-account-kind: StorageV2  

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 Get Account Information comme décrit ci-dessous.

Cette opération ne prend pas en charge l’autorisation OAuth via un jeton d’accès d’Azure Active Directory/MSI ou une SAP de délégation d’utilisateur.

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 disposez d’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 dispose sur ces ressources et la durée de validité de la signature d’accès partagé.

L’opération Get Account Information prend en charge l’autorisation à l’aide d’une SAP de compte ou d’une SAP de service avec au moins une autorisation disponible.

SAP de compte

Une SAP de compte est sécurisée à l’aide de la clé de compte de stockage. Une SAP de compte délègue l’accès aux ressources d’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.

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

SAP de service

Une SAP de service est sécurisée à l’aide de la clé de compte de stockage. Une SAP de service délègue l’accès à une ressource dans un seul service de stockage Azure, tel que le stockage d’objets blob.

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

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

Clé partagée

L’opération Get Account Information prend en charge l’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 d’interdire l’autorisation de clé partagée pour le compte de stockage lorsque cela est possible. Pour plus d’informations, consultez Empêcher l’autorisation avec une clé partagée.

Remarques

Le chemin d’URL de la demande n’affecte pas les informations fournies par cette opération. Son objectif est de permettre à la demande d’autoriser correctement avec un jeton SAP qui spécifie la ressource autorisée.

La ressource spécifiée n’a pas besoin d’exister pour que cette opération réussisse. Par exemple, un jeton SAP généré avec un objet blob inexistant et des autorisations valides réussit avec un chemin d’URL qui inclut le nom de compte correct, le nom du conteneur correct et le nom de l’objet blob inexistant.

Facturation

Les demandes de tarification peuvent provenir de clients qui utilisent des API Stockage Blob, soit directement via l’API REST Stockage Blob, soit à partir d’une bibliothèque cliente stockage Azure. Ces demandes cumulent des frais par transaction. Le type de transaction affecte la façon dont le compte est facturé. Par exemple, les transactions de lecture sont comptabilisées dans une catégorie de facturation différente de celle des transactions en écriture. Le tableau suivant montre la catégorie de facturation pour Get Account Information les demandes en fonction du type de compte de stockage :

Opération	Type de compte de stockage	Catégorie de facturation
Obtenir des informations sur le compte	Objet blob de blocs Premium Usage général v2 Standard	Autres opérations
Obtenir des informations sur le compte	Usage général v1 standard	Lire les opérations

Pour en savoir plus sur la tarification de la catégorie de facturation spécifiée, consultez Stockage Blob Azure Tarification.