VENTES: 1-800-867-1389
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Peek Messages

 

Cette opération récupère un ou plusieurs messages du début de la file d'attente, mais ne modifie pas la visibilité du message.

Le Peek Messages demande peut être construite comme suit. HTTPS est recommandé. Remplacez MONCOMPTE avec le nom de votre compte de stockage et myqueue avec le nom de votre file d'attente :

Méthode

URI de demande

Version HTTP

GET

https://myaccount.queue.core.windows.net/myqueue/messages?peekonly=true

HTTP/1.1

Lorsque vous élaborez une demande auprès du service de stockage émulé, spécifiez le nom d'hôte de l'émulateur et le port de service de file d'attente en tant que 127.0.0.1:10001, suivie du nom de compte de stockage émulé :

Méthode

URI de demande

Version HTTP

GET

http://127.0.0.1:10001/devstoreaccount1/myqueue/messages?peekonly=true

HTTP/1.1

Les paramètres suivants peuvent être spécifiés dans l'URI de la demande.

Paramètre

Description

numofmessages

Facultatif. Une valeur entière différente de zéro qui spécifie le nombre de messages à examiner à partir de la file d'attente, avec un maximum de 32. Par défaut, cette opération ne donne un aperçu que d'un seul message de la file d'attente.

timeout

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

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 du compte et la signature. Pour plus d'informations, consultez Authentification pour les services Azure Storage.

Masquer ou restaurer les mises à jour

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

x-ms-version

Facultatif. Spécifie la version de l'opération à utiliser pour cette demande. Pour plus d'informations, consultez Contrôle de version des services BLOB, de File d'attente et de Table dans Windows Azure.

x-ms-client-request-id

Facultatif. Fournit une valeur opaque générée par le client avec une limite de caractère de 1 Ko enregistrée dans les journaux d'analyse lorsque la journalisation de l'analyse de stockage est activée. 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. Pour plus d'informations, consultez À propos de la journalisation Storage Analytics et journalisation Azure : à l'aide de 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 XML.

Une opération réussie envoie le code d'état 200 (OK).

Pour plus d'informations sur les codes d'état, consultez Codes d'état et d'erreur.

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

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. Pour plus d'informations, consultez Dépannage des opérations de l'API.

x-ms-version

Indique la version du service de File d'attente utilisé pour exécuter la demande. Cet en-tête est renvoyé pour les demandes effectuées avec la version 2009-09-19 ou une version ultérieure.

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.

La réponse XML pour le Peek Messages opération est retournée sous la forme suivante.

Le MessageID élément est une valeur GUID qui identifie le message dans la file d'attente. Cette valeur est assignée au message par le service de File d'attente et est opaque au client.

Le InsertionTime et ExpirationTime éléments sont représentés en tant que valeurs UTC et mis en forme comme décrit dans la RFC 1123.

Le DequeueCount élément a une valeur de 1 la première fois que le message est dépilé. Cette valeur est incrémentée chaque fois que le message est dépilé.

System_CAPS_noteRemarque

Le DequeueCount élément est retourné dans le corps de réponse uniquement si la file d'attente a été créée avec la version 2009-09-19 du service de file d'attente.

<QueueMessagesList> <QueueMessage> <MessageId>string-message-id</MessageId> <InsertionTime>insertion-time</InsertionTime> <ExpirationTime>expiration-time</ExpirationTime> <DequeueCount>integer</DequeueCount> <MessageText>message-body</MessageText> </QueueMessage> </QueueMessagesList>

Notez que cette réponse diffère de la réponse pour le Get Messages opération que la réponse ne contient pas le PopReceipt ou TimeNextVisible éléments.

Response Status: HTTP/1.1 200 OK Response Headers: Transfer-Encoding: chunked Content-Type: application/xml Date: Fri, 16 Sep 2011 22:51:18 GMT Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0 Response Body: <?xml version="1.0" encoding="utf-8"?> <QueueMessagesList> <QueueMessage> <MessageId>06eba214-8107-4412-a7f6-710a9baff647</MessageId> <InsertionTime>Fri, 09 Oct 2009 18:59:54 GMT</InsertionTime> <ExpirationTime>Fri, 16 Sep 2009 18:59:54 GMT</ExpirationTime> <DequeueCount>1</DequeueCount> <MessageText>PHRlc3Q+dGhpcyBpcyBhIHRlc3QgbWVzc2FnZTwvdGVzdD4=</MessageText> </QueueMessage> </QueueMessagesList>

Cette opération peut être exécutée par le propriétaire du compte et par toute personne qui dispose d'une signature d'accès partagé qui a l'autorisation d'exécuter cette opération.

Lorsqu'un message est récupéré à partir de la file d'attente avec peekonly défini sur true, la visibilité du message est inchangée. Le message reste disponible à d'autres utilisateurs de la file d'attente jusqu'à ce qu'un client récupère le message avec le Get Messages opération. Le client demandant le message ne reçoit pas d'accusé de réception pop avec la réponse et ne peut donc pas supprimer le message.

Seuls les messages qui sont visibles peuvent être récupérés avec la Peek Messages opération. Notez que le nombre maximal de messages qui peuvent être récupérés est égal à 32.

Lorsqu'un message est récupéré pour la première fois avec un appel à Get Messages, sa DequeueCount est définie sur 1. Si elle n'est pas supprimé et est ensuite récupérée, le DequeueCount propriété est incrémentée. Le client peut utiliser cette valeur pour déterminer combien de fois un message a été récupéré. Notez qu'un appel à Peek Messages n'incrémente pas la valeur de DequeueCount, mais retourne cette valeur à lire par le client.

Si le numofmessages paramètre est hors limites, le service retourne le code d'état 400 (demande incorrecte), ainsi que des informations d'erreur supplémentaires, comme illustré dans l'exemple suivant.

HTTP/1.1 400 One of the query parameters specified in the request URI is outside the permissible range. Connection: Keep-Alive Content-Length: 455 Via: 1.1 TK5-PRXY-22 Date: Wed, 02 May 2012 19:37:23 GMT Content-Type: application/xml Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0 x-ms-request-id: 6a03526c-ca2c-4358-a63a-b5d096988533 x-ms-version: 2011-08-18 <?xml version="1.0" encoding="utf-8"?> <Error> <Code>OutOfRangeQueryParameterValue</Code> <Message>One of the query parameters specified in the request URI is outside the permissible range. RequestId:6a03526c-ca2c-4358-a63a-b5d096988533 Time:2012-05-02T19:37:24.2438463Z </Message> <QueryParameterName>numofmessages</QueryParameterName> <QueryParameterValue>0</QueryParameterValue> <MinimumAllowed>1</MinimumAllowed> <MaximumAllowed>32</MaximumAllowed> </Error>

Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.
Afficher:
© 2016 Microsoft