Obtenir les propriétés du compte de stockage

 

Le Get Storage Account Properties opération retourne les propriétés système pour le compte de stockage spécifié.

Demande

Le Get Storage Account Properties demande peut être spécifiée comme suit. Remplacez <subscription-id> par votre ID d'abonnement et <storage-account-name> avec le nom du compte de stockage.

Méthode	URI de demande
GET	https://management.core.windows.net/<subscription-id>/services/storageservices/<storage-account-name>

Vous devez vous assurer que la demande adressée au service de gestion est sécurisée. Pour plus d'informations, consultez authentification des demandes de Service de gestion.

Paramètres URI

Aucun.

En-têtes de demande

Le tableau suivant décrit les en-têtes de la demande.

En-tête de demande	Description
x-ms-version	Obligatoire. Spécifie la version de l'opération à utiliser pour cette demande. Cet en-tête doit être défini sur 2009-10-01 ou une version ultérieure. Pour plus d'informations sur les en-têtes de contrôle de version, consultez Versioning de gestion de Service.

Corps de la demande

Aucun.

Réponse

La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et un corps 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 d'état, consultez état de gestion de Service et les 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 aussi 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	Valeur qui identifie de façon unique une demande effectuée au service de gestion.

Corps de la réponse

Le corps de la réponse présente le format suivant :

  
<?xml version="1.0" encoding="utf-8"?> <StorageService xmlns="https://schemas.microsoft.com/windowsazure"> <Url>storage-account-request-uri</Url> <ServiceName>storage-account-name</ServiceName> <StorageServiceProperties> <Description>description</Description> <AffinityGroup>affinity-group</AffinityGroup> <Location>location</Location> <Label>base64-encoded-label</Label> <Status>status</Status> <Endpoints> <Endpoint>storage-service-blob-endpoint</Endpoint> <Endpoint>storage-service-queue-endpoint</Endpoint> <Endpoint>storage-service-table-endpoint</Endpoint> <Endpoint>storage-service-file-endpoint</Endpoint> </Endpoints> <GeoReplicationEnabled>geo-replication-indicator</GeoReplicationEnabled> <GeoPrimaryRegion>primary-region</GeoPrimaryRegion> <StatusOfPrimary>primary-status</StatusOfPrimary> <LastGeoFailoverTime>DateTime</LastGeoFailoverTime> <GeoSecondaryRegion>secondary-region</GeoSecondaryRegion> <StatusOfSecondary>secondary-status</StatusOfSecondary> <CreationTime>time-of-creation</CreationTime> <CustomDomains> <CustomDomain> <Name>name-of-custom-domain</Name> </CustomDomain> </CustomDomains> <SecondaryReadEnabled>secondary-read-indicator</SecondaryReadEnabled> <SecondaryEndpoints> <Endpoint>storage-secondary-service-blob-endpoint</Endpoint> <Endpoint>storage-secondary-service-queue-endpoint</Endpoint> <Endpoint>storage-secondary-service-table-endpoint</Endpoint> </SecondaryEndpoints> <AccountType>type-of-storage-account</AccountType> </StorageServiceProperties> <ExtendedProperties> <ExtendedProperty> <Name>property-name</Name> <Value>property-value</Value> </ExtendedProperty> </ExtendedProperties> <Capabilities> <Capability>storage-account-capability</Capability> </Capabilities> </StorageService>  
  

Le tableau suivant décrit les éléments du corps de la réponse.

Nom de l'élément	Description
Url	Spécifie l'URI du compte de stockage.
ServiceName	Spécifie le nom du compte de stockage. Ce nom est le nom du préfixe DNS et peut être utilisé pour accéder aux objets blob, aux files d'attente, et aux tables dans le compte de stockage. Par exemple, si le nom du service est MyStorageAccount vous pouviez accéder à des conteneurs d'objets blob en appelant : http://MyStorageAccount.blob.core.windows.net/mycontainer/
StorageServiceProperties	Spécifie les propriétés du compte de stockage.
ExtendedProperties	Spécifie le nom et la valeur d'une propriété étendue qui a été ajoutée au compte de stockage.
Fonctionnalité	Indique si le compte de stockage peut exécuter des opérations associées à la machine virtuelle. Si oui, cet élément retourne une chaîne contenant PersistentVMRole. Sinon, cet élément n'est pas présent. Le Capability élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure.

