Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

modify-managed-prefix-list

Описание

Изменяет указанный управляемый список префиксов.

Добавление или удаление записей в списке префиксов создает новую версию списка префиксов. Изменение имени списка префиксов не влияет на версию.

Если вы укажете номер текущей версии, не соответствующий истинному текущему номеру версии, запрос завершится ошибкой.

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

Синтаксис

  modify-managed-prefix-list
[--dry-run | --no-dry-run]
--prefix-list-id <value>
[--current-version <value>]
[--prefix-list-name <value>]
[--add-entries <value>]
[--remove-entries <value>]
[--max-entries <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)

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

--prefix-list-id (string)

Идентификатор списка префиксов.

--current-version (long)

Текущая версия списка префиксов.

--prefix-list-name (string)

Имя списка префиксов.

--add-entries (list)

Одна или несколько записей для добавления в список префиксов.

(структура)

Запись для списка префиксов.

Cidr -> (string)

Блок CIDR.

Description -> (string)

Описание записи.

Ограничения: Длина до 255 символов.

Краткая запись:

Cidr=string,Description=string ...

Синтаксис JSON:

[
  {
    "Cidr": "string",
    "Description": "string"
  }
  ...
]

--remove-entries (list)

Одна или несколько записей для удаления из списка префиксов.

(структура)

Запись для списка префиксов.

Cidr -> (string)

Блок CIDR.

Краткая запись:

Cidr=string ...

Синтаксис JSON:

[
  {
    "Cidr": "string"
  }
  ...
]

--max-entries (integer)

Максимальное количество записей для списка префиксов. Вы не можете изменить записи списка префиксов и изменить размер списка префиксов одновременно.

Если какой-либо из ресурсов, ссылающихся на список префиксов, не может поддерживать новый максимальный размер, операция модификации завершится ошибкой. Проверьте сообщение о состоянии для идентификаторов первых десяти ресурсов, которые не поддерживают новый максимальный размер.

--cli-input-json | --cli-input-yaml (string) Считывает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного значения JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (string) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если предоставлено значение без значения или значение input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, оно проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (boolean)

Включить отладовую запись.

--endpoint-url (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

  • json
  • text
  • таблица
  • yaml
  • yaml-поток

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

  • вкл
  • выкл
  • авто

--no-sign-request (boolean)

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

--ca-bundle (string)

Файл с набором сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/окружения.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования, который будет использоваться для двоичных блоков. По умолчанию используется формат 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.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

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

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

Следующий modify-managed-prefix-list пример добавляет запись в указанный список префиксов.

aws ec2 modify-managed-prefix-list \
    --prefix-list-id pl-0123456abcabcabc1 \
    --add-entries Cidr=10.1.0.0/16,Description=vpc-c \
    --current-version 1

Вывод:

{
    "PrefixList": {
        "PrefixListId": "pl-0123456abcabcabc1",
        "AddressFamily": "IPv4",
        "State": "modify-in-progress",
        "PrefixListArn": "arn:aws:ec2:us-west-2:123456789012:prefix-list/pl-0123456abcabcabc1",
        "PrefixListName": "vpc-cidrs",
        "MaxEntries": 10,
        "Version": 1,
        "OwnerId": "123456789012"
    }
}

Дополнительную информацию см. в разделе Управляемые списки префиксов в Руководстве пользователя Amazon VPC.

Вывод

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

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

PrefixListId -> (строка)

Идентификатор списка префиксов.

AddressFamily -> (строка)

Версия IP-адреса.

State -> (строка)

Текущее состояние списка префиксов.

StateMessage -> (строка)

Сообщение о состоянии.

PrefixListArn -> (строка)

Amazon Resource Name (ARN) для списка префиксов.

PrefixListName -> (строка)

Имя списка префиксов.

MaxEntries -> (целое число)

Максимальное количество записей для списка префиксов.

Version -> (длинное число)

Версия списка префиксов.

Tags -> (список)

Теги для списка префиксов.

(структура)

Описание тега.

Key -> (строка)

Ключ тега.

Ограничения: Ключи тегов чувствительны к регистру и принимают максимум 127 символов Юникода. Не может начинаться с aws: .

Value -> (строка)

Значение тега.

Ограничения: Значения тегов чувствительны к регистру и принимают максимум 256 символов Юникода.

OwnerId -> (строка)

Идентификатор владельца списка префиксов.

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

Spec-Zone.ru

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