Put Message

L'opération Put Message ajoute un nouveau message à la fin de la file d'attente de messages. Un délai d’attente de visibilité peut également être spécifié pour rendre le message invisible jusqu’à l’expiration du délai d’expiration de la visibilité. Un message doit être dans un format qui peut être inclus dans une demande XML en UTF-8. La taille du message encodé peut atteindre 64 Kibioctets (Kio) pour les versions 2011-08-18 et ultérieures, ou 8 Kio pour les versions antérieures.

Requête

Vous pouvez construire la Put Message requête comme suit. Nous vous recommandons d’utiliser HTTPS. Remplacez moncompte par le nom de votre compte de stockage et myqueue par le nom de votre file d'attente :

Demande de service de stockage émulée

Lorsque vous effectuez une demande auprès du service de stockage émulé, spécifiez le nom d’hôte de l’émulateur et le port de stockage file d’attente comme 127.0.0.1:10001, suivis du nom du compte de stockage émulé :

Pour plus d’informations, consultez Utiliser l’émulateur Azurite à des fins de développement local pour Stockage Azure.

Paramètres URI

Vous pouvez spécifier les paramètres suivants sur l’URI de requête :

En-têtes de requête

Les en-têtes de requête obligatoires et facultatifs sont décrits dans le tableau suivant :

Corps de la demande

Le corps de la demande contient les données du message au format XML suivant. Notez que le contenu du message doit être dans un format qui peut être encodé avec UTF-8.

<QueueMessage>  
    <MessageText>message-content</MessageText>  
</QueueMessage>  

Exemple de requête

Request:  
POST https://myaccount.queue.core.windows.net/messages?visibilitytimeout=30&timeout=30 HTTP/1.1  
  
Headers:  
x-ms-version: 2011-08-18  
x-ms-date: Tue, 30 Aug 2011 01:03:21 GMT  
Authorization: SharedKey myaccount:sr8rIheJmCd6npMSx7DfAY3L//V3uWvSXOzUBCV9wnk=  
Content-Length: 100  
  
Body:  
<QueueMessage>  
<MessageText>PHNhbXBsZT5zYW1wbGUgbWVzc2FnZTwvc2FtcGxlPg==</MessageText>  
</QueueMessage>  

response

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

Code d’état

Une opération réussie renvoie le code d'état 201 (Créé).

Pour plus d’informations sur les codes status, consultez Codes d’état et 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.

Response body

À compter de la version 2016-05-31, la réponse de l’opération Put Message contient les informations du message dans le corps de la réponse. Le format XML du corps retourné est décrit ici.

L'élément MessageID est une valeur GUID qui identifie le message dans la file d'attente. Cette valeur est affectée au message par stockage file d’attente et est opaque pour le client. Cette valeur peut être utilisée avec la valeur de l’élément PopReceipt pour supprimer ou mettre à jour un message de la file d’attente. La valeur de PopReceipt est également opaque pour le client, et elle est obligatoire lorsque vous utilisez les API Supprimer un message ou Mettre à jour un message.

Les éléments InsertionTime, ExpirationTime et TimeNextVisible sont représentés en valeurs UTC et mis en forme selon la RFC 1123.

<QueueMessagesList>
    <QueueMessage>
      <MessageId>string-message-id</MessageId>
      <InsertionTime>insertion-time</InsertionTime>
      <ExpirationTime>expiration-time</ExpirationTime>
      <PopReceipt>opaque-string-receipt-data</PopReceipt>
      <TimeNextVisible>time-next-visible</TimeNextVisible>
    </QueueMessage>
</QueueMessagesList>

Exemple de réponse

Response Status:
HTTP/1.1 200 OK
Response headers:
Transfer-Encoding: chunked
Content-Type: application/xml
x-ms-version: 2016-05-31
Date: Fri, 09 Oct 2016 21:04:30 GMT
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0

Response Body:

<?xml version="1.0" encoding="utf-8"?>
<QueueMessagesList>
  <QueueMessage>
    <MessageId>5974b586-0df3-4e2d-ad0c-18e3892bfca2</MessageId>
    <InsertionTime>Fri, 09 Oct 2016 21:04:30 GMT</InsertionTime>
    <ExpirationTime>Fri, 16 Oct 2016 21:04:30 GMT</ExpirationTime>
    <PopReceipt>YzQ4Yzg1MDItYTc0Ny00OWNjLTkxYTUtZGM0MDFiZDAwYzEw</PopReceipt>
    <TimeNextVisible>Fri, 09 Oct 2016 23:29:20 GMT</TimeNextVisible>
   </QueueMessage>
</QueueMessagesList>

Autorisation

Cette opération peut être effectuée par le propriétaire du compte et par toute personne disposant d’une signature d’accès partagé disposant des autorisations nécessaires pour effectuer cette opération.

Notes

Le délai d’attente de visibilité facultatif spécifie l’heure à laquelle le message est invisible. Une fois le délai d’expiration expiré, le message devient visible. Si vous ne spécifiez pas de délai d’attente de visibilité, la valeur par défaut 0 est utilisée.

La durée de vie facultative du message spécifie la durée pendant laquelle un message reste dans la file d’attente. Le message est supprimé de la file d’attente à l’expiration de la période de durée de vie.

Un message doit être dans un format qui peut être inclus dans une demande XML en UTF-8. Pour inclure un balisage dans le message, le contenu du message doit être placé dans une séquence d'échappement XML ou encodé au format Base64. Tout balisage XML dans le message qui n’est pas placé dans une séquence d’échappement ou encodé est supprimé avant l’ajout du message à la file d’attente.

Si le message est trop grand, le service renvoie le code d'état 400 (Demande incorrecte).

Voir aussi

Autoriser les demandes à Stockage Azure
Codes d’état et d’erreur
Codes d’erreur du service de file d’attente