Obtention des statistiques du service de File d'attenteGet Queue Service Stats

L'opération Get Queue Service Stats récupère des statistiques relatives à la réplication pour le service de File d'attente.The Get Queue Service Stats operation retrieves statistics related to replication for the Queue service. Elle est uniquement disponible sur le point de terminaison d'emplacement secondaire lorsque la réplication géographique redondante avec accès en lecture est activée pour le compte de stockage.It is only available on the secondary location endpoint when read-access geo-redundant replication is enabled for the storage account.

RequêteRequest

La demande Get Queue Service Stats peut être construite comme indiqué ci-dessous.The Get Queue Service Stats request may be constructed as follows. HTTPS est recommandé.HTTPS is recommended. Remplacez myaccount par le nom de votre compte de stockage et notez que le suffixe -secondary est obligatoire :Replace myaccount with the name of your storage account, and note that the -secondary suffix is required:

MéthodeMethod URI de requêteRequest URI Version HTTPHTTP Version
GETGET https://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats HTTP/1.1HTTP/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 portions de requête de l'URI.Note that the URI must always include the forward slash (/) to separate the host name from the path and query portions of the URI. Dans le cadre de cette opération, la partie de chemin d'accès de l'URI est vide.In the case of this operation, the path portion of the URI is empty.

Paramètres URIURI Parameters

Les paramètres supplémentaires suivants peuvent être spécifiés dans l'URI de la demande.The following additional parameters may be specified on the request URI.

ParamètreParameter DescriptionDescription
Timeout facultatif.Optional. Le paramètre timeout est exprimé en secondes.The timeout parameter is expressed in seconds.

En-têtes de requêteRequest Headers

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.The following table describes required and optional request headers.

En-tête de requêteRequest Header DescriptionDescription
Authorization Obligatoire.Required. Spécifie le schéma d’autorisation, le nom de compte et la signature.Specifies the authorization scheme, account name, and signature. Pour plus d’informations, consultez autoriser les demandes dans le stockage Azure.For more information, see Authorize requests to Azure Storage.
Date or x-ms-date Obligatoire.Required. Spécifie la date/heure en temps universel coordonné (UTC) pour la requête.Specifies the Coordinated Universal Time (UTC) for the request. Pour plus d’informations, consultez autoriser les demandes dans le stockage Azure.For more information, see Authorize requests to Azure Storage.
x-ms-version Obligatoire pour toutes les demandes autorisées.Required for all authorized requests. Spécifie la version de l'opération à utiliser pour cette demande.Specifies the version of the operation to use for this request. Pour plus d’informations, consultez contrôle de version pour les services de stockage Azure.For more information, see Versioning for the Azure Storage services.
x-ms-client-request-id facultatif.Optional. Valeur opaque générée par le client avec une limite de 1 Ko qui est enregistrée dans les journaux d’analyse lorsque Storage Analytics la journalisation est activée.Client generated opaque value with 1KB character limit that is recorded in the analytics logs when Storage Analytics Logging is enabled. L'utilisation de cet en-tête est fortement recommandée pour une corrélation des activités du côté client avec les requêtes reçues par le serveur.The use of this header is highly recommended for correlating client side activities with requests received by the server. Pour plus d’informations, consultez journalisation Azure : utilisation des journaux pour suivre les demandes de stockage.For more information see Azure Logging: Using Logs to Track Storage Requests.

Corps de la requêteRequest Body

Aucun.None.

responseResponse

La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et un corps de réponse.The response includes an HTTP status code, a set of response headers, and a response body

Code d’étatStatus Code

Une opération réussie envoie le code d'état 200 (OK).A successful operation returns status code 200 (OK). Lorsqu'elle est appelée sur un point de terminaison d'emplacement secondaire qui n'est pas activé pour la lecture secondaire, elle renvoie le code d'état HTTP 403 avec l'erreur InsufficientAccountPermissions.When called on secondary location endpoint which is not enabled for secondary read, it will return Http status code of 403 with InsufficientAccountPermissions error.

En-têtes de réponseResponse Headers

La réponse de l'opération inclut les en-têtes suivants.The response for this operation includes the following headers. La réponse peut également inclure des en-têtes HTTP standard supplémentaires.The response also includes additional standard HTTP headers. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.All standard headers conform to the HTTP/1.1 protocol specification.

En-tête de réponseResponse Header DescriptionDescription
x-ms-request-id Cet en-tête identifie de façon unique la demande qui a été effectuée et peut être utilisé pour résoudre les problèmes de la demande.This header uniquely identifies the request that was made and can be used for troubleshooting the request. Pour plus d’informations, consultez Troubleshooting API Operations.For more information, see Troubleshooting API Operations.
x-ms-version Spécifie la version de l'opération utilisée pour la réponse.Specifies the version of the operation used for the response. Pour plus d’informations, consultez contrôle de version pour les services de stockage Azure.For more information, see Versioning for the Azure Storage services.
Date Une valeur de date/heure UTC générée par le service qui indique le moment auquel la réponse a été initiée.A UTC date/time value generated by the service that indicates the time at which the response was initiated.
x-ms-client-request-id Cet en-tête peut être utilisé pour dépanner les demandes et les réponses correspondantes.This header can be used to troubleshoot requests and corresponding responses. La valeur de cet en-tête est égale à la valeur x-ms-client-request-id de l’en-tête si elle est présente dans la demande et que la valeur est supérieure à 1024 caractères ASCII visibles.The value of this header is equal to the value of the x-ms-client-request-id header if it is present in the request and the value is at most 1024 visible ASCII characters. Si l' x-ms-client-request-id en-tête n’est pas présent dans la demande, cet en-tête ne sera pas présent dans la réponse.If the x-ms-client-request-id header is not present in the request, this header will not be present in the response.

