[ 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 (строка)
Указывает, включена ли политика жизненного цикла.
Возможные значения:
DISABLEDENABLED
--execution-role (строка)
--resource-type (строка)
Тип ресурса Image Builder, на который распространяется политика жизненного цикла.
Возможные значения:
AMI_IMAGECONTAINER_IMAGE
--policy-details (список)
Детали конфигурации правил политики жизненного цикла.
(структура)
Детали конфигурации ресурса политики жизненного цикла.
action -> (структура)
Детали конфигурации действия политики.
type -> (строка)
includeResources -> (структура)
Указывает ресурсы, на которые распространяется политика жизненного цикла.
amis -> (булево)
snapshots -> (булево)
containers -> (булево)
filter -> (структура)
Указывает ресурсы, на которые распространяется политика жизненного цикла.
type -> (строка)
age или count.value -> (целое число)
Количество единиц для временного периода или счётчика. Например, значение 6 может означать шесть месяцев или шесть AMI.
Примечание
Для фильтров, основанных на подсчёте, это значение представляет минимальное количество ресурсов, которые следует сохранить. Если ресурсов меньше, чем это число, ресурс исключается из действий жизненного цикла.unit -> (строка)
retainAtLeast -> (целое число)
DELETE. Затронутые ресурсы удаляются только в том случае, если у вас больше ресурсов, чем это число. Если ресурсов меньше, чем это число, затронутый ресурс не удаляется.exclusionRules -> (структура)
Дополнительные правила для указания ресурсов, которые должны быть исключены из действий политики.
tagMap -> (карта)
Содержит список тегов, которые Image Builder использует для пропуска действий жизненного цикла для ресурсов изображений Image Builder, у которых они есть.
key -> (строка)
value -> (строка)
amis -> (структура)
Перечисляет значения конфигурации, которые применяются к AMI, которые Image Builder должен исключить из действия жизненного цикла.
isPublic -> (булево)
regions -> (список)
Настраивает регионы Amazon Web Services, которые исключаются из действия жизненного цикла.
(строка)
sharedAccounts -> (список)
Указывает учётные записи Amazon Web Services, ресурсы которых исключаются из действия жизненного цикла.
(строка)
lastLaunched -> (структура)
Указывает параметры конфигурации для Image Builder, чтобы исключить самые последние ресурсы из действий жизненного цикла.
value -> (целое число)
6 (месяцев).unit -> (строка)
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 -> (строка)
semanticVersion -> (строка)
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 (строка)
--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 -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.