Продажи: 1-800-867-1389

Удаление сообщения

Обновлено: Сентябрь 2011 г.

Операция Delete Message удаляет указанное сообщение.

Запрос Delete Message можно составить следующим образом. Рекомендуется использовать протокол HTTPS. Замените myaccount учетной записью хранилища, myqueue — именем очереди, а string-value — значением подтверждения, полученного для удаляемого сообщения.

 

Метод URI запроса Версия HTTP

DELETE

https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value

HTTP/1.1

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

 

Метод URI запроса Версия HTTP

DELETE

http://127.0.0.1:10001/devstoreaccount1/myqueue/messages/messageid?popreceipt=string-value

HTTP/1.1

Дополнительные сведения см. в About Development Storage.

URI запроса поддерживает следующие параметры.

 

Параметр Описание

popreceipt

Обязательно. Допустимое значение подтверждения, полученное из предыдущего вызова метода Получение сообщений или операции Обновление сообщения (API-интерфейс REST).

timeout

Необязательно. Параметр timeout указывается в секундах. Дополнительные сведения см. в Задание времени ожидания для операций службы очередей.

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

 

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

Authorization

Обязательно. Указывает схему проверки подлинности, имя учетной записи и подпись. Дополнительные сведения см. в Проверка подлинности для служб хранения Azure.

Date или x-ms-date

Обязательно. Задает время в формате UTC для запроса. Дополнительные сведения см. в Проверка подлинности для служб хранения Azure.

x-ms-version

Необязательно. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в Управление версиями для служб хранилища Azure.

x-ms-client-request-id

Необязательно. Предоставляет сформированное клиентом непрозрачное значение с ограничением в 1 КБ, которое записывается в журналы аналитики, когда включено ведение журналов аналитики хранилища. Этот заголовок настоятельно рекомендуется использовать для соотнесения действий, выполняемых на стороне клиента, с запросами, получаемыми сервером. Дополнительные сведения см. в разделах Сведения о ведении журнала службы аналитики хранилища и Ведение журналов в Windows Azure: использование журналов для отслеживания запросов к хранилищу.

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

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

Сведения о кодах состояния см. в разделе Коды состояний и ошибок.

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

 

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

x-ms-request-id

Этот заголовок однозначно определяет выполненный запрос, его также можно использовать для устранения связанных с запросом неполадок. Дополнительные сведения см. в Устранение неполадок при API-операциях.

x-ms-version

Указывает версию службы очередей, которая используется для выполнения запроса. Этот заголовок возвращается для запросов к версии 2009-09-19 и более поздним версиям.

Date

Значение даты и времени в формате UTC, сформированное службой и указывающее время, когда был инициирован ответ.

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

При успешном удалении сообщение сразу же помечается для удаления и перестает быть доступным клиентам. Позже в процессе сборки мусора сообщение будет удалено из очереди.

После того как клиент получил сообщение с помощью операции Получение сообщений, клиент должен обработать и удалить сообщение. Чтобы удалить сообщение, необходимо получить два элемента данных в тексте ответа операции Get Messages:

  • Идентификатор сообщения — непрозрачное значение GUID, идентифицирующее сообщение в очереди.

  • Действительное подтверждение — непрозрачное значение, которое указывает, что сообщение было получено.

Идентификатор сообщения возвращается с помощью предыдущей операции Get Messages. Подтверждение возвращается с помощью последнего вызова метода Get Messages или операции Update Message. Чтобы операция Delete Message была успешной, подтверждение для запроса должно совпадать с подтверждением, полученным с помощью метода Get Messages или операции Update Message.

Подтверждения остаются действительными до возникновения одного из следующих событий.

  1. Истек срок сообщения.

  2. Сообщение было удалено с помощью последнего подтверждения, полученного с помощью метода Get Messages или Update Message.

  3. Истек срок действия невидимости, сообщение было выведено из очереди запросом Get Messages. Если срок невидимости истек, то сообщение снова становится видимым. Если сообщение получено другим запросом Get Messages, то возвращенное подтверждение используется для удаления или обновления сообщения.

  4. Сообщению присвоено новое время ожидания видимости. При обновлении сообщения возвращается новое подтверждение.

Если сообщение с соответствующим подтверждением не найдено, служба возвращает код ошибки 404 (не найдено). Эта ошибка происходит в случаях, перечисленных выше, если подтверждение больше не является допустимым.

Была ли вам полезна эта информация?
(1500 символов осталось)
Спасибо за ваш отзыв
Показ:
© 2014 Microsoft