Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

advertise-byoip-cidr

Описание

Рекламирует диапазон IPv4 или IPv6 адресов, предоставленных для использования с вашими ресурсами Amazon Web Services через собственную IP-адресацию (BYOIP).

Вы можете выполнить эту операцию не чаще чем раз в 10 секунд, даже если каждый раз вы указываете разные диапазоны адресов.

Рекомендуется прекратить рекламу BYOIP CIDR из других мест при рекламе его из Amazon Web Services. Для минимизации времени простоя вы можете настроить свои ресурсы Amazon Web Services на использование адреса из BYOIP CIDR до его рекламы, а затем одновременно прекратить рекламу его из текущего местоположения и начать рекламу через Amazon Web Services.

Может потребоваться несколько минут, прежде чем трафик по указанным адресам начнёт маршрутизироваться в Amazon Web Services из-за задержек распространения BGP.

Чтобы прекратить рекламу BYOIP CIDR, используйте WithdrawByoipCidr.

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

Синтаксис

  advertise-byoip-cidr
--cidr <value>
[--asn <value>]
[--dry-run | --no-dry-run]
[--network-border-group <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]

Параметры

--cidr (строка)

Диапазон адресов в CIDR-нотации. Он должен быть точно таким же диапазоном, который вы предоставили. Вы не можете рекламировать только часть предоставленного диапазона.

--asn (строка)

Общедоступный 2-байтовый или 4-байтовый ASN, который вы хотите рекламировать.

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

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

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

Если у вас включены локальные зоны, вы можете выбрать группу сетевых границ для локальных зон при предоставлении и рекламе BYOIPv4 CIDR. Тщательно выбирайте группу сетевых границ, поскольку EIP и ресурс Amazon Web Services, к которому он привязан, должны находиться в одной и той же группе сетевых границ.

Вы можете предоставлять диапазоны BYOIP-адресов и рекламировать их в следующих группах сетевых границ локальных зон:

  • us-east-1-dfw-2
  • us-west-2-lax-1
  • us-west-2-phx-2

Примечание

В настоящее время вы не можете предоставлять или рекламировать диапазоны BYOIPv6-адресов в локальных зонах.

--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
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

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

Для рекламы диапазона адресов

Следующий advertise-byoip-cidr пример рекламирует указанный общедоступный диапазон IPv4-адресов.

aws ec2 advertise-byoip-cidr \
    --cidr 203.0.113.25/24

Вывод:

{
    "ByoipCidr": {
        "Cidr": "203.0.113.25/24",
        "StatusMessage": "ipv4pool-ec2-1234567890abcdef0",
        "State": "provisioned"
    }
}

Вывод

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

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

Cidr -> (строка)

Диапазон адресов в CIDR-нотации.

Описание -> (строка)

Описание диапазона адресов.

AsnAssociations -> (список)

Связывания BYOIP CIDR с ASN.

(структура)

Связывание автономного номера системы (ASN) и BYOIP CIDR.

Asn -> (строка)

ASN связывания.

Cidr -> (строка)

CIDR связывания.

СтатусСообщение -> (строка)

Сообщение о статусе связывания.

Состояние -> (строка)

Состояние связывания.

СообщениеОСтатусе -> (строка)

В случае успеха содержит ID пула адресов. В противном случае содержит сообщение об ошибке.

Состояние -> (строка)

Состояние диапазона адресов.

  • advertised : Диапазон адресов рекламируется в интернете Amazon Web Services.
  • deprovisioned : Диапазон адресов депровижен.
  • failed-deprovision : Запрос на депровизирование диапазона адресов не удался. Убедитесь, что все EIP из диапазона были деаллоцированы, и попробуйте снова.
  • failed-provision : Запрос на провизионирование диапазона адресов не удался.
  • pending-deprovision : Вы отправили запрос на депровизирование диапазона адресов, и он находится в ожидании.
  • pending-provision : Вы отправили запрос на провизионирование диапазона адресов, и он находится в ожидании.
  • provisioned : Диапазон адресов предоставлен и может быть рекламирован. В данный момент диапазон не рекламируется.
  • provisioned-not-publicly-advertisable : Диапазон адресов предоставлен, но не может быть рекламирован.

ГруппаСетевыхГраниц -> (строка)

Если у вас включены локальные зоны, вы можете выбрать группу сетевых границ для локальных зон при предоставлении и рекламе BYOIPv4 CIDR. Тщательно выбирайте группу сетевых границ, поскольку EIP и ресурс Amazon Web Services, к которому он привязан, должны находиться в одной и той же группе сетевых границ.

Вы можете предоставлять диапазоны BYOIP-адресов и рекламировать их в следующих группах сетевых границ локальных зон:

  • us-east-1-dfw-2
  • us-west-2-lax-1
  • us-west-2-phx-2

Примечание

В настоящее время вы не можете предоставлять или рекламировать диапазоны BYOIPv6-адресов в локальных зонах.

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

Spec-Zone.ru

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