освободить-назначение-пула-ipam

Описание

Освободите назначение внутри пула IPAM. Регион, который вы используете, должен быть локацией пула IPAM. Локация — это регион Amazon Web Services, где этот пул IPAM доступен для назначений. Вы можете использовать этот параметр только для освобождения ручных назначений. Чтобы удалить назначение для ресурса без удаления ресурса, установите его состояние мониторинга в значение false с помощью ModifyIpamResourceCidr. Дополнительную информацию см. в разделе Освобождение назначения в руководстве пользователя Amazon VPC IPAM.

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

Синтаксис

  release-ipam-pool-allocation
[--dry-run | --no-dry-run]
--ipam-pool-id <value>
--cidr <value>
--ipam-pool-allocation-id <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]

Параметры

--dry-run | --no-dry-run (boolean)

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

--cidr (строка)

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

--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 (boolean)

Включить отладочную регистрацию.

--endpoint-url (строка)

Переопределить адрес URL по умолчанию команды указанным URL-адресом.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования выходных данных команды.

• json
• text
• table
• yaml
• yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

• on
• off
• auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--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 (boolean)

Отключить вывод кли паджера.

--cli-auto-prompt (boolean)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматическое запросы параметров ввода CLI.

Примеры

Освобождение назначения пула IPAM

В этом примере вы — администратор, делегированный IPAM, который пытался удалить пул IPAM, но получил ошибку, что нельзя удалить пул, пока в нем есть назначения. Вы используете эту команду для освобождения назначения пула.

Обратите внимание на следующее:

• Вы можете использовать эту команду только для пользовательских назначений. Чтобы удалить назначение для ресурса без удаления ресурса, установите его состояние мониторинга в значение false с помощью modify-ipam-resource-cidr.
• Для завершения запроса вам потребуется идентификатор пула IPAM, который можно получить с помощью describe-ipam-pools. Вам также потребуется идентификатор назначения, который можно получить с помощью get-ipam-pool-allocations.
• Если вы не хотите удалять назначения по одному, вы можете использовать --cascade option при удалении пула IPAM, чтобы автоматически освободить все назначения в пуле перед его удалением.
• Существует ряд предварительных условий перед запуском этой команды. Дополнительную информацию см. в разделе Освобождение назначения в руководстве пользователя Amazon VPC IPAM.
• Регион --region, в котором вы запускаете эту команду, должен соответствовать локации пула IPAM, где находится назначение.

Следующий release-ipam-pool-allocation пример освобождает назначение пула IPAM.

aws ec2 release-ipam-pool-allocation \
    --ipam-pool-id ipam-pool-07bdd12d7c94e4693 \
    --cidr 10.0.0.0/23 \
    --ipam-pool-allocation-id ipam-pool-alloc-0e66a1f730da54791b99465b79e7d1e89 \
    --region us-west-1

Вывод:

{
    "Success": true
}

После освобождения назначения вы можете запустить delete-ipam-pool.

Вывод

Успех -> (boolean)