Spec-Zone.ru › AWS CLI v2

[ aws . imagebuilder ]

обновить-политику-жизненного-цикла

Описание

Обновление указанной политики жизненного цикла.

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

Синтаксис

  update-lifecycle-policy
--lifecycle-policy-arn <value>
[--description <value>]
[--status <value>]
--execution-role <value>
--resource-type <value>
--policy-details <value>
--resource-selection <value>
[--client-token <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]

Параметры

--lifecycle-policy-arn (строка)

Amazon Resource Name (ARN) ресурса политики жизненного цикла.

--description (строка)

Необязательное описание для политики жизненного цикла.

--status (строка)

Указывает, включена ли политика жизненного цикла.

Возможные значения:

  • DISABLED
  • ENABLED

--execution-role (строка)

Имя или Amazon Resource Name (ARN) роли IAM, которую Image Builder использует для обновления политики жизненного цикла.

--resource-type (строка)

Тип ресурса образа, к которому применяется политика жизненного цикла.

Возможные значения:

  • AMI_IMAGE
  • CONTAINER_IMAGE

--policy-details (список)

Подробные данные конфигурации ресурса политики жизненного цикла.

(структура)

Подробные данные конфигурации ресурса политики жизненного цикла.

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

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

type -> (строка)

Указывает действие жизненного цикла, которое нужно выполнить.

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

Указывает ресурсы, к которым применяется политика жизненного цикла.

amis -> (логическое значение)

Указывает, должно ли действие жизненного цикла применяться к распределенным AMI.

snapshots -> (логическое значение)

Указывает, должно ли действие жизненного цикла применяться к снимкам, связанным с распределенными AMI.

containers -> (логическое значение)

Указывает, должно ли действие жизненного цикла применяться к распределенным контейнерам.

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

Указывает ресурсы, к которым применяется политика жизненного цикла.

type -> (строка)

Фильтровать ресурсы на основе либо age, либо count.

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

Количество единиц для временного периода или для подсчета. Например, значение 6 может относиться к шести месяцам или шести AMI.

Примечание

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

unit -> (строка)

Определяет единицу времени, которую политика жизненного цикла использует для определения затронутых ресурсов. Это необходимо для правил, основанных на возрасте.

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

Для фильтров, основанных на возрасте, это число ресурсов, которые необходимо сохранить после применения действия жизненного цикла DELETE. Затронутые ресурсы удаляются только в том случае, если у вас больше, чем это число ресурсов. Если ресурсов меньше, чем это число, затронутый ресурс не удаляется.

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

Дополнительные правила для указания ресурсов, которые должны быть исключены из действий политики.

tagMap -> (карта)

Содержит список тегов, которые Image Builder использует для пропуска действий жизненного цикла для ресурсов образа Image Builder, которые их имеют.

key -> (строка)

value -> (строка)

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

Перечисляет конфигурационные значения, которые применяются к AMI, которые Image Builder должен исключить из действия жизненного цикла.

isPublic -> (логическое значение)

Настраивает, исключаются ли публичные AMI из действия жизненного цикла.

regions -> (список)

Настраивает регионы Amazon Web Services, которые исключаются из действия жизненного цикла.

(строка)

sharedAccounts -> (список)

Указывает учетные записи Amazon Web Services, ресурсы которых исключаются из действия жизненного цикла.

(строка)

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

Указывает конфигурационные данные для Image Builder, чтобы исключить самые последние ресурсы из действий жизненного цикла.

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

Целое число единиц для временного периода. Например, 6 (месяцы).

unit -> (строка)

Определяет единицу времени, которую политика жизненного цикла использует для вычисления прошедшего времени с момента запуска последнего экземпляра из AMI. Например: дни, недели, месяцы или годы.

tagMap -> (карта)

Перечисляет теги, которые должны быть исключены из действий жизненного цикла для AMI, которые их имеют.

key -> (строка)

value -> (строка)

Синтаксис JSON:

[
  {
    "action": {
      "type": "DELETE"|"DEPRECATE"|"DISABLE",
      "includeResources": {
        "amis": true|false,
        "snapshots": true|false,
        "containers": true|false
      }
    },
    "filter": {
      "type": "AGE"|"COUNT",
      "value": integer,
      "unit": "DAYS"|"WEEKS"|"MONTHS"|"YEARS",
      "retainAtLeast": integer
    },
    "exclusionRules": {
      "tagMap": {"string": "string"
        ...},
      "amis": {
        "isPublic": true|false,
        "regions": ["string", ...],
        "sharedAccounts": ["string", ...],
        "lastLaunched": {
          "value": integer,
          "unit": "DAYS"|"WEEKS"|"MONTHS"|"YEARS"
        },
        "tagMap": {"string": "string"
          ...}
      }
    }
  }
  ...
]

--resource-selection (структура)

Критерии выбора ресурсов, к которым применяется политика жизненного цикла.

recipes -> (список)

Список рецептов, используемых в качестве критериев выбора выходных изображений, к которым применяется политика жизненного цикла.

(структура)

Указывает рецепт Image Builder, который политика жизненного цикла использует для выбора ресурсов.

name -> (строка)

Имя рецепта Image Builder, который политика жизненного цикла использует для выбора ресурсов.

semanticVersion -> (строка)

Версия рецепта Image Builder, указанная в поле name.

tagMap -> (карта)

Список тегов, используемых в качестве критериев выбора ресурсов образа Image Builder, к которым применяется политика жизненного цикла.

key -> (строка)

value -> (строка)

Упрощенный синтаксис:

recipes=[{name=string,semanticVersion=string},{name=string,semanticVersion=string}],tagMap={KeyName1=string,KeyName2=string}

Синтаксис JSON:

{
  "recipes": [
    {
      "name": "string",
      "semanticVersion": "string"
    }
    ...
  ],
  "tagMap": {"string": "string"
    ...}
}

--client-token (строка)

Уникальный, чувствительный к регистру идентификатор, который вы предоставляете, чтобы гарантировать идемпотентность запроса. Дополнительную информацию см. в разделе Обеспечение идемпотентности в разделе Справочник по API Amazon EC2.

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

Вывод

lifecyclePolicyArn -> (строка)

ARN обновленного ресурса политики жизненного цикла образа.

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

Spec-Zone.ru

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