get-managed-resource

Описание

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

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

Синтаксис

  get-managed-resource
--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]

Параметры

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

Идентификатор ресурса, для которого Amazon Web Services переключает трафик. Идентификатор — это Amazon Resource Name (ARN) ресурса.

В настоящее время поддерживаются сетевые балансировщики (Network Load Balancers) и балансировщики приложений (Application Load Balancers) с отключенным межзонным балансированием.

--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 для вывода.

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

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

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

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

Вывод

appliedWeights -> (map)

Коллекция пар ключ-значение, указывающих, активны ли ресурсы в зонах доступности. Имя ключа — зона доступности, в которой развернут ресурс. Значение — 1 или 0.

ключ -> (строка)

значение -> (число с плавающей запятой)

arn -> (строка)

Идентификатор ресурса Amazon Resource Name (ARN).

autoshifts -> (список)

Массив активных автосдвигов для ресурса.

(структура)

Сложная структура, которая перечисляет активный автосдвиг для управляемого ресурса и информацию об автосдвиге.

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

appliedStatus -> (строка)

Поле appliedStatus указывает, какой сдвиг приложений применяется к ресурсу, когда активных сдвигов трафика несколько. Одновременно может быть несколько активных сдвигов приложений — например, пробные зональные сдвиги, инициированные пользователем зональные сдвиги или автосдвиги. Поле appliedStatus для сдвига, активного для ресурса, может принимать одно из двух значений: APPLIED или NOT_APPLIED. Зональный сдвиг или автосдвиг, который в данный момент активен для ресурса, имеет значение appliedStatus, установленное в значение APPLIED.

Основной принцип приоритета таков: зональные сдвиги, инициированные пользователем, имеют приоритет перед автосдвигами, а автосдвиги — перед пробными запусками. То есть, зональные сдвиги, инициированные пользователем > автосдвиги > пробные зональные сдвиги.

awayFrom -> (строка)

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

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

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

name -> (строка)

Название ресурса.

practiceRunConfiguration -> (структура)

Настройка пробного запуска для зонального автосдвига, связанного с ресурсом.

blockedDates -> (список)

Массив из одной или нескольких дат, которые вы можете указать, когда Amazon Web Services не должен запускать пробные запуски для ресурса.

Указывайте даты блокировки в формате UTC, разделенные пробелами, в формате YYYY-MM-DD.

(строка)

blockedWindows -> (список)

Массив из одного или нескольких временных интервалов дней и времени, которые вы можете заблокировать для запуска пробных запусков ARC для ресурса.

Укажите заблокированные интервалы в UTC, используя формат DAY:HH:MM-DAY:HH:MM, разделенные пробелами. Например, MON:18:30-MON:19:30 TUE:18:30-TUE:19:30.

(строка)

blockingAlarms -> (список)

Сигнализация блокировки для пробных запусков — это необязательная сигнализация, которую вы можете указать, чтобы блокировать пробные запуски, когда сигнализация находится в состоянии ALARM.

(структура)

Условие управления — это сигнализация, которую вы указываете для пробного запуска. При настройке пробных запусков с зональным автосдвигом для ресурса вы указываете сигнализации Amazon CloudWatch, которые вы создаёте в CloudWatch для использования с пробным запуском. Сигнализации, которые вы указываете, — это сигнализация исхода для отслеживания работоспособности приложения во время пробных запусков и, необязательно, сигнализация блокировки для блокировки запуска пробных запусков или прерывания уже начатого пробного запуска.

Сигнализации условия управления не применяются для автосдвигов.

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

alarmIdentifier -> (строка)

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

type -> (строка)

Тип сигнализации, указанной для пробного запуска. Вы можете указывать только сигнализации Amazon CloudWatch для пробных запусков, поэтому единственное допустимое значение — CLOUDWATCH.

outcomeAlarms -> (список)

Сигнализация исхода для пробных запусков — это сигнализация, которую вы указываете для завершения пробного запуска, когда сигнализация находится в состоянии ALARM.

(структура)

Сигнализации условия управления не применяются для автосдвигов.

alarmIdentifier -> (строка)

type -> (строка)

zonalAutoshiftStatus -> (строка)

Статус зонального автосдвига для ресурса. Когда статус автосдвига — ENABLED, Amazon Web Services перенаправляет трафик ресурса из зоны доступности от вашего имени, когда Amazon Web Services определяет проблему в зоне доступности, которая потенциально может повлиять на клиентов.

zonalShifts -> (список)

Активные зональные сдвиги для ресурса.

(структура)

Сложная структура, которая перечисляет зональные сдвиги для управляемого ресурса и их статусы для ресурса.

appliedStatus -> (строка)

awayFrom -> (строка)

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

comment -> (строка)

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

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

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

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

practiceRunOutcome -> (строка)

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

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

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

resourceIdentifier -> (строка)

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

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

shiftType -> (строка)

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

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

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

zonalShiftId -> (строка)

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