Spec-Zone.ru › AWS CLI v2

[ aws . dlm ]

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

Описание

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

Дополнительную информацию об обновлении политики см. в разделе Изменить политики жизненного цикла.

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

Синтаксис

  update-lifecycle-policy
--policy-id <value>
[--execution-role-arn <value>]
[--state <value>]
[--description <value>]
[--policy-details <value>]
[--create-interval <value>]
[--retain-interval <value>]
[--copy-tags | --no-copy-tags]
[--extend-deletion | --no-extend-deletion]
[--cross-region-copy-targets <value>]
[--exclusions <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]

Параметры

--policy-id (строка)

Идентификатор политики жизненного цикла.

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

Amazon Resource Name (ARN) роли IAM, используемой для выполнения операций, заданных политикой жизненного цикла.

--state (строка)

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

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

  • ENABLED
  • DISABLED

--description (строка)

Описание политики жизненного цикла.

--policy-details (структура)

Настройка политики жизненного цикла. Вы не можете обновить тип политики или тип ресурса.

PolicyType -> (строка)

Тип политики. Укажите EBS_SNAPSHOT_MANAGEMENT для создания политики жизненного цикла, управляющей жизненным циклом снимков Amazon EBS. Укажите IMAGE_MANAGEMENT для создания политики жизненного цикла, управляющей жизненным циклом образов AMIs с поддержкой EBS. Укажите EVENT_BASED_POLICY, чтобы создать политику на основе событий, которая выполняет определенные действия при наступлении определенного события в вашей учетной записи Amazon Web Services.

По умолчанию EBS_SNAPSHOT_MANAGEMENT.

ResourceTypes -> (список)

[Только политики снимков пользовательской настройки] Целевой тип ресурса для политик жизненного цикла снимков и образов AMI. Используйте VOLUME для создания снимков отдельных томов или используйте INSTANCE для создания снимков нескольких томов из томов для экземпляра.

(строка)

ResourceLocations -> (список)

[Только политики снимков и образов AMI пользовательской настройки] Местоположение ресурсов для резервного копирования.
  • Если исходные ресурсы расположены в Регионе, укажите CLOUD. В этом случае политика охватывает все ресурсы указанного типа с соответствующими тегами целевого назначения по всем зонам доступности в Регионе.
  • [Только политики снимков пользовательской настройки] Если исходные ресурсы расположены в локальной зоне, укажите LOCAL_ZONE. В этом случае политика охватывает все ресурсы указанного типа с соответствующими тегами целевого назначения по всем локальным зонам в Регионе.
  • Если исходные ресурсы находятся на Outpost в вашей учетной записи, укажите OUTPOST. В этом случае политика охватывает все ресурсы указанного типа с соответствующими тегами целевого назначения по всем Outpost в вашей учетной записи.

(строка)

TargetTags -> (список)

[Только политики снимков и образов AMI пользовательской настройки] Единственный тег, который идентифицирует целевые ресурсы для этой политики.

(структура)

Указывает тег для ресурса.

Key -> (строка)

Ключ тега.

Value -> (строка)

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

Schedules -> (список)

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

(структура)

[Только пользовательские политики снимков и AMI] Определяет расписание для политики жизненного цикла снимков или AMI.

Name -> (строка)

Имя расписания.

CopyTags -> (булево)

Копировать все пользовательские теги на исходный том в снимки тома, созданные этой политикой.

TagsToAdd -> (список)

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

(структура)

Определяет тег для ресурса.

Key -> (строка)

Ключ тега.

Value -> (строка)

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

VariableTags -> (список)

[Политики AMI и политики снимков, которые нацелены только на экземпляры] Коллекция пар ключ/значение со значениями, определяемыми динамически во время выполнения политики. Ключи могут быть любым допустимым ключом тега Amazon EC2. Значения должны быть в одном из двух следующих форматов: $(instance-id) или $(timestamp). Переменные теги допустимы только для управления снимками EBS — политики экземпляров.

(структура)

Определяет тег для ресурса.

Key -> (строка)

Ключ тега.

Value -> (строка)

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

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

Правило создания.

Location -> (строка)

