Bericht plaatsen

Met deze Put Message bewerking wordt een nieuw bericht toegevoegd aan de achterkant van de berichtenwachtrij. Er kan ook een time-out voor zichtbaarheid worden opgegeven om het bericht onzichtbaar te maken totdat de time-out voor zichtbaarheid is verlopen. Een bericht moet een indeling hebben die kan worden opgenomen in een XML-aanvraag met UTF-8-codering. Het gecodeerde bericht kan maximaal 64 kibibyte (KiB) groot zijn voor versie 2011-08-18 en hoger, of 8 KiB voor eerdere versies.

Aanvraag

U kunt de Put Message aanvraag als volgt samenstellen. U wordt aangeraden HTTPS te gebruiken. Vervang mijnaccount door de naam van uw opslagaccount en myqueue door de naam van uw wachtrij:

Emulated storage-serviceaanvraag

Wanneer u een aanvraag indient voor de geëmuleerde opslagservice, geeft u de hostnaam van de emulator en de opslagpoort in de wachtrij op als 127.0.0.1:10001, gevolgd door de naam van het geëmuleerde opslagaccount:

Zie De Azurite-emulator gebruiken voor lokale Azure Storage-ontwikkelingvoor meer informatie.

URI Parameters

U kunt de volgende parameters opgeven voor de aanvraag-URI:

Headers aanvragen

De vereiste en optionele aanvraagheaders worden beschreven in de volgende tabel:

Inhoud van het verzoek

De hoofdtekst van de aanvraag bevat de berichtgegevens in de volgende XML-indeling. Houd er rekening mee dat de inhoud van het bericht een indeling moet hebben die kan worden gecodeerd met UTF-8.

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

Voorbeeldaanvraag

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>  

Reactie

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Statuscode

Een geslaagde bewerking retourneert statuscode 201 (gemaakt).

Zie Status en foutcodesvoor meer informatie over statuscodes.

Antwoordkopteksten

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Antwoordlichaam

Vanaf versie 2016-05-31 bevat het antwoord voor de Put Message bewerking de berichtinformatie in de hoofdtekst van het antwoord. Het XML-formaat van de geretourneerde body wordt hier beschreven.

Het MessageID element is een GUID-waarde die het bericht in de wachtrij identificeert. Deze waarde wordt door Queue Storage aan het bericht toegewezen en is ondoorzichtig voor de client. Deze waarde kan samen met de waarde van het PopReceipt-element worden gebruikt om een bericht uit de wachtrij te verwijderen of bij te werken. De waarde van PopReceipt is ook ondoorzichtig voor de client en is vereist wanneer u de API's Bericht verwijderen of Bericht bijwerken gebruikt.

De InsertionTime, ExpirationTime, en TimeNextVisible elementen worden weergegeven als UTC-waarden en opgemaakt zoals beschreven in 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>

Voorbeeldantwoord

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>

Autorisatie

Deze bewerking kan worden uitgevoerd door de accounteigenaar en door iedereen met een gedeelde toegangshandtekening met machtigingen om deze bewerking uit te voeren.

Opmerkingen

De optionele time-out voor zichtbaarheid geeft de tijd aan dat het bericht onzichtbaar is. Nadat de time-out is verlopen, wordt het bericht zichtbaar. Als u geen time-out voor zichtbaarheid opgeeft, wordt de standaardwaarde 0 gebruikt.

De optionele time-to-live van het bericht geeft aan hoe lang een bericht in de wachtrij blijft staan. Het bericht wordt uit de wachtrij verwijderd wanneer de time-to-live-periode is verstreken.

Een bericht moet een indeling hebben die kan worden opgenomen in een XML-aanvraag met UTF-8-codering. Als u opmaak in het bericht wilt opnemen, moet de inhoud van het bericht Base64-gecodeerd zijn. Elke XML-opmaak in het bericht die niet is gecodeerd, zorgt ervoor dat het bericht ongeldig is. Als er een ongeldig teken (bijvoorbeeld 0x1F) in het bericht is opgenomen, zelfs als het een XML-escaped is, kan het bericht niet worden gelezen.

Als het bericht te groot is, retourneert de service statuscode 400 (Ongeldig verzoek).

Zie ook

aanvragen autoriseren voor Azure Storage
status en foutcodes
Foutcodes voor wachtrijservice