Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

associate-vpc-cidr-block

Описание

Связывает блок CIDR с вашей VPC. Вы можете связать дополнительный блок CIDR IPv4, блок CIDR IPv6, предоставленный Amazon, или блок CIDR IPv6 из пула адресов IPv6, который вы настроились через предоставление собственных IP-адресов (BYOIP).

В запросе необходимо указать один из следующих параметров: блок CIDR IPv4, пул IPv6 или блок CIDR IPv6, предоставленный Amazon.

Дополнительную информацию о связывании блоков CIDR с вашей VPC и соответствующих ограничениях см. в разделе «IP-адресация для ваших VPC и подсетей» в руководстве пользователя Amazon VPC.

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

Синтаксис

  associate-vpc-cidr-block
[--cidr-block <value>]
[--ipv6-cidr-block-network-border-group <value>]
[--ipv6-pool <value>]
[--ipv6-cidr-block <value>]
[--ipv4-ipam-pool-id <value>]
[--ipv4-netmask-length <value>]
[--ipv6-ipam-pool-id <value>]
[--ipv6-netmask-length <value>]
--vpc-id <value>
[--amazon-provided-ipv6-cidr-block | --no-amazon-provided-ipv6-cidr-block]
[--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]

Параметры

--cidr-block (строка)

Блок CIDR IPv4 для связи с VPC.

--ipv6-cidr-block-network-border-group (строка)

Имя расположения, из которого мы рекламируем блок CIDR IPv6. Используйте этот параметр, чтобы ограничить блок CIDR этим расположением.

Вы должны установить AmazonProvidedIpv6CidrBlock на true, чтобы использовать этот параметр.

Вы можете иметь одно сопоставление блока CIDR IPv6 на группу сетевых границ.

--ipv6-pool (строка)

Идентификатор пула адресов IPv6, из которого следует выделить блок CIDR IPv6.

--ipv6-cidr-block (строка)

Блок CIDR IPv6 из пула адресов IPv6. Вы также должны указать Ipv6Pool в запросе.

Чтобы Amazon выбрал для вас блок CIDR IPv6, опустите этот параметр.

--ipv4-ipam-pool-id (строка)

Связывает CIDR, выделенный из пула IP-адресов IPv4 IPAM, с VPC. Дополнительную информацию об Amazon VPC IP Address Manager (IPAM) см. в разделе Что такое IPAM? в руководстве пользователя Amazon VPC IPAM.

--ipv4-netmask-length (целое число)

Длина маски сети блока CIDR IPv4, который вы хотите связать из пула адресов Amazon VPC IP Address Manager (IPAM). Дополнительную информацию об IPAM см. в разделе Что такое IPAM? в руководстве пользователя Amazon VPC IPAM.

--ipv6-ipam-pool-id (строка)

Связывает CIDR, выделенный из пула адресов IPv6 IPAM, с VPC. Дополнительную информацию об Amazon VPC IP Address Manager (IPAM) см. в разделе Что такое IPAM? в руководстве пользователя Amazon VPC IPAM.

--ipv6-netmask-length (целое число)

Длина маски сети блока CIDR IPv6, который вы хотите связать из пула адресов Amazon VPC IP Address Manager (IPAM). Дополнительную информацию об IPAM см. в разделе Что такое IPAM? в руководстве пользователя Amazon VPC IPAM.

--vpc-id (строка)

Идентификатор VPC.

--amazon-provided-ipv6-cidr-block | --no-amazon-provided-ipv6-cidr-block (логическое значение)

Запрашивает предоставленный Amazon блок CIDR IPv6 с длиной префикса /56 для VPC. Вы не можете указать диапазон адресов IPv6 или размер блока CIDR.

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

Пример 1: Связывание предоставленного Amazon блока CIDR IPv6 с VPC

Следующий associate-vpc-cidr-block пример связывает блок CIDR IPv6 со указанной VPC.

aws ec2 associate-vpc-cidr-block \
    --amazon-provided-ipv6-cidr-block \
    --ipv6-cidr-block-network-border-group us-west-2-lax-1  \
    --vpc-id vpc-8EXAMPLE

Вывод:

{
    "Ipv6CidrBlockAssociation": {
        "AssociationId": "vpc-cidr-assoc-0838ce7d9dEXAMPLE",
        "Ipv6CidrBlockState": {
            "State": "associating"
        },
        "NetworkBorderGroup": "us-west-2-lax-1"
    },
    "VpcId": "vpc-8EXAMPLE"
}

Пример 2: Связывание дополнительного блока CIDR IPv4 с VPC

Следующий associate-vpc-cidr-block пример связывает блок CIDR IPv4 10.2.0.0/16 со указанной VPC.

aws ec2 associate-vpc-cidr-block \
    --vpc-id vpc-1EXAMPLE \
    --cidr-block 10.2.0.0/16

Вывод:

{
    "CidrBlockAssociation": {
        "AssociationId": "vpc-cidr-assoc-2EXAMPLE",
        "CidrBlock": "10.2.0.0/16",
        "CidrBlockState": {
            "State": "associating"
        }
    },
    "VpcId": "vpc-1EXAMPLE"
}

Вывод

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

Информация о сопоставлении блока CIDR IPv6.

AssociationId -> (строка)

Идентификатор сопоставления блока CIDR IPv6.

Ipv6CidrBlock -> (строка)

Блок CIDR IPv6.

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

Информация о состоянии блока CIDR.

State -> (строка)

Состояние блока CIDR.

StatusMessage -> (строка)

Сообщения о состоянии блока CIDR, если применимо.

NetworkBorderGroup -> (строка)

Имя уникального набора зон доступности, локальных зон или зон Wavelength, из которых Amazon Web Services рекламирует IP-адреса, например, us-east-1-wl1-bos-wlz-1.

Ipv6Pool -> (строка)

Идентификатор пула адресов IPv6, из которого выделен блок CIDR IPv6.

Ipv6AddressAttribute -> (строка)

Общедоступные IP-адреса IPv6 — это те, которые рекламируются в интернете с помощью Amazon Web Services. Частные IP-адреса не рекламируются и не могут быть рекламированы в интернете с помощью Amazon Web Services.

IpSource -> (строка)

Источник, который выделил пространство IP-адресов. byoip или amazon указывает общедоступное пространство IP-адресов, выделенное Amazon, или пространство, которое вы выделили с помощью Bring your own IP (BYOIP). none указывает частное пространство.

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

Информация о сопоставлении блока CIDR IPv4.

AssociationId -> (строка)

Идентификатор сопоставления блока CIDR IPv4.

CidrBlock -> (строка)

Блок CIDR IPv4.

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

Информация о состоянии блока CIDR.

State -> (строка)

Состояние блока CIDR.

StatusMessage -> (строка)

Сообщения о состоянии блока CIDR, если применимо.

VpcId -> (строка)

Идентификатор VPC.

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

Spec-Zone.ru

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