[Только пользовательские политики снимков] Указывает место назначения для снимков, созданных политикой. Разрешенные места назначения зависят от расположения целевых ресурсов.
  • Если политика нацелена на ресурсы в Регионе, то необходимо создать снимки в том же Регионе, что и исходный ресурс.
  • Если политика нацелена на ресурсы в локальной зоне, вы можете создать снимки в той же локальной зоне или в родительском Регионе.
  • Если политика нацелена на ресурсы на Outpost, вы можете создать снимки на том же Outpost или в родительском Регионе.

Укажите одно из следующих значений:

  • Для создания снимков в том же Регионе, что и исходный ресурс, укажите CLOUD.
  • Для создания снимков в той же локальной зоне, что и исходный ресурс, укажите LOCAL_ZONE.
  • Для создания снимков на том же Outpost, что и исходный ресурс, укажите OUTPOST_LOCAL.

По умолчанию: CLOUD

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

Интервал между снимками. Допустимые значения — 1, 2, 3, 4, 6, 8, 12 и 24.

IntervalUnit -> (строка)

Единица интервала.

Times -> (список)

Время, в формате UTC, для начала операции. Поддерживаемый формат — чч:мм.

Операция выполняется в течение одного часа после указанного времени. Если вы не укажете время, Amazon Data Lifecycle Manager выберет время в течение следующих 24 часов.

(строка)

CronExpression -> (строка)

Расписание в формате Cron. Интервал расписания должен быть от 1 часа до 1 года. Дополнительная информация находится в справке по выражениям Cron в руководстве пользователя Amazon EventBridge.

Scripts -> (список)

[Только пользовательские политики снимков, нацеленные только на экземпляры] Определяет скрипты до и/или после для политики жизненного цикла снимков, нацеленной только на экземпляры. Это полезно для создания снимков с учетом состояния приложения или для выполнения определенных административных задач до или после того, как Amazon Data Lifecycle Manager инициирует создание снимка.

Дополнительная информация находится в разделе Автоматизация снимков с учетом состояния приложения с помощью скриптов до и после.

(структура)

[Только пользовательские политики снимков, нацеленные только на экземпляры] Информация о скриптах до и/или после для политики жизненного цикла снимков, нацеленной только на экземпляры. Дополнительная информация находится в разделе Автоматизация снимков с учетом состояния приложения с помощью скриптов до и после.

Stages -> (список)

Указывает, какие скрипты Amazon Data Lifecycle Manager должен запустить на целевых экземплярах. Скрипты до запускаются перед тем, как Amazon Data Lifecycle Manager инициирует создание снимка. Скрипты после запускаются после того, как Amazon Data Lifecycle Manager инициирует создание снимка.

  • Для запуска только скрипта до, укажите PRE. В этом случае Amazon Data Lifecycle Manager вызывает документ SSM с параметром pre-script перед началом создания снимка.
  • Для запуска только скрипта после, укажите POST. В этом случае Amazon Data Lifecycle Manager вызывает документ SSM с параметром post-script после начала создания снимка.
  • Для запуска скриптов до и после, укажите оба параметра PRE и POST. В этом случае Amazon Data Lifecycle Manager вызывает документ SSM с параметром pre-script перед началом создания снимка, а затем снова вызывает документ SSM с параметром post-script после начала создания снимка.

Если вы автоматизируете резервные копии VSS, пропустите этот параметр.

По умолчанию: ДО и ПОСЛЕ

(строка)

ExecutionHandlerService -> (строка)

Указывает службу, используемую для выполнения скриптов до и/или после.

  • Если вы используете пользовательские документы SSM или автоматизируете снимки с учетом состояния приложения рабочих нагрузок SAP HANA, укажите AWS_SYSTEMS_MANAGER.
  • Если вы автоматизируете резервные копии VSS, пропустите этот параметр.

По умолчанию: AWS_SYSTEMS_MANAGER

ExecutionHandler -> (строка)

Документ SSM, содержащий скрипты до и/или после, которые необходимо выполнить.

  • Если вы автоматизируете резервные копии VSS, укажите AWS_VSS_BACKUP. В этом случае Amazon Data Lifecycle Manager автоматически использует документ SSM AWSEC2-CreateVssSnapshot.
  • Если вы автоматизируете снимки с учетом состояния приложения для рабочих нагрузок SAP HANA, укажите AWSSystemsManagerSAP-CreateDLMSnapshotForSAPHANA.
  • Если вы используете собственный пользовательский документ SSM, укажите имя или ARN документа SSM. Если вы используете общий пользовательский документ SSM, укажите ARN документа SSM.

