Поместите сообщение

Эта Put Message операция добавляет новое сообщение в конец очереди сообщений. Также можно указать тайм-аут видимости, чтобы сделать сообщение невидимым до истечения тайм-аута видимости. Сообщение должно быть в формате, который может быть включен в XML-запрос с кодировкой UTF-8. Размер закодированного сообщения может составлять до 64 кибибайт (КиБ) для версии 2011-08-18 и более поздних версий или до 8 КиБ для более ранних версий.

Просьба

Можно создать запрос Put Message следующим образом. Рекомендуется использовать ПРОТОКОЛ HTTPS. Замените myaccount именем учетной записи хранения и myqueue именем очереди:

Запрос службы эмулированного хранилища

При отправке запроса к эмулируемой службе хранения укажите имя узла эмулятора и порт хранилища очереди как 127.0.0.1:10001, а затем имя эмулируемой учетной записи хранения:

Дополнительные сведения см. в статье Использование эмулятора Azurite для разработки локальной службы хранилища Azure.

Параметры URI

В URI запроса можно указать следующие параметры:

Заголовки запросов

Обязательные и необязательные заголовки запросов описаны в следующей таблице:

Основное содержание запроса

Тело запроса содержит данные сообщения в следующем формате XML. Обратите внимание, что содержимое сообщения должно быть в формате, который может быть закодирован с помощью UTF-8.

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

Пример запроса

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>  

Ответ

Ответ включает код состояния HTTP и набор заголовков ответа.

Код состояния

Успешная операция возвращает код состояния 201 (создан).

Дополнительные сведения о кодах состояния см. в коды состояния и коды ошибок.

Заголовки ответа

Ответ для этой операции содержит следующие заголовки. Ответ также может включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.

Основная часть ответа

Начиная с версии 2016-05-31, ответ для Put Message операции содержит информацию о сообщении в теле ответа. Формат XML возвращаемого тела описан здесь.

Элемент MessageID представляет собой значение GUID, которое идентифицирует сообщение в очереди. Это значение назначается сообщению хранилищем очередей и является непрозрачным для клиента. Это значение может быть использовано вместе со значением элемента PopReceipt для удаления или обновления сообщения из очереди. Значение PopReceipt также непрозрачно для клиента, и оно требуется при использовании API Delete Message или Update Message.

Элементы InsertionTime, ExpirationTime, и TimeNextVisible представлены в виде значений UTC и отформатированы в соответствии с 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>

Пример ответа

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>

Авторизация

Эту операцию может выполнить как владелец учетной записи, так и любой пользователь с подписанным URL-адресом с разрешениями на выполнение этой операции.

Замечания

Необязательное время ожидания видимости указывает время, в течение которого сообщение становится невидимым. По истечении времени ожидания сообщение становится видимым. Если время ожидания видимости не указано, используется значение по умолчанию 0.

Необязательный срок жизни сообщения указывает, как долго сообщение остается в очереди. Сообщение удаляется из очереди по истечении срока жизни.

Сообщение должно быть в формате, который может быть включен в XML-запрос с кодировкой UTF-8. Чтобы включить разметку в сообщение, содержимое сообщения должно быть в формате XML-escaped или в кодировке Base64. Любая XML-разметка в сообщении, которая не экранирована или не закодирована, удаляется перед добавлением сообщения в очередь. Если в сообщении недопустимый символ (например, 0x1F) экранирован XML или закодирован в кодировке Base64, последующие чтения сообщения не увенчаются успехом.

Если сообщение слишком большое, служба возвращает код состояния 400 (Bad Request).

См. также

Авторизация запросов в службу хранилища Azure
Коды состояний и ошибок
Коды ошибок службы очередей