Spec-Zone.ru › AWS CLI v2

[ aws . dlm ]

get-lifecycle-policy

Описание

Получает подробную информацию о заданном правиле жизненного цикла.

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

Синтаксис

  get-lifecycle-policy
--policy-id <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 (строка)

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

--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
  • table
  • yaml
  • yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

Используемый регион. Переопределяет параметры конфигурации/среды.

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

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

Примеры

Примечание

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

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

Для описания правила жизненного цикла

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

aws dlm get-lifecycle-policy \
    --policy-id policy-0123456789abcdef0

Вывод:

{
    "Policy": {
        "PolicyId": "policy-0123456789abcdef0",
        "Description": "My policy",
        "State": "ENABLED",
        "ExecutionRoleArn": "arn:aws:iam::123456789012:role/AWSDataLifecycleManagerDefaultRole",
        "DateCreated": "2019-08-08T17:45:42Z",
        "DateModified": "2019-08-08T17:45:42Z",
        "PolicyDetails": {
            "PolicyType": "EBS_SNAPSHOT_MANAGEMENT",
            "ResourceTypes": [
                "VOLUME"
            ],
            "TargetTags": [
              {
                  "Key": "costCenter",
                  "Value": "115"
              }
            ],
            "Schedules": [
              {
                  "Name": "DailySnapshots",
                  "CopyTags": true,
                  "TagsToAdd": [
                    {
                        "Key": "type",
                        "Value": "myDailySnapshot"
                    }
                  ],
                  "CreateRule": {
                    "Interval": 24,
                    "IntervalUnit": "HOURS",
                    "Times": [
                        "03:00"
                    ]
                  },
                  "RetainRule": {
                    "Count": 5
                  }
              }
            ]
        }
    }
}

Вывод

Политика -> (структура)

Подробная информация о правиле жизненного цикла.

PolicyId -> (строка)

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

Описание -> (строка)

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

Состояние -> (строка)

Состояние активации правила жизненного цикла.

Сообщение о статусе -> (строка)

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

ExecutionRoleArn -> (строка)

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

Дата создания -> (метка времени)

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

Дата изменения -> (метка времени)

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

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

Настройка правила жизненного цикла

PolicyType -> (строка)

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

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

ResourceTypes -> (список)

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

(строка)

ResourceLocations -> (список)

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

(строка)

TargetTags -> (список)

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

(структура)

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

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

Ключ тега.

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

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

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. Поддерживаемый формат hh:mm.

Операция выполняется в течение одного часа после указанного времени. Если вы не указываете время, 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, опустите этот параметр.

По умолчанию: PRE и POST

(строка)

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 или в локальной зоне. Если политика создает снимки в регионе, то снимки могут быть скопированы в до трех регионов или 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, которые нужно сделать устаревшими. Количество должно быть меньше или равно количеству хранения расписания, и оно не может быть больше 1000.

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

Если расписание имеет правило хранения на основе возраста, этот параметр указывает период, после которого созданные по расписанию AMI устаревают. Период должен быть меньше или равен периоду хранения расписания, и он не может быть больше 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 (ARN) ключа KMS, который следует использовать для шифрования EBS. Если этот параметр не указан, используется ключ KMS по умолчанию для учетной записи.

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

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

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

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

IntervalUnit -> (строка)

Единица измерения времени для хранения по времени. Например, чтобы сохранить копию между регионами в течение 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] Указывает, следует ли исключать тома, имеющие определенные метки.

(структура)

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

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

Ключ метки.

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

Значение метки.

Tags -> (карта)

Метки.

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

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

PolicyArn -> (строка)

Идентификатор ресурса Amazon (ARN) политики.

DefaultPolicy -> (булево)

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

  • true - политика является политикой по умолчанию.
  • false - политика является пользовательской политикой.

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

Spec-Zone.ru

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