Yandex.Cloud
  • Сервисы
  • Почему Yandex.Cloud
  • Сообщество
  • Решения
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Yandex Message Queue
  • Начало работы
    • Быстрый старт
    • Поддерживаемые инструменты
    • Примеры кода
      • Python
      • Node.js
      • PHP
      • Celery
      • JMS
      • Laravel
      • Terraform
  • Пошаговые инструкции
    • Обзор
    • Создание новой очереди сообщений
    • Отправка сообщений
    • Прием и удаление сообщений
    • Удаление очереди сообщений
  • Концепции
    • Обзор
    • Очереди сообщений
    • Сообщения
    • Дедупликация
    • Таймаут видимости
    • Long Polling
    • Dead Letter Queue
    • Отложенная доставка сообщений в очереди
    • Квоты и лимиты
  • Управление доступом
  • Правила тарификации
  • Yandex Message Queue API
    • Обзор
    • Queue
      • CreateQueue
      • DeleteQueue
      • GetQueueAttributes
      • GetQueueUrl
      • ListQueues
      • PurgeQueue
      • SetQueueAttributes
    • Message
      • ChangeMessageVisibility
      • ChangeMessageVisibilityBatch
      • DeleteMessage
      • DeleteMessageBatch
      • ReceiveMessage
      • SendMessage
      • SendMessageBatch
    • Типы данных
      • BatchResultErrorEntry
      • ChangeMessageVisibilityBatchRequestEntry
      • ChangeMessageVisibilityBatchResultEntry
      • DeleteMessageBatchRequestEntry
      • DeleteMessageBatchResultEntry
      • Message
      • MessageAttributeValue
      • SendMessageBatchRequestEntry
      • SendMessageBatchResultEntry
    • Стандартные ошибки
  • Публичные материалы
  • Вопросы и ответы
  1. Yandex Message Queue API
  2. Message
  3. DeleteMessageBatch

DeleteMessageBatch

  • Запрос
    • Параметры запроса
  • Ответ
    • Поля успешного ответа
    • Ошибки DeleteMessageBatch
  • Пример запроса
  • Пример ответа

Метод для удаления нескольких сообщений из очереди. Удалять можно не более 10 сообщений одновременно.

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

Запрос

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

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

Ответ

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

Поле Тип Описание
BatchResultErrorEntry.N array Массив BatchResultErrorEntry, содержащий ошибки выполнения запроса.
DeleteMessageBatchResultEntry.N array Массив DeleteMessageBatchResultEntry содержащий идентификаторы успешно удаленных сообщений.

Ошибки DeleteMessageBatch

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

Код HTTP Идентификатор ошибки Описание
400 BatchEntryIdsNotDistinct Для двух или более сообщений в списке имеют одинаковые идентификаторы..
400 EmptyBatchRequest Не передано ни одного сообщения.
400 InvalidBatchEntryId Неправильный идентификатор сообщения в группе.
400 TooManyEntriesInBatchRequest Слишком большое количество сообщений в группе.

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

Action=DeleteMessageBatch
&Version=2012-11-05
&QueueUrl=https://message-queue.api.cloud.yandex.net/b1g8ad42m6he1ooql78r/dj600000000000le07ol/sample-queue
&DeleteMessageBatchRequestEntry.1.Id=dd2dd32b-eb1e7a37-f6b7a725-1555483
&DeleteMessageBatchRequestEntry.1.ReceiptHandle=EAEg89fvhogtKAM
&DeleteMessageBatchRequestEntry.2.Id=7e0e07f6-5c9a0a72-d304102f-1532995
&DeleteMessageBatchRequestEntry.2.ReceiptHandle=EAEgq5vvhogtKAI

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

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

<DeleteMessageBatchResponse>
    <DeleteMessageBatchResult>
        <DeleteMessageBatchResultEntry>
            <Id>dd2dd32b-eb1e7a37-f6b7a725-1555483</Id>
        </DeleteMessageBatchResultEntry>
        <DeleteMessageBatchResultEntry>
            <Id>7e0e07f6-5c9a0a72-d304102f-1532995</Id>
        </DeleteMessageBatchResultEntry>
    </DeleteMessageBatchResult>
    <ResponseMetadata>
        <RequestId>e02ca0b-5e6b6d98-cef0a99c-150a53b3-07ee55365ba1b6fd876875f0ae18068e</RequestId>
    </ResponseMetadata>
</DeleteMessageBatchResponse>
В этой статье:
  • Запрос
  • Параметры запроса
  • Ответ
  • Поля успешного ответа
  • Ошибки DeleteMessageBatch
  • Пример запроса
  • Пример ответа
Language
Вакансии
Политика конфиденциальности
Условия использования
© 2021 ООО «Яндекс.Облако»