Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

создать-сервер-маршрутизации

Описание

Создает новый сервер маршрутизации для управления динамической маршрутизацией в VPC.

Amazon VPC Route Server упрощает маршрутизацию трафика между рабочими нагрузками, развернутыми внутри VPC и его интернет-шлюзами. С помощью этой функции VPC Route Server динамически обновляет таблицы маршрутизации VPC и интернет-шлюзов вашими предпочтительными маршрутами IPv4 или IPv6, чтобы обеспечить отказоустойчивость маршрутизации для этих рабочих нагрузок. Это позволяет вам автоматически перенаправлять трафик внутри VPC, что повышает управляемость маршрутизации VPC и межсетевое взаимодействие с рабочими нагрузками сторонних разработчиков.

Сервер маршрутизации поддерживает следующие типы таблиц маршрутизации:

  • Таблицы маршрутизации VPC, не связанные с подсетями
  • Таблицы маршрутизации подсетей
  • Таблицы маршрутизации интернет-шлюзов

Сервер маршрутизации не поддерживает таблицы маршрутизации, связанные с виртуальными частными шлюзами. Для распространения маршрутов в таблицу маршрутизации шлюза транзита используйте Transit Gateway Connect.

Дополнительную информацию см. в разделе Динамическая маршрутизация в вашей VPC с помощью VPC Route Server в Руководстве пользователя Amazon VPC.

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

Синтаксис

  create-route-server
--amazon-side-asn <value>
[--client-token <value>]
[--dry-run | --no-dry-run]
[--persist-routes <value>]
[--persist-routes-duration <value>]
[--sns-notifications-enabled | --no-sns-notifications-enabled]
[--tag-specifications <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]

Параметры

--amazon-side-asn (long)

Приватный автономный номер системы (ASN) для стороны Amazon сессии BGP. Допустимые значения от 1 до 4294967295. Рекомендуется использовать приватный ASN в диапазоне 64512–65534 (16-битный ASN) или 4200000000–4294967294 (32-битный ASN).

--client-token (string)

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

--dry-run | --no-dry-run (boolean)

Проверка наличия необходимых разрешений для действия без фактического выполнения запроса и возвращения ответа об ошибке. Если у вас есть необходимые разрешения, ответ об ошибке будет DryRunOperation. В противном случае — UnauthorizedOperation.

--persist-routes (string)

Указывает, следует ли сохранять маршруты после завершения всех сессий BGP.

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

  • enable
  • disable
  • reset

--persist-routes-duration (long)

Количество минут, которое сервер маршрутизации будет ожидать после повторного установления BGP, чтобы удалить маршруты из FIB и RIB. Значение должно быть в диапазоне от 1 до 5. Требуется, если PersistRoutes равно enabled.

Если вы зададите продолжительность в 1 минуту, то при повторном подключении вашего сетевого устройства BGP с сервером маршрутизации у него будет 1 минута, чтобы повторно узнать соседнюю сеть и объявить эти маршруты серверу маршрутизации, прежде чем сервер маршрутизации возобновит нормальную работу. В большинстве случаев 1 минута, вероятно, достаточно. Однако если вы опасаетесь, что ваша сеть BGP может не полностью восстановить и переучить все за 1 минуту, вы можете увеличить продолжительность до 5 минут.

--sns-notifications-enabled | --no-sns-notifications-enabled (boolean)

Указывает, должны ли быть включены уведомления SNS для событий сервера маршрутизации. Включение уведомлений SNS сохраняет изменения состояния BGP в тему SNS, предоставленной Amazon Web Services.

--tag-specifications (list)

Теги, которые необходимо применить к серверу маршрутизации во время создания.

(структура)

Теги, которые необходимо применить к ресурсу при создании ресурса. При указании тега необходимо указать тип ресурса, иначе запрос завершится ошибкой.

Примечание

Valid Values перечисляет все типы ресурсов, которые могут быть помечены. Однако действие, которое вы используете, может не поддерживать маркирование всех этих типов ресурсов. Если вы попытаетесь пометить тип ресурса, который не поддерживается для используемого действия, вы получите ошибку.

ResourceType -> (string)

Тип ресурса, который нужно пометить при создании.

Tags -> (list)

Теги, которые нужно применить к ресурсу.

(структура)

Описание тега.

Key -> (string)

Ключ тега.

Ограничения: ключи тегов чувствительны к регистру и принимают не более 127 символов Unicode. Не должно начинаться с aws:.

Value -> (string)

Значение тега.

Ограничения: значения тегов чувствительны к регистру и принимают не более 256 символов Unicode.

Сокращенный синтаксис:

ResourceType=string,Tags=[{Key=string,Value=string},{Key=string,Value=string}] ...

Синтаксис JSON:

