Очистка сообщений

Операция Clear Messages удаляет все сообщения из указанной очереди.

Запрос

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

Метод	Универсальный код ресурса (URI) запроса	параметр "Версия HTTP"
DELETE	https://myaccount.queue.core.windows.net/myqueue/messages	HTTP/1.1

Универсальный код ресурса (URI) для эмулированной службы хранилища

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

Метод	Универсальный код ресурса (URI) запроса	параметр "Версия HTTP"
DELETE	http://127.0.0.1:10001/devstoreaccount1/myqueue/messages	HTTP/1.1

Параметры универсального кода ресурса (URI)

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

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

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

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

Заголовок запроса	Описание
Authorization	Обязательный. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
Date или x-ms-date	Обязательный. Задает время запроса в формате UTC. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
x-ms-version	Необязательный элемент. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure.
x-ms-client-request-id	Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы при настройке ведения журнала. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером.

Текст запроса

Нет.

Ответ

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

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

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

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

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

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

Заголовок запроса	Описание
x-ms-request-id	Уникально идентифицирует выполненный запрос. Этот заголовок можно использовать для устранения неполадок с запросом. Дополнительные сведения см. в статье Устранение неполадок с операциями API.
x-ms-version	Указывает версию хранилища очередей, которая используется для выполнения запроса. Этот заголовок возвращается для запросов к версии 2009-09-19 и более поздним версиям.
Date	Значение даты и времени в формате UTC, указывающее время отправки ответа службой.
x-ms-client-request-id	Может использоваться для устранения неполадок запросов и соответствующих ответов. Значение этого заголовка равно значению заголовка x-ms-client-request-id , если он присутствует в запросе и содержит не более 1024 видимых символов ASCII. Если заголовок x-ms-client-request-id отсутствует в запросе, этот заголовок не будет присутствовать в ответе.

Текст ответа

Нет.

Авторизация

Только владелец учетной записи может вызвать эту операцию.

Комментарии

Если очередь содержит большое количество сообщений, Clear Messages может быть истекло время ожидания, прежде чем все сообщения будут удалены. В этом случае хранилище очередей возвращает код состояния 500 (внутренняя ошибка сервера) с дополнительным кодом ошибки OperationTimedOut. Если вы получили этот код ошибки, операция может быть успешной или не выполнена на стороне сервера, и перед повторным выполнением операции необходимо запросить состояние сервера. Если время ожидания операции истекает и на стороне сервера считается неудачным, клиент должен продолжать повторять попытки Clear Messages , пока не завершится успешно, чтобы убедиться, что все сообщения были удалены.

См. также раздел

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