StorageServiceProperties

Spécifie les propriétés du compte de stockage.

Nom de l'élément	Description
Description	Facultatif. Description du compte de stockage. La description peut avoir une longueur de 1024 caractères au maximum. Le Description élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure.
AffinityGroup	Requis si Location n'est pas spécifié. Nom d'un groupe d'affinités existant associé à cet abonnement. Ce nom est un GUID et peut être récupéré en examinant l'élément nom du corps de la réponse retourné par le Liste des groupes d'affinités opération. Le AffinityGroup élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure.
Emplacement	Requis si AffinityGroup n'est pas spécifié. Emplacement où le compte de stockage est créé. Le Location élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure.
Étiquette	Obligatoire. Nom du service hébergé qui est codé en base 64. Le nom peut avoir une longueur de 100 caractères au maximum. Le nom peut être utilisé pour identifier le compte de stockage à des fins de suivi. Le Label élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure.
État	État du compte de stockage. Les valeurs possibles sont les suivantes : - Creating - Created - Deleting - Deleted - Changing - ResolvingDns Le Status élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure.
Points de terminaison	Les points de terminaison d'objet blob, de table, de file d'attente et de fichier. Remarque 1 : le point de terminaison de fichier est en mode préliminaire, et est renvoyé uniquement pour les abonnements en version préliminaire. Remarque 2 : pour le type de compte Standard_ZRS, seul le point de terminaison d'objet blob est renvoyé. En outre, ZRS prend uniquement en charge des objets blob de blocs, pas les objets blob de pages. Il n'est donc pas compatible avec des machines virtuelles IaaS. Remarque 3 : pour le type de compte Premium_LRS, seul le point de terminaison d'objet blob est renvoyé.
GeoReplicationEnabled	Indique si les données dans le compte de stockage sont répliquées entre plusieurs emplacements géographiques pour permettre la résilience en cas de perte catastrophique de service. La valeur est true Si géo-réplication est activée ; sinon false. Le GeoReplicationEnabled élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure et est remplacé par l'élément AccountType de version 2014-06-01 ou une version ultérieure.
GeoPrimaryRegion	Indique la région géographique principale dans laquelle le compte de stockage existe à l'heure actuelle. Le GeoPrimaryRegion élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure.
StatusOfPrimary	Indique si la région de stockage principale est disponible. Les valeurs possibles sont les suivantes : - Available - Unavailable Le StatusOfPrimary élément est uniquement disponible si vous utilisez la version 2013-11-01 ou une version ultérieure.
LastGeoFailoverTime	Horodateur qui indique l'instance la plus récente d'un basculement sur la région secondaire. En cas de plusieurs basculements, seules la dernière date et heure de basculement sont conservées. Le format de l'horodatage retourné est : [Année en 4 chiffres] - [Mois en 2 chiffres] - [Jour en 2 chiffres] T [Minutes en 2 chiffres] : [Secondes en 2 chiffres] : [7 chiffres de précision] Z Par exemple : < LastGeoFailoverTime > 2010-01-18T13:15:30.0000000Z < / LastGeoFailoverTime > LastGeoFailoverTime n'est pas renvoyé s'il n'existe aucune instance d'un basculement. Le LastGeoFailoverTime élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure.
GeoSecondaryRegion	Indique la région géographique dans laquelle le compte de stockage est répliqué. L'élément GeoSecondaryRegion n'est pas renvoyé si la géo-réplication est désactivée pour ce compte. Le GeoSecondaryRegion élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure.
StatusOfSecondary	Indique si la région de stockage secondaire est disponible. Les valeurs possibles sont les suivantes : - Available - Unavailable Le StatusOfSecondary élément est uniquement disponible si vous utilisez la version 2013-11-01 ou une version ultérieure.
CreationTime	Spécifie l'heure de création du compte de stockage.
CustomDomains	Spécifie les domaines personnalisés qui sont associés au compte de stockage. Le CustomDomains élément est uniquement disponible si vous utilisez la version 2013-06-01 ou une version ultérieure.
SecondaryReadEnabled	Indique que la lecture secondaire est activée pour le compte de stockage. Les valeurs possibles sont les suivantes : - true - false Le SecondaryReadEnabled élément est uniquement disponible si vous utilisez la version 2013-11-01 ou une version ultérieure et est remplacé par l'élément AccountType de version 2014-06-01 ou une version ultérieure.
SecondaryEndpoints	Spécifie les points de terminaison secondaires du compte de stockage. Le SecondaryEndpoints élément est uniquement disponible si vous utilisez la version 2013-11-01 ou une version ultérieure.
AccountType	Indique si le compte prend en charge le stockage localement redondant, le stockage géo-redondant, le stockage à redondance de zone ou le stockage géo-redondant avec accès en lecture. Les valeurs possibles sont les suivantes : - Standard_LRS - Standard_ZRS - Standard_GRS - Standard_RAGRS - Premium_LRS Le AccountType élément est uniquement disponible si vous utilisez la version 2014-06-01 ou une version ultérieure, et il remplace les éléments SecondaryReadEnabled et GeoReplicationEnabled. Le Premium_LRS élément est uniquement disponible si vous utilisez la version 2014-10-01 ou une version ultérieure.

