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é.

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éthodeURI de demande
GEThttps://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 demandeDescription
x-ms-versionObligatoire. 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.

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éponseDescription
x-ms-request-idValeur 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="http://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émentDescription
UrlSpécifie l'URI du compte de stockage.
ServiceNameSpé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/
StorageServicePropertiesSpécifie les propriétés du compte de stockage.
ExtendedPropertiesSpé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émentDescription
DescriptionFacultatif. 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.
AffinityGroupRequis 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.
EmplacementRequis 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.
ÉtiquetteObligatoire. 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 terminaisonLes 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é.
GeoReplicationEnabledIndique 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.
GeoPrimaryRegionIndique 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.
StatusOfPrimaryIndique 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.
LastGeoFailoverTimeHorodateur 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.
GeoSecondaryRegionIndique 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.
StatusOfSecondaryIndique 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.
CreationTimeSpécifie l'heure de création du compte de stockage.
CustomDomainsSpé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.
SecondaryReadEnabledIndique 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.
SecondaryEndpointsSpé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.
AccountTypeIndique 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émentDescription
Point de terminaisonContient 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 terminaisonContient 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 terminaisonContient 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 terminaisonContient 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émentDescription
CustomDomainSpécifie des informations sur un domaine personnalisé qui est associé au compte de stockage.
NomSpécifie le nom du domaine personnalisé.

SecondaryEndpoints

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

Nom de l'élémentDescription
Point de terminaisonContient 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 terminaisonContient 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 terminaisonContient 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émentDescription
NomFacultatif. 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.
ValeurFacultatif. 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.

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é.

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 = "http://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; } }  
  

Afficher: