Spec-Zone.ru › AWS CLI v2

[ aws . imagebuilder ]

create-lifecycle-policy

Описание

Создать ресурс политики жизненного цикла.

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

Синтаксис

  create-lifecycle-policy
--name <value>
[--description <value>]
[--status <value>]
--execution-role <value>
--resource-type <value>
--policy-details <value>
--resource-selection <value>
[--tags <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]

Параметры

--name (строка)

Имя политики жизненного цикла для создания.

--description (строка)

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

--status (строка)

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

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

  • DISABLED
  • ENABLED

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

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

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

Тип ресурса Image Builder, на который распространяется политика жизненного цикла.

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

  • 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"
    ...}
}

--tags (карта)

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

key -> (строка)

value -> (строка)

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

KeyName1=string,KeyName2=string

Синтаксис JSON:

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

Вывод

clientToken -> (строка)

Токен клиента, уникально идентифицирующий запрос.

lifecyclePolicyArn -> (строка)

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

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

Spec-Zone.ru

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