Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

Изменение транзитной точки доступа

Описание

Изменяет указанную транзитную точку доступа. При изменении транзитной точки доступа измененные параметры применяются только к новым присоединениям транзитной точки доступа. Существующие присоединения транзитной точки доступа не изменяются.

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

Синтаксис

  modify-transit-gateway
--transit-gateway-id <value>
[--description <value>]
[--options <value>]
[--dry-run | --no-dry-run]
[--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]

Параметры

--transit-gateway-id (строка)

Идентификатор транзитной точки доступа.

--description (строка)

Описание транзитной точки доступа.

--options (структура)

Параметры для изменения.

AddTransitGatewayCidrBlocks -> (список)

Добавляет блоки CIDR IPv4 или IPv6 для транзитной точки доступа. Должен быть блоком CIDR размера /24 или больше для IPv4, или блоком CIDR размера /64 или больше для IPv6.

(строка)

RemoveTransitGatewayCidrBlocks -> (список)

Удаляет блоки CIDR для транзитной точки доступа.

(строка)

VpnEcmpSupport -> (строка)

Включить или отключить поддержку протокола Equal Cost Multipath.

DnsSupport -> (строка)

Включить или отключить поддержку DNS.

SecurityGroupReferencingSupport -> (строка)

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

Этот параметр по умолчанию отключен.

Для получения дополнительной информации о ссылке на группу безопасности см. Ссылка на группу безопасности в руководстве по транзитным точкам доступа Amazon Web Services.

AutoAcceptSharedAttachments -> (строка)

Включить или отключить автоматическое принятие запросов на подключение.

DefaultRouteTableAssociation -> (строка)

Включить или отключить автоматическое подключение к таблице маршрутизации по умолчанию.

AssociationDefaultRouteTableId -> (строка)

Идентификатор таблицы маршрутизации по умолчанию для подключения.

DefaultRouteTablePropagation -> (строка)

Включить или отключить автоматическое распространение маршрутов в таблицу маршрутизации по умолчанию для распространения.

PropagationDefaultRouteTableId -> (строка)

Идентификатор таблицы маршрутизации по умолчанию для распространения.

AmazonSideAsn -> (целое число)

Приватный автономный номер системы (ASN) для стороны Amazon сессии BGP. Диапазон составляет от 64512 до 65534 для 16-битных ASN и от 4200000000 до 4294967294 для 32-битных ASN.

Операция изменения ASN недоступна для транзитной точки доступа, если она имеет следующие подключения:

  • Динамический VPN
  • Статический VPN
  • Шлюз Direct Connect
  • Connect

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

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

AddTransitGatewayCidrBlocks=string,string,RemoveTransitGatewayCidrBlocks=string,string,VpnEcmpSupport=string,DnsSupport=string,SecurityGroupReferencingSupport=string,AutoAcceptSharedAttachments=string,DefaultRouteTableAssociation=string,AssociationDefaultRouteTableId=string,DefaultRouteTablePropagation=string,PropagationDefaultRouteTableId=string,AmazonSideAsn=long

Синтаксис JSON:

{
  "AddTransitGatewayCidrBlocks": ["string", ...],
  "RemoveTransitGatewayCidrBlocks": ["string", ...],
  "VpnEcmpSupport": "enable"|"disable",
  "DnsSupport": "enable"|"disable",
  "SecurityGroupReferencingSupport": "enable"|"disable",
  "AutoAcceptSharedAttachments": "enable"|"disable",
  "DefaultRouteTableAssociation": "enable"|"disable",
  "AssociationDefaultRouteTableId": "string",
  "DefaultRouteTablePropagation": "enable"|"disable",
  "PropagationDefaultRouteTableId": "string",
  "AmazonSideAsn": long
}

--dry-run | --no-dry-run (логическое значение)

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

