ChangeMessageVisibilityBatch

Статья создана

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

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

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

Запрос

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

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

Ответ

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

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

Ошибки ChangeMessageVisibilityBatch

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

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

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

Action=ChangeMessageVisibilityBatch
&Version=2012-11-05
&QueueUrl=https://message-queue.api.cloud.yandex.net/b1g8ad42m6he1ooql78r/dj600000000000le07ol/sample-queue
&ChangeMessageVisibilityBatchRequestEntry.1.Id=8b6f1be7-effe631a-7b3cbef1-158bf58
&ChangeMessageVisibilityBatchRequestEntry.1.ReceiptHandle=EAUg9bzYh4gtKAA
&ChangeMessageVisibilityBatchRequestEntry.1.VisibilityTimeout=30
&ChangeMessageVisibilityBatchRequestEntry.2.Id=54fe7789-da6cfbfd-3664814a-158c30e
&ChangeMessageVisibilityBatchRequestEntry.2.ReceiptHandle=EAEgrqvYh4gtKAE
&ChangeMessageVisibilityBatchRequestEntry.2.VisibilityTimeout=30

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

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

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