ExecuteOperationOnScriptFailure -> (булево)

Указывает, должен ли Amazon Data Lifecycle Manager по умолчанию использовать снимки с ошибками, если скрипт до завершился неудачно.

  • Для использования по умолчанию снимков с ошибками, если скрипт до завершился неудачно, укажите true.
  • Для пропуска экземпляра для создания снимка, если скрипт до завершился неудачно, укажите false.

Этот параметр поддерживается только при выполнении скрипта до. Если выполняется только скрипт после, пропустите этот параметр.

По умолчанию: true

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

Указывает временной интервал ожидания в секундах, после которого Amazon Data Lifecycle Manager прекращает попытку выполнения скрипта, если она не завершена. Если скрипт не завершается в течение времени ожидания, Amazon Data Lifecycle Manager прекращает попытку. Время ожидания применимо для скриптов до и после индивидуально.

Если вы автоматизируете резервные копии VSS, пропустите этот параметр.

По умолчанию: 10

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

Указывает количество попыток, которое Amazon Data Lifecycle Manager должен предпринять для повторного выполнения скриптов, завершившихся неудачно.

  • Если скрипт до завершается неудачно, Amazon Data Lifecycle Manager повторяет весь процесс создания снимка, включая выполнение скриптов до и после.
  • Если скрипт после завершается неудачно, Amazon Data Lifecycle Manager повторяет только скрипт после; в этом случае скрипт до будет выполнен, а снимок, возможно, будет создан.

Если вы не хотите, чтобы Amazon Data Lifecycle Manager повторял неудачные скрипты, укажите 0.

По умолчанию: 0

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

Правило хранения для снимков или AMI, созданных политикой.

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

Количество снимков для хранения для каждого тома, максимум 1000. Например, если вы хотите сохранить максимум три снимка, укажите 3. Когда создается четвертый снимок, самый старый сохраненный снимок удаляется или перемещается в архивный уровень, если вы указали ArchiveRule.

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

Срок хранения каждого снимка. Максимальное значение — 100 лет. Это эквивалентно 1200 месяцам, 5200 неделям или 36500 дням.

IntervalUnit -> (строка)

Единица времени для хранения по времени. Например, чтобы сохранить снимки на 3 месяца, укажите Interval=3 и IntervalUnit=MONTHS. После того, как снимок хранился в течение 3 месяцев, он удаляется или перемещается в архивный уровень, если вы указали ArchiveRule.

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

[Только пользовательские политики снимков] Правило для включения быстрого восстановления снимков.

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

Количество снимков, которые необходимо включить в быстрое восстановление снимков.

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

Срок действия быстрого восстановления снимков. Максимальное значение — 100 лет. Это эквивалентно 1200 месяцам, 5200 неделям или 36500 дням.

IntervalUnit -> (строка)

Единица времени для включения быстрого восстановления снимков.

AvailabilityZones -> (список)

Зоны доступности, в которых необходимо включить быстрое восстановление снимков.

(строка)

CrossRegionCopyRules -> (список)

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

Примечание

Вы не можете указать правила копирования между регионами для политик, которые создают снимки на Outpost или в Local Zone. Если политика создает снимки в Регионе, то снимки могут быть скопированы вплоть до трех Регионов или Outpost.

(структура)

[Только пользовательские политики снимков и AMI] Указывает правило копирования снимков и AMI между регионами для политики.

Примечание

Для указания действия копирования между регионами для политик на основе событий используйте CrossRegionCopyAction .

TargetRegion -> (строка)

Примечание

Используйте этот параметр только для политик AMI. Для политик снимков используйте параметр Target. Для политик снимков, созданных до введения параметра Target, этот параметр указывает целевой Регион для копирования снимков.

[Только пользовательские политики AMI] Целевой Регион или Amazon Resource Name (ARN) целевого Outpost для копирования снимков.

Target -> (строка)

Примечание

Используйте этот параметр только для политик снимков. Для политик AMI используйте TargetRegion.

[Только пользовательские политики снимков] Целевой Регион или Amazon Resource Name (ARN) целевого Outpost для копирования снимков.

Encrypted -> (булево)

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

CmkArn -> (строка)

Amazon Resource Name (ARN) ключа KMS для шифрования EBS. Если этот параметр не указан, используется ключевое значение KMS по умолчанию для учетной записи.

