Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • Машинное обучение
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Истории успеха
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Message Queue
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
    • Обзор
      • ChangeMessageVisibility
      • ChangeMessageVisibilityBatch
      • DeleteMessage
      • DeleteMessageBatch
      • ReceiveMessage
      • SendMessage
      • SendMessageBatch
    • Стандартные ошибки
  • Метрики Monitoring
  • Публичные материалы
  • Вопросы и ответы
  • Обучающие курсы

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

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

SendMessageBatch

Статья создана
Yandex Cloud
Обновлена 26 августа 2024 г.
  • Запрос
    • Параметры запроса
  • Ответ
    • Поля успешного ответа
    • Ошибки SendMessageBatch
  • Пример запроса
  • Пример ответа

Метод для одновременной отправки до десяти сообщений в указанную очередь. При отправке сообщений в очередь FIFO они будут поступать в порядке отправления.

Результаты отправки для каждого сообщения возвращаются по отдельности. Поскольку отправка для сообщений может пройти как успешно, так и неуспешно, следует проверять все результаты, даже если ответ на вызов метода SendMessageBatch вернулся с кодом 200. Сообщение может содержать структуры XML, JSON и неформатированный текст. Поддерживаются следующие юникод-символы:

  • #x9
  • #xA
  • #xD
  • с #x20 по #xD7FF
  • с #xE000 по #xFFFD
  • с #x10000 по #x10FFFFF

Максимальный размер всей группы сообщений — 256 КБ.

Если для сообщения в группе не указан параметр DelaySeconds, то будет использован параметр для очереди по умолчанию.

Запрос

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

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

Ответ

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

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

Ошибки SendMessageBatch

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

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

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

Action=SendMessageBatch
&Version=2012-11-05
&QueueUrl=https://message-queue.api.cloud.yandex.net/b1g8ad42m6he********/dj6000000000********/sample-queue
&SendMessageBatchRequestEntry.1.Id=123********
&SendMessageBatchRequestEntry.1.MessageBody=HelloWorld
&SendMessageBatchRequestEntry.2.Id=321********
&SendMessageBatchRequestEntry.2.MessageBody=WorldHello

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

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

<SendMessageBatchResponse>
    <SendMessageBatchResult>
        <SendMessageBatchResultEntry>
            <Id>321********</Id>
            <MD5OfMessageBody>aa1e70b237224fdeff0d04e8********</MD5OfMessageBody>
            <MessageId>13b0e327-8aa4cd4e-92feed42***-*****</MessageId>
        </SendMessageBatchResultEntry>
        <SendMessageBatchResultEntry>
            <Id>123********</Id>
            <MD5OfMessageBody>68e109f0f40ca72a15e05cc2********</MD5OfMessageBody>
            <MessageId>10e93fc8-266eb1c1-15e67924***-*****</MessageId>
        </SendMessageBatchResultEntry>
    </SendMessageBatchResult>
    <ResponseMetadata>
        <RequestId>7b4175bf-4a7a7572-94e7a240-15ccbeb-c3d59faf841a51e0fd1184b1********</RequestId>
    </ResponseMetadata>
</SendMessageBatchResponse>

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

Предыдущая
SendMessage
Следующая
BatchResultErrorEntry
Проект Яндекса
© 2025 ООО «Яндекс.Облако»