Yandex Cloud
КейсыДокументация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Yandex Message Queue
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
    • Обзор
      • CreateQueue
      • DeleteQueue
      • GetQueueAttributes
      • GetQueueUrl
      • ListQueues
      • PurgeQueue
      • SetQueueAttributes
      • TagQueue
      • UntagQueue
      • ListQueueTags
    • Стандартные ошибки
  • Аудитные логи Audit Trails
  • Метрики Monitoring
  • Публичные материалы
  • Вопросы и ответы
  • Обучающие курсы

В этой статье:

  • Запрос
  • Параметры запроса
  • Ответ
  • Поля успешного ответа
  • Ошибки PurgeQueue
  • Пример запроса
  • Пример ответа
  1. Справочник API
  2. Queue
  3. PurgeQueue

PurgeQueue

Статья создана
Yandex Cloud
Обновлена 18 июня 2026 г.
Открыть в Markdown
  • Запрос
    • Параметры запроса
  • Ответ
    • Поля успешного ответа
    • Ошибки PurgeQueue
  • Пример запроса
  • Пример ответа

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

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

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

Внимание

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

ЗапросЗапрос

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

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

ОтветОтвет

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

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

Ошибки PurgeQueueОшибки PurgeQueue

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

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

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

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

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

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

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

Была ли статья полезна?

Предыдущая
ListQueues
Следующая
SetQueueAttributes
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»