Exporter (0) Imprimer
Développer tout

Get Blob Service Properties

Mis à jour: décembre 2013

L'opération Get Blob Service Properties obtient les propriétés du service BLOB d'un compte de stockage, notamment les propriétés des règles Storage Analytics et CORS (Partage des ressources cross-origin).

Pour plus d'informations sur les règles CORS et la logique d'évaluation, consultez Prise en charge du service Partage des ressources cross-origine (CORS) pour les services de stockage Azure.

La requête Get Blob Service Properties peut être spécifiée comme suit. HTTPS est recommandé. Remplacez <account-name> par le nom de votre compte de stockage :

 

Méthode URI de demande Version HTTP

GET

https://<account-name>.blob.core.windows.net/?restype=service&comp=properties

HTTP/1.1

Notez que l'URI doit toujours inclure la barre oblique (/) pour séparer le nom d'hôte du chemin d'accès et les parties de requête de l'URI. Dans le cadre de cette opération, la partie de chemin d'accès de l'URI est vide.

 

Paramètre d'URI Description

restype=service&comp=properties

Obligatoire. La combinaison des deux chaînes de requête est requise pour obtenir les propriétés de service de stockage.

timeout

Ce paramètre est facultatif. Le paramètre timeout est exprimé en secondes. Pour plus d'informations, consultez Définition de délais d'expiration pour les opérations du service BLOB.

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.

 

En-tête de demande Description

Authorization

Obligatoire. Spécifie le schéma d'authentification, le nom de compte de stockage et la signature. Pour plus d'informations, consultez Authentification pour les services de stockage Azure.

Date - ou - x-ms-date

Obligatoire. Spécifie le temps universel coordonné (UTC) pour la demande. Pour plus d'informations, consultez Authentification pour les services de stockage Azure.

x-ms-version

Obligatoire pour toutes les demandes authentifiées. Spécifie la version de l'opération à utiliser pour cette demande. Pour plus d'informations, consultez Contrôle de version pour les services de stockage Azure.

x-ms-client-request-id

Ce paramètre est facultatif. Fournit une valeur opaque générée par le client avec une limite de caractère de 1 Ko qui est enregistrée dans les journaux d'analyse quand la journalisation de l'analyse de stockage est activée. L'utilisation de cet en-tête est recommandée pour la corrélation des activités côté client avec les requêtes reçues par le serveur. Pour plus d'informations, consultez À propos de la journalisation Storage Analytics et Journalisation du stockage Windows Azure : utilisation des journaux pour suivre les demandes de stockage.

La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et un corps de réponse.

Une opération ayant réussi retourne le code d'état 200 (OK).

Pour plus d'informations sur les codes d'état, consultez Codes d'état et d'erreur de la gestion des services.

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

Une valeur qui identifie de façon unique une demande faite au service.

x-ms-version

Spécifie la version de l'opération utilisée pour la réponse. Pour plus d'informations, consultez Contrôle de version pour les services de stockage Azure.

Le format du corps de la réponse pour la version 2012-02-12 et les versions antérieures est le suivant :

<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
    <Logging>
        <Version>version-number</Version>
        <Delete>true|false</Delete>
        <Read>true|false</Read>
        <Write>true|false</Write>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </Logging>
    <Metrics>
        <Version>version-number</Version>
        <Enabled>true|false</Enabled>
        <IncludeAPIs>true|false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </Metrics>
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
</StorageServiceProperties>

Le format du corps de la réponse à partir de la version 2013-08-15 est le suivant :


<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
    <Logging>
        <Version>version-number</Version>
        <Delete>true|false</Delete>
        <Read>true|false</Read>
        <Write>true|false</Write>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </Logging>
    <HourMetrics>
        <Version>version-number</Version>
        <Enabled>true|false</Enabled>
        <IncludeAPIs>true|false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </HourMetrics>
    <MinuteMetrics>
        <Version>version-number</Version>
        <Enabled>true|false</Enabled>
        <IncludeAPIs>true|false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </MinuteMetrics>
    <Cors>
        <CorsRule>
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>
            <AllowedMethods>comma-separated-list-of-HTTP-verb</AllowedMethods>
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>
            <ExposedHeaders>comma-seperated-list-of-response-headers</ExposedHeaders>
            <AllowedHeaders> comma-seperated-list-of-request-headers </AllowedHeaders>
        </CorsRule>
    </Cors>
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
</StorageServiceProperties>

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

 

Nom de l'élément Description

Journalisation

Regroupe les paramètres Logging d'analyse Windows Azure.

Métriques

Regroupe les paramètres Metrics d'analyse Windows Azure. Les paramètres Métriques fournissent un résumé des statistiques de demande regroupées par l'API en agrégats horaires des objets blob.

HourMetrics

Regroupe les paramètres HourMetrics d'analyse Windows Azure. Les paramètres HourMetrics fournissent un résumé des statistiques de demande regroupées par l'API en agrégats horaires des objets blob.

