Obtenir des informations de compte

  • Article

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.

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.

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.