Points de terminaison

Spécifie les points de terminaison du compte de stockage.

Nom de l'élément	Description
Point de terminaison	Contient le point de terminaison du service blob dans le format suivant : https:// <storage-service-name>.blob.core.windows.net Le Endpoint élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure. Les points de terminaison HTTP renvoyés affichent une version 2014-04-01 ou antérieure.
Point de terminaison	Contient le point de terminaison du service de file d'attente dans le format suivant : https:// <storage-service-name>.queue.core.windows.net Le Endpoint élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure. Les points de terminaison HTTP renvoyés affichent une version 2014-04-01 ou antérieure.
Point de terminaison	Contient le point de terminaison du service de table dans le format suivant : https://<storage-service-name>.table.core.windows.net Le Endpoint élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure. Les points de terminaison HTTP renvoyés affichent une version 2014-04-01 ou antérieure.
Point de terminaison	Contient le point de terminaison du service de fichier au format suivant : https://<storage-service-name>.file.core.windows.net Le Endpoint élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure. Les points de terminaison HTTP renvoyés affichent une version 2014-04-01 ou antérieure.

CustomDomains

Spécifie les domaines personnalisés qui sont associés au compte de stockage.

Nom de l'élément	Description
CustomDomain	Spécifie des informations sur un domaine personnalisé qui est associé au compte de stockage.
Nom	Spécifie le nom du domaine personnalisé.

SecondaryEndpoints

Spécifie les points de terminaison secondaires du compte de stockage.

Nom de l'élément	Description
Point de terminaison	Contient le point de terminaison de service secondaire blob dans le format suivant : https://<storage-secondary-service-name>.blob.core.windows.net Les points de terminaison HTTP renvoyés affichent une version 2014-04-01 ou antérieure.
Point de terminaison	Contient le point de terminaison du service de file d'attente dans le format suivant : https://<storage-secondary-service-name>.queue.core.windows.net Les points de terminaison HTTP renvoyés affichent une version 2014-04-01 ou antérieure.
Point de terminaison	Contient le point de terminaison du service de table dans le format suivant : https://<storage-secondary-service-name>.table.core.windows.net Les points de terminaison HTTP renvoyés affichent une version 2014-04-01 ou antérieure.

ExtendedProperties

Spécifie le nom et la valeur d'une propriété étendue qui a été ajoutée au compte de stockage.

Nom de l'élément	Description
Nom	Facultatif. Représente le nom d'une propriété étendue du compte de stockage. Chaque propriété étendue doit avoir un nom et une valeur définis. Vous pouvez avoir un maximum de 50 propriétés étendues de paires nom/valeur. La longueur maximale de l'élément Nom est de 64 caractères, seuls les caractères alphanumériques et les traits de soulignement sont valides dans Nom, et le nom doit commencer par une lettre. Toute tentative d'utiliser d'autres caractères, en commençant le Nom par un caractère autre qu'une lettre, ou en entrant un nom qui est identique à celui d'une autre propriété étendue détenue par le même compte de stockage, provoque une erreur de code d'état 400 (erreur de mauvaise demande). Le Name élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure.
Valeur	Facultatif. Représente la valeur d'une propriété étendue du compte de stockage. Chaque propriété étendue doit avoir un nom et une valeur définis. Vous pouvez avoir 50 paires nom/valeur de propriété étendue au maximum, et chaque valeur de propriété étendue doit avoir une taille maximale de 255 caractères. Le Value élément est uniquement disponible si vous utilisez la version 2012-03-01 ou une version ultérieure.

