Put Message

Tramite l'operazione Put Message viene aggiunto un nuovo messaggio in fondo alla coda di messaggi. È anche possibile specificare un timeout di visibilità per rendere invisibile il messaggio fino alla scadenza del timeout della visibilità. Un messaggio deve avere un formato che ne consenta l'inserimento in una richiesta XML con codifica UTF-8. Il messaggio codificato può essere fino a 64 kibibyte (KiB) con dimensioni per la versione 2011-08-18 e versioni successive o 8 KiB per le versioni precedenti.

Richiesta

È possibile costruire la Put Message richiesta come indicato di seguito. È consigliabile usare HTTPS. Sostituire myaccount con il nome dell'account di archiviazione e myqueue con il nome della coda:

Richiesta del servizio di archiviazione emulata

Quando si effettua una richiesta con il servizio di archiviazione emulato, specificare il nome host dell'emulatore e la porta di archiviazione code come 127.0.0.1:10001, seguita dal nome dell'account di archiviazione emulato:

Per altre informazioni, vedere Usare l'emulatore Azurite per lo sviluppo locale di Archiviazione di Azure.

Parametri URI

È possibile specificare i parametri seguenti nell'URI della richiesta:

Intestazioni della richiesta

Le intestazioni di richiesta obbligatorie e facoltative sono descritte nella tabella seguente:

Testo della richiesta

Il corpo della richiesta contiene i dati di messaggio nel seguente formato XML. Si noti che il contenuto del messaggio deve essere in un formato che può essere codificato con UTF-8.

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

Richiesta di esempio

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>  

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codice stato

Un'operazione completata correttamente restituisce il codice di stato 201 (Creato).

Per altre informazioni sui codici di stato, vedere Codici di stato e di errore.

Intestazioni di risposta

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

Corpo della risposta

A partire dalla versione 2016-05-31, la risposta per l'operazione Put Message contiene le informazioni sul messaggio nel corpo della risposta. Il formato XML del corpo restituito è descritto qui.

L'elemento MessageID è un valore GUID che identifica il messaggio nella coda. Questo valore viene assegnato al messaggio da Archiviazione code ed è opaco al client. Questo valore può essere usato insieme al valore dell'elemento PopReceipt per eliminare o aggiornare un messaggio dalla coda. Il valore di PopReceipt è anche opaco al client ed è necessario quando si usano le API Elimina messaggio o Aggiorna messaggio.

Gli elementi InsertionTime, ExpirationTime e TimeNextVisible vengono rappresentati come valori UTC e formattati come descritto 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>

Risposta di esempio

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>

Autorizzazione

Questa operazione può essere eseguita dal proprietario dell'account e da chiunque abbia una firma di accesso condiviso con autorizzazioni per eseguire questa operazione.

Commenti

Il timeout di visibilità facoltativo specifica il tempo in cui il messaggio è invisibile. Dopo la scadenza del timeout, il messaggio diventa visibile. Se non si specifica un timeout di visibilità, viene usato il valore predefinito 0.

Il time-to-live del messaggio facoltativo specifica quanto tempo rimane un messaggio nella coda. Il messaggio viene eliminato dalla coda quando scade il periodo di tempo a tempo.

Un messaggio deve avere un formato che ne consenta l'inserimento in una richiesta XML con codifica UTF-8. Per includere commenti nel messaggio, il contenuto del messaggio deve essere in formato XML con caratteri escape o con codifica Base64. Qualsiasi markup XML nel messaggio senza escape o codificato viene rimosso prima che il messaggio venga aggiunto alla coda.

Se il messaggio è di dimensioni eccessive, il servizio restituisce il codice di stato 400 (Richiesta non valida).

Vedi anche

Autorizzare le richieste ad Archiviazione di Azure
Stato e codici errore
Codici di errore del servizio code