MinuteMetrics

Regroupe les paramètres MinuteMetrics d'analyse Windows Azure. Les paramètres MinuteMetrics fournissent des statistiques de demande pour chaque minutes des objets blob.

Version

Version de Storage Analytics utilisée.

Supprimer

S'applique uniquement à la configuration de journalisation. Indique si toutes les demandes de suppression sont journalisées.

Lire

S'applique uniquement à la configuration de journalisation. Indique si toutes les demandes de lecture sont journalisées.

Write

S'applique uniquement à la configuration de journalisation. Indique si toutes les demandes d'écriture sont journalisées.

Activé

Indique si les métriques sont activées pour le service BLOB.

Si la réplication géographique redondante avec accès en lecture est activée, les métriques primaires et secondaires sont collectées. Si la réplication géographique redondante avec accès en lecture n'est pas activée, seules les métriques primaires sont collectées.

IncludeAPIs

S'applique uniquement à la configuration des métriques. Indique si les métriques génèrent des statistiques de synthèse pour les opérations d'API appelées.

RetentionPolicy/Enabled

Indique si une stratégie de rétention est activée pour le service de stockage.

RetentionPolicy/Days

Indique le nombre de jours pendant lesquels les métriques ou les données de journalisation sont conservées. Toutes les données plus anciennes que cette valeur seront supprimées.

DefaultServiceVersion

DefaultServiceVersion indique la version par défaut à utiliser pour les demandes au service BLOB si une version de demande entrante n'est pas indiquée. Les valeurs comprennent la version du 27/10/2008 et les versions les plus récentes. Pour plus d'informations sur les versions applicables, consultez Contrôle de version pour les services de stockage Azure.

Cors

Regroupe toutes les règles CORS.

CorsRule

Regroupe les paramètres d'une règle CORS.

AllowedOrigins

Liste séparée par des virgules de domaines d'origine qui sont autorisés via les règles CORS, ou « * » si tous les domaines sont autorisés.

ExposedHeaders

Liste séparée par des virgules d'en-têtes de réponse à exposer aux clients CORS.

MaxAgeInSeconds

Nombre de secondes pendant lequel le client/navigateur doit mettre en cache une réponse préliminaire.

AllowedHeaders

Liste séparées par des virgules d'en-têtes autorisés à faire partie de la requête cross-origin.

AllowedMethods

Liste séparée par des virgules de méthodes HTTP qui sont autorisées à être exécutées par l'origine. Pour Windows Azure Storage, les méthodes autorisées sont DELETE, GET, HEAD, MERGE, POST, OPTIONS ou PUT.

Seul le propriétaire du compte de stockage peut appeler cette opération.

L'exemple d'URI suivant demande les propriétés du service BLOB pour le compte de stockage fictif nommé myaccount :

GET https://myaccount.blob.core.windows.net/?restype=service&comp=properties HTTP/1.1

La demande est envoyée avec les en-têtes suivants :

x-ms-version: 2013-08-15
x-ms-date: Wed, 23 Oct 2013 04:28:19 GMT
Authorization: SharedKey
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=
Host: myaccount.blob.core.windows.net

Une fois la demande envoyée, la réponse suivante est retournée :

HTTP/1.1 200 OK
Content-Length: 1020
Content-Type: application/xml
Date: Wed, 23 Oct 2013 04:28:20 GMT
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30
x-ms-version: 2013-08-15

Cette réponse comprend le corps XML suivant :

<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
    <Logging>
        <Version>1.0</Version>
        <Delete>true</Delete>
        <Read>false</Read>
        <Write>true</Write>
        <RetentionPolicy>
            <Enabled>true</Enabled>
            <Days>7</Days>
        </RetentionPolicy>
    </Logging>
    <HourMetrics>
        <Version>1.0</Version>
        <Enabled>true</Enabled>
        <IncludeAPIs>false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true</Enabled>
            <Days>7</Days>
        </RetentionPolicy>
    </HourMetrics>
    <MinuteMetrics>
        <Version>1.0</Version>
        <Enabled>true</Enabled>
        <IncludeAPIs>true</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true</Enabled>
            <Days>7</Days>
        </RetentionPolicy>
    </MinuteMetrics>
    <Cors>
        <CorsRule>
      <AllowedOrigins> http://www.fabrikam.com,http://www.contoso.com</AllowedOrigins>
      <AllowedMethods>GET,PUT</AllowedMethods>
      <MaxAgeInSeconds>500</MaxAgeInSeconds>
      <ExposedHeaders>x-ms-meta-data*,x-ms-meta-customheader</ExposedHeaders>
      <AllowedHeaders>x-ms-meta-target*,x-ms-meta-customheader</AllowedHeaders>
  </CorsRule>
    </Cors>
    <DefaultServiceVersion>2013-08-15</DefaultServiceVersion>
</StorageServiceProperties>

Voir aussi

Afficher:
© 2014 Microsoft