Spec-Zone.ru › AWS CLI v2

[ aws . arc-zonal-shift ]

list-zonal-shifts

Описание

Перечисляет все активные и завершенные зональные сдвиги в Amazon Route 53 Application Recovery Controller в вашей учетной записи Amazon Web Services в этой области Amazon Web Services.

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

list-zonal-shifts — это страничный оператор. Для получения всего набора результатов могут потребоваться несколько вызовов API. Вы можете отключить страничное представление, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе со страничным представлением аргумент --query должен извлекать данные из результатов следующих выражений запроса: items

Синтаксис

  list-zonal-shifts
[--resource-identifier <value>]
[--status <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]

Параметры

--resource-identifier (строка)

Идентификатор ресурса, для которого требуется перечислить зональные сдвиги. Идентификатор — это Amazon Resource Name (ARN) для ресурса.

--status (строка)

Статус зонального сдвига.

Статус Status зонального сдвига может иметь одно из следующих значений:

  • ACTIVE : Зональный сдвиг начат и активен.
  • EXPIRED : Зональный сдвиг истек (был превышен срок действия).
  • CANCELED : Зональный сдвиг был отменен.

Возможные значения:

  • ACTIVE
  • EXPIRED
  • CANCELED

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

--starting-token (строка)

Маркер для указания места начала страничной выборки. Это NextToken из предыдущего усеченного ответа.

Примеры использования см. в разделе «Страничное представление» в руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.

Примеры использования см. в разделе «Страничное представление» в руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов, которые нужно вернуть в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Для возобновления страничной выборки укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе «Страничное представление» в руководстве пользователя AWS Command Line Interface.

--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
  • table
  • yaml
  • yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

Область, которую нужно использовать. Переопределяет настройки конфигурации/окружения.

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

--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.

Вывод

items -> (список)

Элементы в списке ответа.

(структура)

Перечисляет информацию о зональных сдвигах в Amazon Route 53 Application Recovery Controller, включая зональные сдвиги, которые вы запускаете сами, и зональные сдвиги, которые ARC запускает от вашего имени для пробных запусков с автоматическим зональным сдвигом.

Зональные сдвиги временные, включая инициированные пользователем зональные сдвиги и зональные сдвиги пробного запуска автоматического зонального сдвига, которые ARC запускает еженедельно от вашего имени. Зональный сдвиг, инициированный пользователем, может быть активным до трех дней (72 часов). Зональный сдвиг пробного запуска имеет продолжительность 30 минут.

awayFrom -> (строка)

Зона доступности (например, use1-az1), из которой трафик перемещается для ресурса при запуске вами зонального сдвига. До истечения срока действия зонального сдвига или его отмены трафик для ресурса перемещается в другие зоны доступности в данной области Amazon Web Services.

comment -> (строка)

Комментарий, который вы вводите о зональном сдвиге. Сохраняется только последний комментарий; история комментариев не сохраняется. То есть новый комментарий перезаписывает любую существующую строку комментария.

expiryTime -> (метка времени)

Срок действия (время истечения срока действия) для зонального сдвига, инициированного пользователем. Зональный сдвиг является временным и должен быть установлен на срок действия при запуске зонального сдвига. Вы можете первоначально установить срок действия зонального сдвига максимум на три дня (72 часа). Однако вы можете обновить зональный сдвиг, чтобы установить новый срок действия в любое время.

При запуске зонального сдвига вы указываете желаемое время его активности, которое ARC преобразует в время истечения срока действия. Вы можете отменить зональный сдвиг, когда готовы восстановить трафик в зоне доступности, или просто подождать, пока он истечет. Или вы можете обновить зональный сдвиг, чтобы указать другой срок действия.

practiceRunOutcome -> (строка)

Результат или конечное состояние пробного запуска. Возможны следующие значения:

  • PENDING: Значение результата, когда пробный запуск находится в процессе.
  • SUCCEEDED: Значение результата, когда тревога результата, указанная для конфигурации пробного запуска, не переходит в состояние ALARM во время пробного запуска, и пробный запуск не был прерван до его завершения.
  • INTERRUPTED: Значение результата, когда пробный запуск не выполнялся в течение ожидаемых 30 минут или возникла другая проблема с пробным запуском, которая привела к неопределенному результату.
  • FAILED: Значение результата, когда тревога результата, указанная для конфигурации пробного запуска, переходит в состояние ALARM во время пробного запуска, и пробный запуск не был прерван до его завершения.

Дополнительную информацию о результатах пробного запуска см. в разделе «Учет при настройке автоматического зонального сдвига» в руководстве разработчика Amazon Route 53 Application Recovery Controller.

resourceIdentifier -> (строка)

Идентификатор ресурса, который необходимо включить в зональный сдвиг. Идентификатор — это Amazon Resource Name (ARN) для ресурса.

В настоящее время вы можете инициировать зональный сдвиг только для балансировщиков сети и балансировщиков приложений с отключенной межзонной балансировкой.

shiftType -> (строка)

Определяет тип зонального сдвига.

startTime -> (метка времени)

Время (UTC), когда начинается зональный сдвиг.

status -> (строка)

Статус зонального сдвига.

Статус Status зонального сдвига может иметь одно из следующих значений:

  • ACTIVE: Зональный сдвиг начат и активен.
  • EXPIRED: Зональный сдвиг истек (был превышен срок действия).
  • CANCELED: Зональный сдвиг был отменен.

zonalShiftId -> (строка)

Идентификатор зонального сдвига.

nextToken -> (строка)

Указывает, что вы хотите получить следующую страницу результатов. Действительно только если вы получили ответ nextToken в предыдущем запросе. Если да, это указывает на то, что доступно больше вывода. Установите этот параметр в значение, предоставленное ответом nextToken предыдущего вызова, чтобы запросить следующую страницу результатов.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API