CopyTags -> (булево)

Указывает, нужно ли копировать все пользовательские теги из исходного снимка или AMI в копию между регионами.

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

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

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

Период времени для хранения копии снимка или AMI между регионами. Максимальное значение — 100 лет. Это эквивалентно 1200 месяцам, 5200 неделям или 36500 дням.

IntervalUnit -> (строка)

Единица измерения времени для хранения по времени. Например, чтобы сохранить копию между регионами на 3 месяца, укажите Interval=3 и IntervalUnit=MONTHS.

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

[Только пользовательские политики AMI] Правило устаревания AMI для копий AMI между регионами, созданных по правилу.

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

Период, после которого копии AMI между регионами устаревают. Период должен быть меньше или равен периоду хранения копии AMI между регионами и не может быть больше 10 лет. Это эквивалентно 120 месяцам, 520 неделям или 3650 дням.

IntervalUnit -> (строка)

Единица измерения времени для измерения Interval. Например, чтобы сделать копию AMI между регионами устаревшей через 3 месяца, укажите Interval=3 и IntervalUnit=MONTHS.

ShareRules -> (список)

[Только пользовательские политики снимков] Правило для совместного использования снимков с другими учетными записями Amazon Web Services.

(структура)

[Только пользовательские политики снимков] Указывает правило для совместного использования снимков между учетными записями Amazon Web Services.

TargetAccounts -> (список)

Идентификаторы учетных записей Amazon Web Services, с которыми нужно поделиться снимками.

(строка)

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

Период, после которого снимки, которые были совместно использованы с другими учетными записями Amazon Web Services, автоматически перестают быть совместно используемыми.

UnshareIntervalUnit -> (строка)

Единица измерения времени для автоматического интервала отмены совместного использования.

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

[Только пользовательские политики AMI] Правило устаревания AMI для расписания.

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

Если расписание имеет правило хранения на основе количества, этот параметр указывает количество самых старых AMI, которые нужно сделать устаревшими. Количество должно быть меньше или равно количеству сохраняемых в расписании AMI, и оно не может быть больше 1000.

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

Если расписание имеет правило хранения на основе возраста, этот параметр указывает период, после которого AMIs, созданные по расписанию, устаревают. Период должен быть меньше или равен периоду хранения по расписанию, и он не может быть больше 10 лет. Это эквивалентно 120 месяцам, 520 неделям или 3650 дням.

IntervalUnit -> (строка)

Единица измерения времени для измерения Interval.

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

[Только пользовательские политики снимков, которые нацелены только на тома] Правило архивирования снимков для расписания. При указании правила архивирования снимки автоматически перемещаются из стандартного уровня в уровень архива после того, как будет достигнут порог хранения расписания. Затем снимки хранятся в уровне архива в течение периода хранения архива, который вы указываете.

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

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

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

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

Информация о периоде хранения в архиве Amazon EBS Snapshots. Дополнительную информацию см. в разделе Архивирование снимков Amazon EBS.

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

Максимальное количество снимков, которые нужно сохранить в уровне хранения архива для каждого тома. Количество должно обеспечить, чтобы каждый снимок оставался в уровне архива не менее 90 дней. Например, если расписание создает снимки каждые 30 дней, необходимо указать количество 3 или более, чтобы убедиться, что каждый снимок архивируется не менее 90 дней.

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

Указывает период времени для хранения снимков в уровне архива. По истечении этого периода снимок будет постоянно удален.

IntervalUnit -> (строка)

Единица измерения времени для измерения Interval. Например, чтобы сохранить снимки в уровне архива на 6 месяцев, укажите Interval=6 и IntervalUnit=MONTHS.

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

[Только пользовательские политики снимков и AMI] Набор необязательных параметров для политик жизненного цикла снимков и AMI.

Примечание

Если вы изменяете политику, которая была создана или ранее изменялась с помощью консоли Amazon Data Lifecycle Manager, необходимо включить этот параметр и указать либо значения по умолчанию, либо новые необходимые значения. Вы не можете опустить этот параметр или установить его значения в null.

ExcludeBootVolume -> (булево)

[Только пользовательские политики снимков, нацеленные только на экземпляры] Указывает, нужно ли исключить системный том из наборов снимков нескольких томов. По умолчанию значение false. Если вы укажете true, то корневые тома, подключенные к целевым экземплярам, будут исключены из наборов снимков нескольких томов, созданных политикой.

