Yandex Cloud
Документация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Yandex Message Queue
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
    • Обзор
      • ChangeMessageVisibility
      • ChangeMessageVisibilityBatch
      • DeleteMessage
      • DeleteMessageBatch
      • ReceiveMessage
      • SendMessage
      • SendMessageBatch
    • Стандартные ошибки
  • Аудитные логи Audit Trails
  • Метрики Monitoring
  • Публичные материалы
  • Вопросы и ответы
  • Обучающие курсы

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

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

DeleteMessage

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

Метод для удаления сообщения из очереди. Чтобы указать, какое сообщение следует удалить, используйте параметр ReceiptHandle. Сообщение можно удалить, даже если сообщение получено и обрабатывается другим получателем. Message Queue автоматически удаляет сообщения, если период, указанный в параметре RetentionPeriod закончился.

Параметр ReceiptHandle связан с конкретным экземпляром сообщения. Если сообщение получено несколько раз, оно будет получать разные значения ReceiptHandle. Чтобы удалить сообщения, следует использовать самое последнее значение ReceiptHandle, иначе запрос выполнится, но сообщение может быть не удалено.

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

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

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

Параметр Тип Обязательный параметр Описание
QueueUrl string Да URL очереди, в которой находится сообщение.
ReceiptHandle string Да Параметр ReceiptHandle из запроса ReceiveMessage.

ОтветОтвет

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

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

Ошибки DeleteMessageОшибки DeleteMessage

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

Код HTTP Идентификатор ошибки Описание
400 InvalidIdFormat Некорректный формат ReceiptHandle.
400 ReceiptHandleIsInvalid Неверный параметр ReceiptHandle.

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

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

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

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

<DeleteMessageResponse>
    <ResponseMetadata>
        <RequestId>c79cd3cb-ffb474f7-9d5a8a3e-e5db06c-7c4ef5d027dd4219c28bf6c2********</RequestId>
    </ResponseMetadata>
</DeleteMessageResponse>

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

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