изменить-соединение-vpn

Описание

Изменяет клиентский шлюз или целевой шлюз подключения VPN «сайт-сайт» Amazon Web Services. Для изменения целевого шлюза доступны следующие варианты миграции:

• Существующий виртуальный частный шлюз на новый виртуальный частный шлюз
• Существующий виртуальный частный шлюз на шлюз транзита
• Существующий шлюз транзита на новый шлюз транзита
• Существующий шлюз транзита на виртуальный частный шлюз

Перед выполнением миграции на новый шлюз необходимо настроить новый шлюз. Используйте CreateVpnGateway для создания виртуального частного шлюза или CreateTransitGateway для создания шлюза транзита.

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

Необходимо удалить статические маршруты перед миграцией на новый шлюз.

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

После миграции на новый шлюз, возможно, потребуется изменить таблицу маршрутизации VPC. Используйте CreateRoute и DeleteRoute для внесения изменений, описанных в разделе «Обновление таблиц маршрутизации VPC» в руководстве пользователя Amazon Web Services Site-to-Site VPN.

Если новый шлюз — шлюз транзита, измените таблицу маршрутизации шлюза транзита, чтобы разрешить трафик между VPC и подключением VPN «сайт-сайт» Amazon Web Services. Используйте CreateTransitGatewayRoute для добавления маршрутов.

Если вы удалили статические маршруты VPN, необходимо добавить статические маршруты в таблицу маршрутизации шлюза транзита.

После выполнения этой операции IP-адреса конечной точки VPN со стороны Amazon Web Services и параметры туннеля остаются неизменными. Подключение VPN «сайт-сайт» Amazon Web Services будет временно недоступно в течение короткого периода времени, пока мы не настроим новые конечные точки.

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

Синтаксис

  modify-vpn-connection
--vpn-connection-id <value>
[--transit-gateway-id <value>]
[--customer-gateway-id <value>]
[--vpn-gateway-id <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]

Параметры

--vpn-connection-id (строка)

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

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

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

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

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

Примеры

Для изменения подключения VPN

В следующем modify-vpn-connection примере меняется целевой шлюз для подключения VPN vpn-12345678901234567 на виртуальный частный шлюз vgw-11223344556677889:

aws ec2 modify-vpn-connection \
    --vpn-connection-id vpn-12345678901234567 \
    --vpn-gateway-id vgw-11223344556677889

Вывод:

{
    "VpnConnection": {
        "CustomerGatewayConfiguration": "...configuration information...",
        "CustomerGatewayId": "cgw-aabbccddee1122334",
        "Category": "VPN",
        "State": "modifying",
        "Type": "ipsec.1",
        "VpnConnectionId": "vpn-12345678901234567",
        "VpnGatewayId": "vgw-11223344556677889",
        "Options": {
            "StaticRoutesOnly": false
        },
        "VgwTelemetry": [
            {
                "AcceptedRouteCount": 0,
                "LastStatusChange": "2019-07-17T07:34:00.000Z",
                "OutsideIpAddress": "18.210.3.222",
                "Status": "DOWN",
                "StatusMessage": "IPSEC IS DOWN"
            },
            {
                "AcceptedRouteCount": 0,
                "LastStatusChange": "2019-07-20T21:20:16.000Z",
                "OutsideIpAddress": "34.193.129.33",
                "Status": "DOWN",
                "StatusMessage": "IPSEC IS DOWN"
            }
        ]
    }
}

Вывод

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