Remarques

La géo-réplication peut être activée lorsque vous créez ou mettez à jour un compte de stockage.

Si la x-ms-version est 2012-03-01 ou une version ultérieure et le groupe d'affinités a été créé dans un des Anywhere US, Anywhere Europe, Anywhere Asia des régions, le Location élément retourne l'emplacement où le groupe d'affinités est alloué.

Exemple

L'exemple de programme suivant prend l'ID d'abonnement, une empreinte numérique de certificat de gestion associée, la chaîne de version d'opération et un nom de compte de stockage, et affiche les propriétés du compte de stockage retournées dans la console. Initialiser le msVersion, subscriptionId, thumbprint et serviceName variables avec vos propres valeurs pour exécuter l'exemple de code.

using System; using System.Collections.Generic; using System.Net; using System.Security.Cryptography.X509Certificates; using System.Xml; using System.Xml.Linq; class Program { static void Main(string[] args) { string msVersion = "2011-12-01"; string subscriptionId = "subscription-id-guid"; string thumbprint = "certificate-thumbprint"; string serviceName = "myexamplestorage1"; try { // Obtain the certificate with the specified thumbprint X509Certificate2 certificate = GetCertificate(thumbprint); GetStorageAccountPropertiesExample( subscriptionId, certificate, msVersion, serviceName); } catch (Exception ex) { Console.WriteLine("Exception caught in Main:"); Console.WriteLine(ex.Message); } } public static X509Certificate2 GetCertificate(string thumbprint) { List<StoreLocation> locations = new List<StoreLocation> { StoreLocation.CurrentUser, StoreLocation.LocalMachine }; foreach (var location in locations) { X509Store store = new X509Store("My", location); try { store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly); X509Certificate2Collection certificates = store.Certificates.Find( X509FindType.FindByThumbprint, thumbprint, false); if (certificates.Count == 1) { return certificates[0]; } } finally { store.Close(); } } throw new ArgumentException(string.Format( "A certificate with thumbprint '{0}' could not be located.", thumbprint)); } public static void GetStorageAccountPropertiesExample( string subscriptionId, X509Certificate2 certificate, string version, string serviceName) { string uriFormat = "https://management.core.windows.net/{0}/services/storageservices/{1}"; Uri uri = new Uri(String.Format(uriFormat, subscriptionId, serviceName)); HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(uri); request.Method = "GET"; request.Headers.Add("x-ms-version", version); request.ClientCertificates.Add(certificate); request.ContentType = "application/xml"; XDocument responseBody = null; HttpStatusCode statusCode; HttpWebResponse response; try { response = (HttpWebResponse)request.GetResponse(); } catch (WebException ex) { // GetResponse throws a WebException for 400 and 500 status codes response = (HttpWebResponse)ex.Response; } statusCode = response.StatusCode; if (response.ContentLength > 0) { using (XmlReader reader = XmlReader.Create(response.GetResponseStream())) { responseBody = XDocument.Load(reader); } } response.Close(); if (statusCode.Equals(HttpStatusCode.OK)) { XNamespace wa = "https://schemas.microsoft.com/windowsazure"; XElement storageService = responseBody.Element(wa + "StorageService"); Console.WriteLine( "Storage Account Properties for {0}:{1}{2}", serviceName, Environment.NewLine, storageService.ToString(SaveOptions.OmitDuplicateNamespaces)); } else { Console.WriteLine("Call to GetStorageAccountProperties returned an error:"); Console.WriteLine("Status Code: {0} ({1}):{2}{3}", (int)statusCode, statusCode, Environment.NewLine, responseBody.ToString(SaveOptions.OmitDuplicateNamespaces)); } return; } }