NoReboot -> (булево)

[Только пользовательские политики AMI] Указывает, нужно ли перезагружать целевые экземпляры при выполнении политики жизненного цикла. true указывает, что целевые экземпляры не перезагружаются при выполнении политики. false указывает, что целевые экземпляры перезагружаются при выполнении политики. По умолчанию значение true (экземпляры не перезагружаются).

ExcludeDataVolumeTags -> (список)

[Только пользовательские политики снимков, нацеленные только на экземпляры] Теги, используемые для идентификации томов данных (не системных) для исключения из наборов снимков нескольких томов.

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

(структура)

Указывает тег для ресурса.

Key -> (строка)

Ключ тега.

Value -> (строка)

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

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

[Только политики на основе событий] Событие, которое активирует политику на основе событий.

Type -> (строка)

Источник события. В настоящее время поддерживаются только управляемые правила CloudWatch Events.

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

Информация о событии.

EventType -> (строка)

Тип события. В настоящее время поддерживаются только события совместного использования снимков.

SnapshotOwner -> (список)

Идентификаторы учетных записей Amazon Web Services, которые могут инициировать политику путем совместного использования снимков с вашей учетной записью. Политика выполняется только в том случае, если одна из указанных учетных записей Amazon Web Services совместно использует снимок с вашей учетной записью.

(строка)

DescriptionRegex -> (строка)

Описание снимка, которое может инициировать политику. Шаблон описания задается с помощью регулярного выражения. Политика выполняется только в том случае, если снимок с описанием, соответствующим указанному шаблону, совместно используется с вашей учетной записью.

Например, указание ^.*Created for policy: policy-1234567890abcdef0.*$ настраивает политику на выполнение только в том случае, если снимки, созданные политикой policy-1234567890abcdef0, совместно используются с вашей учетной записью.

Actions -> (список)

[Только политики, основанные на событиях] Действия, которые должны выполняться при активации политики, основанной на событиях. Вы можете указать только одно действие на политику.

(структура)

[Только политики, основанные на событиях] Указывает действие для политики, основанной на событиях.

Имя -> (строка)

Описание действия.

CrossRegionCopy -> (список)

Правило для копирования общих моментальных снимков между регионами.

(структура)

[Только политики, основанные на событиях] Указывает действие копирования между регионами для политик, основанных на событиях.

Примечание

Для указания правила копирования между регионами для политик моментальных снимков и AMI используйте CrossRegionCopyRule.

Целевой регион -> (строка)

Целевой регион.

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

Настройки шифрования для скопированного моментального снимка.

Зашифровано -> (булево)

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

CmkArn -> (строка)

Amazon Resource Name (ARN) ключа KMS для использования в шифровании EBS. Если этот параметр не указан, используется ключ KMS по умолчанию для учетной записи.

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

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

Интервал -> (целое число)

Время хранения копии моментального снимка или AMI между регионами. Максимальное значение составляет 100 лет. Это эквивалентно 1200 месяцам, 5200 неделям или 36500 дням.

Единица интервала -> (строка)

Единица времени для хранения по времени. Например, чтобы сохранить копию между регионами в течение 3 месяцев, укажите Interval=3 и IntervalUnit=MONTHS .

PolicyLanguage -> (строка)

Тип политики для создания. Укажите одно из следующего:

  • SIMPLIFIED Чтобы создать политику по умолчанию.
  • STANDARD Чтобы создать пользовательскую политику.

ResourceType -> (строка)

[Только политики по умолчанию] Укажите тип политики по умолчанию для создания.
  • Чтобы создать политику по умолчанию для моментальных снимков EBS, которая создает моментальные снимки всех томов в регионе, которые не имеют последних резервных копий, укажите VOLUME .
  • Чтобы создать политику по умолчанию для AMI с поддержкой EBS, которая создает AMI с поддержкой EBS из всех экземпляров в регионе, которые не имеют последних резервных копий, укажите INSTANCE .

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

[Только политики по умолчанию] Указывает, как часто политика должна запускаться и создавать моментальные снимки или AMI. Частота создания может составлять от 1 до 7 дней. Если вы не укажете значение, значение по умолчанию будет 1.

По умолчанию: 1

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

