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

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

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

ChangeMessageVisibilityBatch

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

Метод для установки таймаута видимости группе сообщений в указанной очереди. Можно отправить до 10 вызовов ChangeMessageVisibility в одном вызове ChangeMessageVisibilityBatch.

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

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

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

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

ОтветОтвет

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

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

Ошибки ChangeMessageVisibilityBatchОшибки ChangeMessageVisibilityBatch

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

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

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

Action=ChangeMessageVisibilityBatch
&Version=2012-11-05
&QueueUrl=https://message-queue.api.cloud.yandex.net/b1g8ad42m6he********/dj6000000000********/sample-queue
&ChangeMessageVisibilityBatchRequestEntry.1.Id=8b6f1be7-effe631a-7b3cb***-*****
&ChangeMessageVisibilityBatchRequestEntry.1.ReceiptHandle=EAUg9bz********
&ChangeMessageVisibilityBatchRequestEntry.1.VisibilityTimeout=30
&ChangeMessageVisibilityBatchRequestEntry.2.Id=54fe7789-da6cfbfd-3664814a***-*****
&ChangeMessageVisibilityBatchRequestEntry.2.ReceiptHandle=EAEgrqv********
&ChangeMessageVisibilityBatchRequestEntry.2.VisibilityTimeout=30

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

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

<ChangeMessageVisibilityBatchResponse>
    <ChangeMessageVisibilityBatchResult>
        <ChangeMessageVisibilityBatchResultEntry>
            <Id>8b6f1be7-effe631a-7b3cbef1***-*****</Id>
        </ChangeMessageVisibilityBatchResultEntry>
        <ChangeMessageVisibilityBatchResultEntry>
            <Id>54fe7789-da6cfbfd-3664814a***-*****</Id>
        </ChangeMessageVisibilityBatchResultEntry>
    </ChangeMessageVisibilityBatchResult>
    <ResponseMetadata>
        <RequestId>4e249f0e-74ac41aa-aa8c6354-12fd717f-a9761e7b848e70720ec61d81********</RequestId>
    </ResponseMetadata>
</ChangeMessageVisibilityBatchResponse>

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

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