[ aws . arc-zonal-shift ]
Запуск зоны переключения
Описание
Вы запускаете зону переключения, чтобы временно перенаправить трафик балансировщика нагрузки от зоны доступности в регионе Amazon Web Services, чтобы помочь вашему приложению быстро восстановиться, например, после неудачной развертки кода разработчика или сбоя инфраструктуры Amazon Web Services в одной зоне доступности. Вы можете запустить зону переключения в ARC только для управляемых ресурсов в вашей учетной записи Amazon Web Services в регионе Amazon Web Services. Ресурсы автоматически регистрируются в ARC службами Amazon Web Services.
В настоящее время вы можете запускать зону переключения только для балансировщиков сетевого трафика и балансировщиков приложений с отключенным межзонным балансированием.
При запуске зоны переключения трафик для ресурса больше не направляется в зону доступности. Зона переключения создается немедленно в ARC. Однако может потребоваться некоторое время, обычно до нескольких минут, для завершения существующих, активных подключений в зоне доступности.
Дополнительную информацию см. в разделе Зона переключения в руководстве разработчика Amazon Route 53 Application Recovery Controller.
См. также: Документация API AWS
Синтаксис
start-zonal-shift
--away-from<value>
--comment <value>
--expires-in <value>
--resource-identifier <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]
Параметры
--away-from (строка)
use1-az1 ), из которой трафик перемещается для ресурса при запуске зоны переключения. Пока зона переключения не истечет или не будет отменена, трафик ресурса вместо этого перемещается в другие зоны доступности в регионе Amazon Web Services.--comment (строка)
--expires-in (строка)
Продолжительность активности зоны переключения, которую ARC преобразует в время истечения (время истечения срока действия). Зоны переключения временные. Вы можете установить первоначальную активность зоны переключения до трех дней (72 часов).
Если вы хотите сохранить трафик подальше от зоны доступности, вы можете обновить зону переключения и установить новое время истечения. Вы также можете отменить зону переключения до ее истечения, например, если вы готовы восстановить трафик в зону доступности.
Чтобы установить продолжительность активности зоны переключения, укажите целое число, а затем одно из следующих, без пробелов:
- Маленькая буква m: для указания того, что значение дано в минутах.
- Маленькая буква h: для указания того, что значение дано в часах.
Например: 20h означает, что зона переключения истекает через 20 часов. 120m означает, что зона переключения истекает через 120 минут (2 часа).
--resource-identifier (строка)
Идентификатор ресурса, для которого Amazon Web Services перенаправляет трафик. Идентификатор — это Amazon Resource Name (ARN) ресурса.
В настоящее время поддерживаются балансировщики сетевого трафика и балансировщики приложений с отключенным межзонным балансированием.
--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
- text
- таблица
- 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-auto-prompt (логическое значение)
Автоматически запросить параметры входных данных CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запроса параметров входных данных CLI.
Вывод
awayFrom -> (строка)
use1-az1 ), из которой трафик перемещается для ресурса при запуске зоны переключения. Пока зона переключения не истечет или не будет отменена, трафик ресурса вместо этого перемещается в другие зоны доступности в регионе Amazon Web Services.comment -> (строка)
expiryTime -> (метка времени)
Время истечения (время истечения срока действия) для зоны переключения, инициированной пользователем. Зона переключения временная и должна истечь при ее запуске. Вы можете первоначально установить время истечения зоны переключения максимум на три дня (72 часа). Однако вы можете обновить зону переключения, чтобы установить новое время истечения в любое время.
При запуске зоны переключения вы указываете, как долго вы хотите ее активировать, а ARC преобразует это в время истечения. Вы можете отменить зону переключения, когда будете готовы восстановить трафик в зону доступности, или просто подождать, пока она истечет. Или вы можете обновить зону переключения, чтобы указать другое время истечения.
resourceIdentifier -> (строка)
Идентификатор ресурса, для которого Amazon Web Services перенаправляет трафик. Идентификатор — это Amazon Resource Name (ARN) ресурса.
В настоящее время поддерживаются балансировщики сетевого трафика и балансировщики приложений с отключенным межзонным балансированием.
startTime -> (метка времени)
status -> (строка)
Статус зоны переключения.
Статус Status зоны переключения может иметь одно из следующих значений:
- ACTIVE: Зона переключения запущена и активна.
- EXPIRED: Зона переключения истекла (время истечения было превышено).
- CANCELED: Зона переключения была отменена.
zonalShiftId -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.