[Только политики по умолчанию] Указывает, как долго политика должна хранить моментальные снимки или AMI перед их удалением. Период хранения может составлять от 2 до 14 дней, но он должен быть больше частоты создания, чтобы гарантировать, что политика сохраняет как минимум 1 моментальный снимок или AMI в любой момент времени. Если вы не укажете значение, значение по умолчанию будет 7.

По умолчанию: 7

CopyTags -> (булево)

[Только политики по умолчанию] Указывает, должна ли политика копировать теги из исходного ресурса в моментальный снимок или AMI. Если вы не укажете значение, значение по умолчанию будет false .

По умолчанию: false

CrossRegionCopyTargets -> (список)

[Только политики по умолчанию] Указывает целевые регионы для копий моментальных снимков или AMI. Вы можете указать до 3 целевых регионов. Если вы не хотите создавать копии между регионами, опустите этот параметр.

(структура)

[Только политики по умолчанию] Указывает целевой регион для действий копирования между регионами.

TargetRegion -> (строка)

Целевой регион, например us-east-1 .

ExtendDeletion -> (булево)

[Только политики по умолчанию] Определяет поведение хранения моментальных снимков или AMI для политики, если исходный том или экземпляр удалены, или если политика переходит в состояние ошибки, отключена или удалена.

По умолчанию (ExtendDeletion=false ):

  • Если исходный ресурс удален, Amazon Data Lifecycle Manager продолжит удалять ранее созданные моментальные снимки или AMI, до, но не включая последний, в соответствии с указанным периодом хранения. Если вы хотите, чтобы Amazon Data Lifecycle Manager удалял все моментальные снимки или AMI, включая последний, укажите true .
  • Если политика переходит в состояние ошибки, отключена или удалена, Amazon Data Lifecycle Manager прекращает удаление моментальных снимков и AMI. Если вы хотите, чтобы Amazon Data Lifecycle Manager продолжал удалять моментальные снимки или AMI, включая последний, если политика переходит в одно из этих состояний, укажите true .

Если вы включите расширенное удаление (ExtendDeletion=true ), вы одновременно переопределите оба поведения по умолчанию.

Если вы не укажете значение, значение по умолчанию будет false .

По умолчанию: false

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

[Только политики по умолчанию] Указывает параметры исключения для томов или экземпляров, для которых вы не хотите создавать моментальные снимки или AMI. Политика не будет создавать моментальные снимки или AMI для целевых ресурсов, соответствующих любому из указанных параметров исключения.

ExcludeBootVolumes -> (булево)

[Только политики по умолчанию для моментальных снимков EBS] Указывает, следует ли исключать тома, подключенные к экземплярам в качестве загрузочного тома. Если вы исключаете загрузочные тома, только тома, подключенные в качестве данных (не загрузочных) томов, будут резервироваться политикой. Чтобы исключить загрузочные тома, укажите true .

ExcludeVolumeTypes -> (список)

[Только политики по умолчанию для моментальных снимков EBS] Указывает типы томов для исключения. Тома указанных типов не будут являться целью политики.

(строка)

ExcludeTags -> (список)

[Только политики по умолчанию для AMI с поддержкой EBS] Указывает, следует ли исключать тома, имеющие определенные теги.

(структура)

Указывает тег для ресурса.

Ключ -> (строка)

Ключ тега.

Значение -> (строка)

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

Синтаксис JSON:

