Изменение видимости таймаута сообщения

Описание

Изменяет таймаут видимости указанного сообщения в очереди на новое значение. По умолчанию таймаут видимости сообщения составляет 30 секунд. Минимальное значение — 0 секунд. Максимальное — 12 часов. Дополнительную информацию см. в разделе «Таймаут видимости» в Руководстве разработчика Amazon SQS.

Например, если таймаут очереди по умолчанию составляет 60 секунд, прошло 15 секунд с момента получения сообщения, и вы отправляете вызов ChangeMessageVisibility с параметром VisibilityTimeout, равным 10 секундам, отсчёт 10 секунд начинается с момента отправки вызова ChangeMessageVisibility. Таким образом, любая попытка изменить таймаут видимости или удалить это сообщение через 10 секунд после первоначального изменения таймаута видимости (в общей сложности 25 секунд) может привести к ошибке.

Сообщение Amazon SQS имеет три основных состояния:

• Отправлено в очередь производителем.
• Получено из очереди потребителем.
• Удалено из очереди.

Сообщение считается сохранённым после отправки в очередь производителем, но до получения из очереди потребителем (то есть между состояниями 1 и 2). Ограничений на количество сохранённых сообщений нет. Сообщение считается обрабатывающимся после получения из очереди потребителем, но до удаления из очереди (то есть между состояниями 2 и 3). Количество обрабатываемых сообщений ограничено.

Ограничения, которые применяются к обрабатываемым сообщениям, не связаны с неограниченным количеством сохранённых сообщений.

Для большинства стандартных очередей (в зависимости от трафика очереди и очереди сообщений) максимальное количество обрабатываемых сообщений может составлять приблизительно 120 000 (полученных из очереди потребителем, но ещё не удалённых из очереди). Если вы достигнете этого предела, Amazon SQS вернёт сообщение об ошибке OverLimit. Чтобы избежать достижения предела, вы должны удалять сообщения из очереди после обработки. Также можно увеличить количество используемых вами очередей для обработки сообщений. Для запроса увеличения лимита обратитесь в службу поддержки.

Для очередей FIFO максимальное количество обрабатываемых сообщений может составлять 120 000 (полученных из очереди потребителем, но ещё не удалённых из очереди). При достижении этого предела Amazon SQS не возвращает сообщений об ошибках.

См. также: Документация API AWS

Синопсис

  change-message-visibility
--queue-url <value>
--receipt-handle <value>
--visibility-timeout <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--queue-url (строка)

--receipt-handle (строка)

--visibility-timeout (целое число)

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, заданному --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределяют значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, поскольку строка будет интерпретироваться буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если указано без значения или со значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. При указании значения output он проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (логическое значение)

Включить отладочную регистрацию.

--endpoint-url (строка)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (логическое значение)

По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет стандартное поведение проверки сертификатов SSL.

--no-paginate (логическое значение)

Отключить автоматическую постраничную навигацию. При отключении автоматической постраничной навигации AWS CLI сделает только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

• json
• текст
• таблица
• yaml
• yaml-поток

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла с данными учетных записей.

--region (строка)

Используемый регион. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

• включено
• выключено
• автоматически

--no-sign-request (логическое значение)

Не подписывать запросы. Кредиты не будут загружены, если этот параметр указан.

--ca-bundle (строка)

Файл сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет выполняться без блокировки и таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет выполняться без блокировки и таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, а двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое отображается как двоичный блок, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

• base64
• raw-in-base64-out

--no-cli-pager (логическое значение)

Отключить вывод страницы CLI.

--cli-auto-prompt (логическое значение)

Автоматически запрашивать параметры входных данных CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическое запроса параметров входных данных CLI.

Примеры

Изменение таймаута видимости сообщения

В этом примере таймаут видимости указанного сообщения изменяется на 10 часов (10 часов * 60 минут * 60 секунд).

Команда:

aws sqs change-message-visibility --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue --receipt-handle AQEBTpyI...t6HyQg== --visibility-timeout 36000

Вывод:

None.

Вывод

Нет