--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
  • текст
  • таблица
  • 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.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. См. руководство по началу работы в руководстве пользователя AWS CLI для получения дополнительной информации.

Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной оболочки. См. Использование кавычек со строками в руководстве пользователя AWS CLI.

Изменение транзитной точки доступа

Следующий modify-transit-gateway пример изменяет указанную транзитную точку доступа, включив поддержку ECMP для подключений VPN.

aws ec2 modify-transit-gateway \
    --transit-gateway-id tgw-111111222222aaaaa \
    --options VpnEcmpSupport=enable

Вывод:

{
    "TransitGateway": {
        "TransitGatewayId": "tgw-111111222222aaaaa",
        "TransitGatewayArn": "64512",
        "State": "modifying",
        "OwnerId": "123456789012",
        "CreationTime": "2020-04-30T08:41:37.000Z",
        "Options": {
            "AmazonSideAsn": 64512,
            "AutoAcceptSharedAttachments": "disable",
            "DefaultRouteTableAssociation": "enable",
            "AssociationDefaultRouteTableId": "tgw-rtb-0123456789abcd123",
            "DefaultRouteTablePropagation": "enable",
            "PropagationDefaultRouteTableId": "tgw-rtb-0123456789abcd123",
            "VpnEcmpSupport": "enable",
            "DnsSupport": "enable"
        }
    }
}

Для получения дополнительной информации см. Транзитные точки доступа в руководстве по транзитным точкам доступа.

Вывод

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

Информация о транзитной точке доступа.

TransitGatewayId -> (строка)

Идентификатор транзитной точки доступа.

TransitGatewayArn -> (строка)

Amazon Resource Name (ARN) транзитной точки доступа.

State -> (строка)

Состояние транзитной точки доступа.

OwnerId -> (строка)

Идентификатор учетной записи Amazon Web Services, владеющей транзитной точкой доступа.

Description -> (строка)

Описание транзитной точки доступа.

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

Время создания.

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

Параметры транзитной точки доступа.

AmazonSideAsn -> (целое число)

Приватный автономный номер системы (ASN) для стороны Amazon сессии BGP. Диапазон составляет от 64512 до 65534 для 16-битных ASN и от 4200000000 до 4294967294 для 32-битных ASN.

TransitGatewayCidrBlocks -> (список)

Блоки CIDR транзитной точки доступа.

(строка)

AutoAcceptSharedAttachments -> (строка)

Указывает, принимаются ли запросы на подключение автоматически.

DefaultRouteTableAssociation -> (строка)

Указывает, подключаются ли ресурсы автоматически к таблице маршрутизации по умолчанию. Включено по умолчанию. Если defaultRouteTableAssociation установлено в enable, Amazon Web Services Transit Gateway создаст таблицу маршрутизации по умолчанию для транзитной точки доступа.

AssociationDefaultRouteTableId -> (строка)

Идентификатор таблицы маршрутизации по умолчанию для подключения.

DefaultRouteTablePropagation -> (строка)

Указывает, распространяются ли автоматически маршруты к таблице маршрутизации по умолчанию для распространения. Включено по умолчанию. Если defaultRouteTablePropagation установлено в enable, Amazon Web Services Transit Gateway создаст таблицу маршрутизации по умолчанию для транзитной точки доступа.

PropagationDefaultRouteTableId -> (строка)

Идентификатор таблицы маршрутизации по умолчанию для распространения.

VpnEcmpSupport -> (строка)

Указывает, включена ли поддержка протокола Equal Cost Multipath.

DnsSupport -> (строка)

Указывает, включена ли поддержка DNS.

SecurityGroupReferencingSupport -> (строка)

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

Этот параметр по умолчанию отключен.

MulticastSupport -> (строка)

Указывает, включен ли мультимедиа-трафик на транзитной точке доступа

Tags -> (список)

Теги транзитной точки доступа.

(структура)

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

Key -> (строка)

Ключ тега.

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

Value -> (строка)

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

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

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

Spec-Zone.ru

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