{
  "PolicyType": "EBS_SNAPSHOT_MANAGEMENT"|"IMAGE_MANAGEMENT"|"EVENT_BASED_POLICY",
  "ResourceTypes": ["VOLUME"|"INSTANCE", ...],
  "ResourceLocations": ["CLOUD"|"OUTPOST"|"LOCAL_ZONE", ...],
  "TargetTags": [
    {
      "Key": "string",
      "Value": "string"
    }
    ...
  ],
  "Schedules": [
    {
      "Name": "string",
      "CopyTags": true|false,
      "TagsToAdd": [
        {
          "Key": "string",
          "Value": "string"
        }
        ...
      ],
      "VariableTags": [
        {
          "Key": "string",
          "Value": "string"
        }
        ...
      ],
      "CreateRule": {
        "Location": "CLOUD"|"OUTPOST_LOCAL"|"LOCAL_ZONE",
        "Interval": integer,
        "IntervalUnit": "HOURS",
        "Times": ["string", ...],
        "CronExpression": "string",
        "Scripts": [
          {
            "Stages": ["PRE"|"POST", ...],
            "ExecutionHandlerService": "AWS_SYSTEMS_MANAGER",
            "ExecutionHandler": "string",
            "ExecuteOperationOnScriptFailure": true|false,
            "ExecutionTimeout": integer,
            "MaximumRetryCount": integer
          }
          ...
        ]
      },
      "RetainRule": {
        "Count": integer,
        "Interval": integer,
        "IntervalUnit": "DAYS"|"WEEKS"|"MONTHS"|"YEARS"
      },
      "FastRestoreRule": {
        "Count": integer,
        "Interval": integer,
        "IntervalUnit": "DAYS"|"WEEKS"|"MONTHS"|"YEARS",
        "AvailabilityZones": ["string", ...]
      },
      "CrossRegionCopyRules": [
        {
          "TargetRegion": "string",
          "Target": "string",
          "Encrypted": true|false,
          "CmkArn": "string",
          "CopyTags": true|false,
          "RetainRule": {
            "Interval": integer,
            "IntervalUnit": "DAYS"|"WEEKS"|"MONTHS"|"YEARS"
          },
          "DeprecateRule": {
            "Interval": integer,
            "IntervalUnit": "DAYS"|"WEEKS"|"MONTHS"|"YEARS"
          }
        }
        ...
      ],
      "ShareRules": [
        {
          "TargetAccounts": ["string", ...],
          "UnshareInterval": integer,
          "UnshareIntervalUnit": "DAYS"|"WEEKS"|"MONTHS"|"YEARS"
        }
        ...
      ],
      "DeprecateRule": {
        "Count": integer,
        "Interval": integer,
        "IntervalUnit": "DAYS"|"WEEKS"|"MONTHS"|"YEARS"
      },
      "ArchiveRule": {
        "RetainRule": {
          "RetentionArchiveTier": {
            "Count": integer,
            "Interval": integer,
            "IntervalUnit": "DAYS"|"WEEKS"|"MONTHS"|"YEARS"
          }
        }
      }
    }
    ...
  ],
  "Parameters": {
    "ExcludeBootVolume": true|false,
    "NoReboot": true|false,
    "ExcludeDataVolumeTags": [
      {
        "Key": "string",
        "Value": "string"
      }
      ...
    ]
  },
  "EventSource": {
    "Type": "MANAGED_CWE",
    "Parameters": {
      "EventType": "shareSnapshot",
      "SnapshotOwner": ["string", ...],
      "DescriptionRegex": "string"
    }
  },
  "Actions": [
    {
      "Name": "string",
      "CrossRegionCopy": [
        {
          "Target": "string",
          "EncryptionConfiguration": {
            "Encrypted": true|false,
            "CmkArn": "string"
          },
          "RetainRule": {
            "Interval": integer,
            "IntervalUnit": "DAYS"|"WEEKS"|"MONTHS"|"YEARS"
          }
        }
        ...
      ]
    }
    ...
  ],
  "PolicyLanguage": "SIMPLIFIED"|"STANDARD",
  "ResourceType": "VOLUME"|"INSTANCE",
  "CreateInterval": integer,
  "RetainInterval": integer,
  "CopyTags": true|false,
  "CrossRegionCopyTargets": [
    {
      "TargetRegion": "string"
    }
    ...
  ],
  "ExtendDeletion": true|false,
  "Exclusions": {
    "ExcludeBootVolumes": true|false,
    "ExcludeVolumeTypes": ["string", ...],
    "ExcludeTags": [
      {
        "Key": "string",
        "Value": "string"
      }
      ...
    ]
  }
}

--create-interval (целое число)

[Только политики по умолчанию] Указывает, как часто политика должна запускаться и создавать моментальные снимки или AMI. Частота создания может составлять от 1 до 7 дней.

--retain-interval (целое число)

[Только политики по умолчанию] Указывает, как долго политика должна хранить моментальные снимки или AMI перед их удалением. Период хранения может составлять от 2 до 14 дней, но он должен быть больше частоты создания, чтобы гарантировать, что политика сохраняет как минимум 1 моментальный снимок или AMI в любой момент времени.

--copy-tags | --no-copy-tags (булево)

[Только политики по умолчанию] Указывает, должна ли политика копировать теги из исходного ресурса в моментальный снимок или AMI.

