PurgeQueue

Метод для очистки очереди сообщений. Удаление сообщений занимает некоторое время. Чтобы убедиться, что в очереди не осталось сообщений, приостановите отправку сообщений в очередь и вызовите метод GetQueueAttributes.

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

Сообщения, отправленные в очередь после вызова PurgeQueue не будут удалены.

Предупреждение

Удаленные из очереди сообщения невозможно восстановить.

Запрос

Параметры запроса

Параметр Тип Обязательный параметр Описание
QueueUrl string Да URL очереди. Чувствителен к регистру.

Ответ

Поля успешного ответа

Ответ не содержит полей.

Ошибки PurgeQueue

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

Код HTTP Идентификатор ошибки Описание
400 NonExistentQueue Указанная очередь не существует.
403 PurgeQueueInProgress Для указанной очередь уже был вызван метод PurgeQueue за последние 60 секунд.

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

Action=PurgeQueue
&Version=2012-11-05
&QueueUrl=https://message-queue.api.cloud.yandex.net/b1g8ad42m6he1ooql78r/dj600000000000le07ol/sample-queue

Подробнее о формировании запросов см. в разделе Общий вид запросов к API.

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

<PurgeQueueResponse>
    <ResponseMetadata>
        <RequestId>c89ea19f-37d3a529-58142774-e25a26f-2618ff0043df35a802b77c9459dc96c7</RequestId>
    </ResponseMetadata>
</PurgeQueueResponse>