Corps de la réponseResponse Body

Le corps de la réponse présente le format suivant :The format of the response body is as follows:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceStats>  
  <GeoReplication>        
      <Status>live|bootstrap|unavailable</Status>  
      <LastSyncTime>sync-time|<empty></LastSyncTime>  
  </GeoReplication>  
</StorageServiceStats>  

Le tableau suivant décrit les éléments du corps de la réponse :The following table describes the elements of the response body:

En-tête de réponseResponse Header DescriptionDescription
Status État de l'emplacement secondaire.The status of the secondary location. Les valeurs possibles sont les suivantes :Possible values are:

- live: Indique que l’emplacement secondaire est actif et opérationnel.- live: Indicates that the secondary location is active and operational.
- bootstrap: Indique que la synchronisation initiale de l’emplacement principal vers l’emplacement secondaire est en cours.- bootstrap: Indicates initial synchronization from the primary location to the secondary location is in progress. Cela se produit généralement lorsque la réplication est activée en premier.This typically occurs when replication is first enabled.
-indisponible : indique que l’emplacement secondaire est provisoirement indisponible.- unavailable: Indicates that the secondary location is temporarily unavailable.
LastSyncTime Valeur de date/heure GMT, à l'emplacement secondaire.A GMT date/time value, to the second. Toutes les écritures principales antérieures à cette valeur sont disponibles pour les opérations de lecture sur l'emplacement secondaire.All primary writes preceding this value are guaranteed to be available for read operations at the secondary. Il est possible que les écritures principales après ce stade ne soient pas disponibles pour les opérations de lecture.Primary writes after this point in time may or may not be available for reads.

La valeur peut être vide si LastSyncTime n'est pas disponible.The value may be empty if LastSyncTime is not available. Cela peut se produire si l'état de réplication est bootstrap ou unavailable.This can happen if the replication status is bootstrap or unavailable.

Bien que la réplication géographique soit activée en permanence, le résultat LastSyncTime peut refléter une valeur mise en cache à partir du service, qui est actualisée toutes les x minutes.Although geo-replication is continuously enabled, the LastSyncTime result may reflect a cached value from the service that is refreshed every few minutes.

AutorisationAuthorization

Seul le propriétaire du compte peut appeler cette opération.Only the account owner may call this operation.

NotesRemarks

Avec la réplication géographique redondante, le stockage Azure conserve vos données dans deux emplacements.With geo-redundant replication, Azure Storage maintains your data durable in two locations. Dans les deux emplacements, le stockage Azure conserve constamment plusieurs réplicas sains de vos données.In both locations, Azure Storage constantly maintains multiple healthy replicas of your data.

L'emplacement où vous lisez, créez, mettez à jour ou supprimez les données est l'emplacement du compte de stockage principal.The location where you read, create, update, or delete data is the primary storage account location. L’emplacement principal existe dans la région que vous choisissez au moment où vous créez un compte via le portail Azure Classic de gestion Azure, par exemple, nord du Centre des États-Unis.The primary location exists in the region you choose at the time you create an account via the Azure Management Azure classic portal, for example, North Central US. L'emplacement dans lequel vos données sont répliquées est l'emplacement secondaire.The location to which your data is replicated is the secondary location. L’emplacement secondaire se trouve dans une région qui est automatiquement associée à la région primaire.The secondary location resides in a region that is automatically geographically paired with the primary region. L'accès en lecture seule est disponible à partir de l'emplacement secondaire, si la réplication géographique redondante avec accès en lecture est activée pour votre compte de stockage.Read-only access is available from the secondary location, if read-access geo-redundant replication is enabled for your storage account. Pour plus d’informations sur la réplication géo-redondante avec accès en lecture, consultez le blog de l' équipe stockage Azure.For more details about read-access geo-redundant replication, see the Azure Storage Team Blog.

Pour construire une demande d'opération de lecture sur le point de terminaison secondaire, ajoutez -secondary comme suffixe au nom du compte dans l'URI que vous utilisez pour lire à partir du stockage de File d'attente.To construct a request for a read operation against the secondary endpoint, append -secondary as a suffix to the account name in the URI that you use to read from Queue storage. Par exemple, un URI secondaire pour l’opération de lecture de messages est semblable https://myaccount-secondary.queue.core.windows.net/myqueue/messages?peekonly=trueà.For example, a secondary URI for the Peek Messages operation will be similar to https://myaccount-secondary.queue.core.windows.net/myqueue/messages?peekonly=true.

Exemple de demande et de réponseSample Request and Response

Cet exemple illustre une demande de l'opération Get Queue Service Stats :The following is a sample request for the Get Queue Service Stats operation:

GET http://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats HTTP/1.1  

La demande est envoyée avec les en-têtes suivants :The request is sent with following headers:

x-ms-version: 2013-08-15  
x-ms-date: Wed, 23 Oct 2013 22:08:44 GMT  
Authorization: SharedKey myaccount:CY1OP3O3jGFpYFbTCBimLn0Xov0vt0khH/E5Gy0fXvg=  

Le code d'état et les en-têtes de réponse sont renvoyés comme suit :The status code and response headers are returned as follows:

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

Cette réponse comprend le corps XML suivant :The response includes the following XML body:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceStats>  
  <GeoReplication>  
      <Status>live</Status>  
      <LastSyncTime> Wed, 23 Oct 2013 22:05:54 GMT</LastSyncTime>        
  </GeoReplication>  
</StorageServiceStats>  

Voir aussiSee also

Opérations sur le compte (service de File d'attente)Operations on the Account (Queue Service)