Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

associate-address

Описание

Ассоциирует Elastic IP-адрес или адрес транспортного канала (для экземпляров, которые находятся в подсетях в зонах Wavelength) с экземпляром или сетевым интерфейсом. Прежде чем использовать Elastic IP-адрес, необходимо его выделить для вашей учетной записи.

Если Elastic IP-адрес уже ассоциирован с другим экземпляром, он отвязывается от него и ассоциируется с указанным экземпляром. Если вы ассоциируете Elastic IP-адрес с экземпляром, который уже имеет Elastic IP-адрес, существующий адрес отвязывается от экземпляра, но остается выделенным для вашей учетной записи.

[Подсети в зонах Wavelength] Вы можете ассоциировать IP-адрес транспортного канала с экземпляром или сетевым интерфейсом.

Вы не можете ассоциировать Elastic IP-адрес с интерфейсом в другой группе границ сети.

Предупреждение

Эта операция идемпотентна. Если вы выполните операцию более одного раза, Amazon EC2 не вернет ошибку, и вам может быть взимается плата каждый раз, когда Elastic IP-адрес перенаправляется на тот же экземпляр. Дополнительную информацию см. в разделе «Elastic IP-адреса» в документации по ценообразованию Amazon EC2.

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

Синтаксис

  associate-address
[--allocation-id <value>]
[--instance-id <value>]
[--public-ip <value>]
[--dry-run | --no-dry-run]
[--network-interface-id <value>]
[--private-ip-address <value>]
[--allow-reassociation | --no-allow-reassociation]
[--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]

Параметры

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

Идентификатор выделения. Требуется.

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

Идентификатор экземпляра. Экземпляр должен иметь ровно один подключенный сетевой интерфейс. Вы можете указать либо ID экземпляра, либо ID сетевого интерфейса, но не оба.

--public-ip (строка)

Устарело.

--dry-run | --no-dry-run (булево)

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

--network-interface-id (строка)

Идентификатор сетевого интерфейса. Если экземпляр имеет более одного сетевого интерфейса, необходимо указать ID сетевого интерфейса.

Вы можете указать либо ID экземпляра, либо ID сетевого интерфейса, но не оба.

--private-ip-address (строка)

Основной или дополнительный частный IP-адрес для ассоциации с Elastic IP-адресом. Если частный IP-адрес не указан, Elastic IP-адрес ассоциируется с основным частным IP-адресом.

--allow-reassociation | --no-allow-reassociation (булево)

Переассоциация происходит автоматически, но вы можете указать false, чтобы убедиться, что операция завершится неудачно, если Elastic IP-адрес уже ассоциирован с другим ресурсом.

--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 в руководстве пользователя AWS CLI.

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

Пример 1: Ассоциация Elastic IP-адреса с экземпляром

Следующий associate-address пример ассоциирует Elastic IP-адрес с указанным экземпляром EC2.

aws ec2 associate-address \
    --instance-id i-0b263919b6498b123 \
    --allocation-id eipalloc-64d5890a

Вывод:

{
    "AssociationId": "eipassoc-2bebb745"
}

Пример 2: Ассоциация Elastic IP-адреса с сетевым интерфейсом

Следующий associate-address пример ассоциирует указанный Elastic IP-адрес с указанным сетевым интерфейсом.

aws ec2 associate-address
    --allocation-id eipalloc-64d5890a \
    --network-interface-id eni-1a2b3c4d

Вывод:

{
    "AssociationId": "eipassoc-2bebb745"
}

Пример 3: Ассоциация Elastic IP-адреса с частным IP-адресом

Следующий associate-address пример ассоциирует указанный Elastic IP-адрес с указанным частным IP-адресом в указанном сетевом интерфейсе.

aws ec2 associate-address \
    --allocation-id eipalloc-64d5890a \
    --network-interface-id eni-1a2b3c4d \
    --private-ip-address 10.0.0.85

Вывод:

{
    "AssociationId": "eipassoc-2bebb745"
}

Дополнительную информацию см. в разделе «Elastic IP-адреса» в руководстве пользователя Amazon EC2.

Вывод

AssociationId -> (строка)

Идентификатор, представляющий ассоциацию Elastic IP-адреса с экземпляром.

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

Spec-Zone.ru

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