create-route

Описание

Создаёт маршрут Amazon Web Services Migration Hub Refactor Spaces. Владелец ресурса службы всегда является владельцем среды, независимо от того, какой счёт создаёт маршрут. Маршруты нацелены на службу в приложении. Если у приложения нет маршрутов, то первый маршрут должен быть создан как DEFAULT RouteType .

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

При создании маршрута Refactor Spaces настраивает Amazon API Gateway для отправки трафика в целевую службу следующим образом:

• URL-адреса Если служба имеет URL-адрес и адрес разрешается на частный IP-адрес, Refactor Spaces маршрутизирует трафик с помощью VPC-связки API Gateway. Если адрес службы разрешается на публичный IP-адрес, Refactor Spaces маршрутизирует трафик через общедоступный интернет. Службы могут иметь URL-адреса HTTP или HTTPS. Для HTTPS-адресов поддерживаются общедоступные подписанные сертификаты. Частные центры сертификации (CA) разрешены только в том случае, если домен CA также общедоступно разрешим. Refactor Spaces автоматически разрешает общедоступные имена системы доменных имён (DNS), которые заданы в CreateService:UrlEndpoint при создании службы. Имена DNS разрешаются при истечении времени жизни DNS (TTL) или каждые 60 секунд для TTL менее 60 секунд. Эта периодическая проверка разрешения DNS обеспечивает актуальность конфигурации маршрута. Одноразовая проверка работоспособности Одноразовая проверка работоспособности службы выполняется при обновлении маршрута из состояния «неактивный» в «активный» или при его создании с активным состоянием. Если проверка работоспособности завершится неудачно, состояние маршрута переходит в состояние FAILED, предоставляется код ошибки SERVICE_ENDPOINT_HEALTH_CHECK_FAILURE, и трафик не отправляется в службу. Для частных URL-адресов создаётся целевая группа на Network Load Balancer, и целевая группа балансировщика нагрузки выполняет стандартные проверки работоспособности целевых узлов. По умолчанию проверка работоспособности выполняется по URL-адресу службы. Необязательно, проверка работоспособности может выполняться по другому протоколу, порту и/или пути с помощью параметра CreateService:UrlEndpoint. Все остальные параметры проверки работоспособности балансировщика используют значения по умолчанию, описанные в разделе «Проверки работоспособности для ваших целевых групп» в руководстве по Elastic Load Balancing. Проверка работоспособности считается успешной, если хотя бы один целевой узел в целевой группе переходит в состояние «работоспособен».
• Конечные точки функций Lambda Если у службы есть конечная точка функции Lambda, Refactor Spaces настраивает политику ресурсов функции Lambda для разрешения приложению API Gateway вызывать функцию. Проверяется состояние функции Lambda. Если функция неактивна, конфигурация функции обновляется так, что ресурсы Lambda развёртываются. Если состояние Lambda равно Failed, то создание маршрута завершается неудачей. Дополнительные сведения см. в параметре ответа GetFunctionConfiguration’s State в руководстве разработчика Lambda. Проверяется, существует ли функция Lambda с указанным ARN. Если она не существует, проверка работоспособности завершается неудачей. Для общедоступных URL-адресов открывается соединение с общедоступным адресом. Если URL-адрес недоступен, проверка работоспособности завершается неудачей.

При создании сред без моста сети (CreateEnvironment:NetworkFabricType равно NONE) и вы используете собственную сетевую инфраструктуру, необходимо настроить подключение VPC к VPC между вашей сетью и VPC прокси-сервера приложения. Создание маршрута из прокси-сервера приложения в целевые адреса служб завершится неудачей, если ваша сеть не настроена для подключения к VPC прокси-сервера приложения. Дополнительные сведения см. в разделе «Создание маршрута» в руководстве пользователя Refactor Spaces.

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

Резюме

  create-route
--application-identifier <value>
[--client-token <value>]
[--default-route <value>]
--environment-identifier <value>
--route-type <value>
--service-identifier <value>
[--tags <value>]
[--uri-path-route <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]

Параметры

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

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

--default-route (структура)

Краткая синтаксическая запись:

ActivationState=string

Синтаксис JSON:

{
  "ActivationState": "ACTIVE"|"INACTIVE"
}

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

--route-type (строка)

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

--tags (карта)

Краткая синтаксическая запись:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--uri-path-route (структура)

Краткая синтаксическая запись:

ActivationState=string,AppendSourcePath=boolean,IncludeChildPaths=boolean,Methods=string,string,SourcePath=string

Синтаксис JSON:

{
  "ActivationState": "ACTIVE"|"INACTIVE",
  "AppendSourcePath": true|false,
  "IncludeChildPaths": true|false,
  "Methods": ["DELETE"|"GET"|"HEAD"|"OPTIONS"|"PATCH"|"POST"|"PUT", ...],
  "SourcePath": "string"
}

--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 (boolean)

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

--endpoint-url (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

• json
• text
• table
• yaml
• yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

• on
• off
• auto

--no-sign-request (boolean)

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

--ca-bundle (string)

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

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

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию - 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 (boolean)

Отключить вывод пейджера CLI.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Вывод

ApplicationId -> (string)

Arn -> (string)

CreatedByAccountId -> (string)

CreatedTime -> (timestamp)

LastUpdatedTime -> (timestamp)

OwnerAccountId -> (string)

RouteId -> (string)

RouteType -> (string)

ServiceId -> (string)

State -> (string)

Tags -> (map)

UriPathRoute -> (structure)