--extend-deletion | --no-extend-deletion (булево)

[Только политики по умолчанию] Определяет поведение хранения моментальных снимков или AMI для политики, если исходный том или экземпляр удалены, или если политика переходит в состояние ошибки, отключена или удалена.

По умолчанию (ExtendDeletion=false ):

  • Если исходный ресурс удален, Amazon Data Lifecycle Manager продолжит удалять ранее созданные моментальные снимки или AMI, до, но не включая последний, в соответствии с указанным периодом хранения. Если вы хотите, чтобы Amazon Data Lifecycle Manager удалял все моментальные снимки или AMI, включая последний, укажите true .
  • Если политика переходит в состояние ошибки, отключена или удалена, Amazon Data Lifecycle Manager прекращает удаление моментальных снимков и AMI. Если вы хотите, чтобы Amazon Data Lifecycle Manager продолжал удалять моментальные снимки или AMI, включая последний, если политика переходит в одно из этих состояний, укажите true .

Если вы включите расширенное удаление (ExtendDeletion=true ), вы одновременно переопределите оба поведения по умолчанию.

По умолчанию: false

--cross-region-copy-targets (список)

[Только политики по умолчанию] Указывает целевые регионы для копий моментальных снимков или AMI. Вы можете указать до 3 целевых регионов. Если вы не хотите создавать копии между регионами, опустите этот параметр.

(структура)

[Только политики по умолчанию] Указывает целевой регион для действий копирования между регионами.

TargetRegion -> (строка)

Целевой регион, например us-east-1 .

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

TargetRegion=string ...

Синтаксис JSON:

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

--exclusions (структура)

[Только политики по умолчанию] Указывает параметры исключения для томов или экземпляров, для которых вы не хотите создавать моментальные снимки или AMI. Политика не будет создавать моментальные снимки или AMI для целевых ресурсов, соответствующих любому из указанных параметров исключения.

ExcludeBootVolumes -> (булево)

[Только политики по умолчанию для моментальных снимков EBS] Указывает, следует ли исключать тома, подключенные к экземплярам в качестве загрузочного тома. Если вы исключаете загрузочные тома, только тома, подключенные в качестве данных (не загрузочных) томов, будут резервироваться политикой. Чтобы исключить загрузочные тома, укажите true .

ExcludeVolumeTypes -> (список)

[Только политики по умолчанию для моментальных снимков EBS] Указывает типы томов для исключения. Тома указанных типов не будут являться целью политики.

(строка)

ExcludeTags -> (список)

[Только политики по умолчанию для AMI с поддержкой EBS] Указывает, следует ли исключать тома, имеющие определенные теги.

(структура)

Указывает тег для ресурса.

Ключ -> (строка)

Ключ тега.

Значение -> (строка)

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

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

ExcludeBootVolumes=boolean,ExcludeVolumeTypes=string,string,ExcludeTags=[{Key=string,Value=string},{Key=string,Value=string}]

Синтаксис JSON:

{
  "ExcludeBootVolumes": true|false,
  "ExcludeVolumeTypes": ["string", ...],
  "ExcludeTags": [
    {
      "Key": "string",
      "Value": "string"
    }
    ...
  ]
}

--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
  • text
  • таблица
  • 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-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

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

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

Пример 1: Включение политики жизненного цикла

Следующий update-lifecycle-policy пример включает указанную политику жизненного цикла.

aws dlm update-lifecycle-policy \
    --policy-id policy-0123456789abcdef0 \
    --state ENABLED

Пример 2: Отключение политики жизненного цикла

Следующий update-lifecycle-policy пример отключает указанную политику жизненного цикла.

aws dlm update-lifecycle-policy \
    --policy-id policy-0123456789abcdef0 \
    --state DISABLED

Пример 3: Обновление деталей политики жизненного цикла

Следующий update-lifecycle-policy пример обновляет целевые теги для указанной политики жизненного цикла.

aws dlm update-lifecycle-policy \
    --policy-id policy-0123456789abcdef0
    --policy-details file://policyDetails.json

Содержимое policyDetails.json. Другие детали, не указанные в этом файле, не изменяются командой.

{
    "TargetTags": [
        {
            "Key": "costCenter",
            "Value": "120"
        },
        {
            "Key": "project",
            "Value": "lima"
        }
    ]
}

Вывод

Нет

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

Spec-Zone.ru

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