[
  {
    "ResourceType": "capacity-reservation"|"client-vpn-endpoint"|"customer-gateway"|"carrier-gateway"|"coip-pool"|"declarative-policies-report"|"dedicated-host"|"dhcp-options"|"egress-only-internet-gateway"|"elastic-ip"|"elastic-gpu"|"export-image-task"|"export-instance-task"|"fleet"|"fpga-image"|"host-reservation"|"image"|"import-image-task"|"import-snapshot-task"|"instance"|"instance-event-window"|"internet-gateway"|"ipam"|"ipam-pool"|"ipam-scope"|"ipv4pool-ec2"|"ipv6pool-ec2"|"key-pair"|"launch-template"|"local-gateway"|"local-gateway-route-table"|"local-gateway-virtual-interface"|"local-gateway-virtual-interface-group"|"local-gateway-route-table-vpc-association"|"local-gateway-route-table-virtual-interface-group-association"|"natgateway"|"network-acl"|"network-interface"|"network-insights-analysis"|"network-insights-path"|"network-insights-access-scope"|"network-insights-access-scope-analysis"|"outpost-lag"|"placement-group"|"prefix-list"|"replace-root-volume-task"|"reserved-instances"|"route-table"|"security-group"|"security-group-rule"|"service-link-virtual-interface"|"snapshot"|"spot-fleet-request"|"spot-instances-request"|"subnet"|"subnet-cidr-reservation"|"traffic-mirror-filter"|"traffic-mirror-session"|"traffic-mirror-target"|"transit-gateway"|"transit-gateway-attachment"|"transit-gateway-connect-peer"|"transit-gateway-multicast-domain"|"transit-gateway-policy-table"|"transit-gateway-route-table"|"transit-gateway-route-table-announcement"|"volume"|"vpc"|"vpc-endpoint"|"vpc-endpoint-connection"|"vpc-endpoint-service"|"vpc-endpoint-service-permission"|"vpc-peering-connection"|"vpn-connection"|"vpn-gateway"|"vpc-flow-log"|"capacity-reservation-fleet"|"traffic-mirror-filter-rule"|"vpc-endpoint-connection-device-type"|"verified-access-instance"|"verified-access-group"|"verified-access-endpoint"|"verified-access-policy"|"verified-access-trust-provider"|"vpn-connection-device-type"|"vpc-block-public-access-exclusion"|"route-server"|"route-server-endpoint"|"route-server-peer"|"ipam-resource-discovery"|"ipam-resource-discovery-association"|"instance-connect-endpoint"|"verified-access-endpoint-target"|"ipam-external-resource-verification-token"|"mac-modification-task",
    "Tags": [
      {
        "Key": "string",
        "Value": "string"
      }
      ...
    ]
  }
  ...
]

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

--generate-cli-skeleton (string) Выводит 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
  • таблица
  • yaml
  • yaml-поток

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

  • вкл
  • выкл
  • авто

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

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

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

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

Вывод

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

Информация о созданном сервере маршрутизации.

RouteServerId -> (string)

Уникальный идентификатор сервера маршрутизации.

AmazonSideAsn -> (long)

Автономный номер системы (ASN) протокола Border Gateway Protocol (BGP) для устройства. Допустимые значения от 1 до 4294967295. Рекомендуется использовать приватный ASN в диапазоне 64512–65534 (16-битный ASN) или 4200000000–4294967294 (32-битный ASN).

State -> (string)

Текущее состояние сервера маршрутизации.

Tags -> (list)

Присвоенные теги сервера маршрутизации.

(структура)

Описание тега.

Key -> (string)

Ключ тега.

Ограничения: ключи тегов чувствительны к регистру и принимают не более 127 символов Unicode. Не должно начинаться с aws:.

Value -> (string)

Значение тега.

Ограничения: значения тегов чувствительны к регистру и принимают не более 256 символов Unicode.

PersistRoutesState -> (string)

Текущее состояние сохранения маршрутов для сервера маршрутизации.

PersistRoutesDuration -> (long)

Количество минут, которое сервер маршрутизации будет ожидать после повторного установления BGP, чтобы удалить маршруты из FIB и RIB. Значение должно быть в диапазоне от 1 до 5. Значение по умолчанию — 1. Действительно только если persistRoutesState имеет значение ‘enabled’.

Если вы зададите продолжительность в 1 минуту, то при повторном подключении вашего сетевого устройства BGP с сервером маршрутизации у него будет 1 минута, чтобы повторно узнать соседнюю сеть и объявить эти маршруты серверу маршрутизации, прежде чем сервер маршрутизации возобновит нормальную работу. В большинстве случаев 1 минута, вероятно, достаточно. Однако если вы опасаетесь, что ваша сеть BGP может не полностью восстановить и переучить все за 1 минуту, вы можете увеличить продолжительность до 5 минут.

SnsNotificationsEnabled -> (boolean)

Указывает, включены ли уведомления SNS для сервера маршрутизации. Включение уведомлений SNS сохраняет изменения состояния BGP в тему SNS, предоставленной Amazon Web Services.

SnsTopicArn -> (string)

ARN темы SNS, в которую публикуются уведомления.

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

Spec-Zone.ru

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