Spec-Zone.ru › AWS CLI v2

[ aws . backup ]

get-backup-plan

Описание

Возвращает BackupPlan детали для указанного BackupPlanId. Детали представляют собой тело плана резервного копирования в формате JSON, а также метаданные плана.

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

Синтаксис

  get-backup-plan
--backup-plan-id <value>
[--version-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]

Параметры

--backup-plan-id (строка)

Уникально идентифицирует план резервного копирования.

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

Уникальные, случайным образом сгенерированные, строки Unicode, закодированные в UTF-8, длина которых не превышает 1024 байта. Идентификаторы версий нельзя редактировать.

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

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

Получение деталей плана резервного копирования

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

aws backup get-backup-plan \
    --backup-plan-id "fcbf5d8f-bd77-4f3a-9c97-f24fb3d373a5"

Вывод:

{
    "BackupPlan": {
        "BackupPlanName": "Example-Backup-Plan",
        "Rules": [
            {
                "RuleName": "DailyBackups",
                "TargetBackupVaultName": "Default",
                "ScheduleExpression": "cron(0 5 ? * * *)",
                "StartWindowMinutes": 480,
                "CompletionWindowMinutes": 10080,
                "Lifecycle": {
                    "DeleteAfterDays": 35
                },
                "RuleId": "70e0ccdc-e9df-4e83-82ad-c1e5a9471cc3"
            }
        ]
    },
    "BackupPlanId": "fcbf5d8f-bd77-4f3a-9c97-f24fb3d373a5",
    "BackupPlanArn": "arn:aws:backup:us-west-2:123456789012:backup-plan:fcbf5d8f-bd77-4f3a-9c97-f24fb3d373a5",
    "VersionId": "NjQ2ZTZkODktMGVhNy00MmQ0LWE4YjktZTkwNTQ3OTkyYTcw",
    "CreationDate": 1568926091.57
}

Для получения дополнительной информации см. Создание плана резервного копирования в Руководстве разработчика AWS Backup.

Вывод

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

Определяет тело плана резервного копирования. Включает BackupPlanName и один или несколько наборов Rules.

BackupPlanName -> (строка)

Отображаемое имя плана резервного копирования. Должно содержать только буквенно-цифровые символы или специальные символы «-_.».

Если это задано в консоли, оно может содержать от 1 до 50 символов; если задано через командную строку или API, оно может содержать от 1 до 200 символов.

Rules -> (список)

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

(структура)

Определяет запланированную задачу для резервного копирования выбранного набора ресурсов.

RuleName -> (строка)

Отображаемое имя правила резервного копирования. Должно содержать от 1 до 50 буквенно-цифровых символов или символов «-_.».

TargetBackupVaultName -> (строка)

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

ScheduleExpression -> (строка)

Выражение cron в формате UTC, определяющее, когда Backup запускает задачу резервного копирования. Дополнительную информацию об выражениях cron Amazon Web Services см. в разделе Выражения расписания для правил в Руководстве пользователя Amazon CloudWatch Events. Два примера выражений cron Amazon Web Services: 15 * ? * * * (создавать резервную копию каждый час в 15 минут после часа) и 0 12 * * ? * (создавать резервную копию каждый день в 12:00 по UTC). Для таблицы примеров перейдите по приведенной ссылке и прокрутите страницу вниз.

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

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

В течение периода ожидания статус задачи резервного копирования остается в состоянии CREATED, пока она не начнётся успешно или пока не истечёт время ожидания. Если в течение времени ожидания Backup получает ошибку, позволяющую перепробовать задачу, Backup автоматически будет перепробовать запуск задачи не реже чем каждые 10 минут, пока резервное копирование не начнется успешно (статус задачи изменится на RUNNING) или пока статус задачи не изменится на EXPIRED (что ожидается при истечении времени ожидания).

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

Значение в минутах после успешного запуска задачи резервного копирования, по истечении которых она должна быть завершена, иначе Backup её отменит. Это значение необязательно.

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

Жизненный цикл определяет, когда защищённый ресурс переводится в холодное хранилище и когда он истекает. Backup автоматически переводит и истекает резервные копии в соответствии с определённым Вами жизненным циклом.

Резервные копии, переведённые в холодное хранилище, должны храниться в холодном хранилище не менее 90 дней. Поэтому значение «retention» должно быть на 90 дней больше, чем значение «transition to cold after days». Значение «transition to cold after days» изменить нельзя после того, как резервная копия была переведена в холодное хранилище.

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

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

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

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

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

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

Если значение равно true, ваш план резервного копирования переводит поддерживаемые ресурсы в уровень архива (холодного) хранилища в соответствии с настройками жизненного цикла.

RecoveryPointTags -> (карта)

Теги, назначенные ресурсам, связанным с этим правилом при восстановлении из резервной копии.

key -> (строка)

value -> (строка)

RuleId -> (строка)

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

CopyActions -> (список)

Массив объектов CopyAction, содержащих детали операции копирования.

(структура)

Детали операции копирования.

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

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

Резервные копии, переведённые в холодное хранилище, должны храниться в холодном хранилище не менее 90 дней. Поэтому в консоли значение «retention» должно быть на 90 дней больше, чем значение «transition to cold after days». Значение «transition to cold after days» изменить нельзя после того, как резервная копия была переведена в холодное хранилище.

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

Чтобы удалить существующие периоды жизненного цикла и хранения и сохранить точки восстановления неопределённо долго, укажите -1 для MoveToColdStorageAfterDays и DeleteAfterDays.

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

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

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

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

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

Если значение равно true, ваш план резервного копирования переводит поддерживаемые ресурсы в уровень архива (холодного) хранилища в соответствии с настройками жизненного цикла.

DestinationBackupVaultArn -> (строка)

Идентификатор ресурса Amazon (ARN), уникально идентифицирующий целевое хранилище резервных копий для скопированной резервной копии. Например, arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault.

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

Указывает, создаёт ли Backup непрерывные резервные копии. Значение true заставляет Backup создавать непрерывные резервные копии, поддерживающие восстановление по состоянию на определённую точку времени (PITR). Значение false (или не указано) заставляет Backup создавать резервные копии в виде снимков.

ScheduleExpressionTimezone -> (строка)

Часовой пояс, в котором задано выражение расписания. По умолчанию выражения расписания указаны в UTC. Вы можете изменить это на указанный часовой пояс.

IndexActions -> (список)

IndexActions — это массив, используемый для указания способа индексирования данных резервного копирования.

Каждое BackupRule может иметь 0 или 1 IndexAction, так как каждая резервная копия может иметь не более одного индекса.

В массиве присутствует ResourceType. Будет принято только одно значение для каждого BackupRule.

(структура)

Это необязательный массив в рамках BackupRule.

IndexAction состоит из одного ResourceTypes.

ResourceTypes -> (список)

Для каждого BackupRule будет принято 0 или 1 действие индексирования.

Допустимые значения:

  • EBS для Amazon Elastic Block Store
  • S3 для Amazon Simple Storage Service (Amazon S3)

(строка)

AdvancedBackupSettings -> (список)

Содержит список BackupOptions для каждого типа ресурса.

(структура)

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

ResourceType -> (строка)

Указывает объект, содержащий тип ресурса и параметры резервного копирования. Единственный поддерживаемый тип ресурса — экземпляры Amazon EC2 с Windows Volume Shadow Copy Service (VSS). Пример CloudFormation см. в образце шаблона CloudFormation для включения Windows VSS в Руководстве пользователя Backup.

Допустимые значения: EC2.

BackupOptions -> (карта)

Указывает параметр резервного копирования для выбранного ресурса. Этот параметр доступен только для задач резервного копирования с Windows VSS.

Допустимые значения:

Установите "WindowsVSS":"enabled", чтобы включить параметр резервного копирования WindowsVSS и создать резервную копию Windows VSS.

Установите "WindowsVSS":"disabled", чтобы создать обычную резервную копию. Параметр WindowsVSS не включён по умолчанию.

Если вы укажете недопустимый параметр, вы получите исключение InvalidParameterValueException.

Дополнительную информацию о резервных копиях Windows VSS см. в статье Создание резервной копии Windows с поддержкой VSS.

key -> (строка)

value -> (строка)

BackupPlanId -> (строка)

Уникальный идентификатор плана резервного копирования.

BackupPlanArn -> (строка)

Идентификатор ресурса Amazon (ARN), уникально идентифицирующий план резервного копирования; например, arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50.

VersionId -> (строка)

Уникальные случайным образом сгенерированные строки Unicode UTF-8, длина которых не превышает 1024 байта. Идентификаторы версий нельзя редактировать.

CreatorRequestId -> (строка)

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

CreationDate -> (метка времени)

Дата и время создания плана резервного копирования в формате Unix и в координированном всемирном времени (UTC). Значение CreationDate точное до миллисекунд. Например, значение 1516925490.087 соответствует пятнице, 26 января 2018 года, 00:11:30.087.

DeletionDate -> (метка времени)

Дата и время удаления плана резервного копирования в формате Unix и в координированном всемирном времени (UTC). Значение DeletionDate точное до миллисекунд. Например, значение 1516925490.087 соответствует пятнице, 26 января 2018 года, 00:11:30.087.

LastExecutionDate -> (метка времени)

Последнее время выполнения этого плана резервного копирования. Дата и время в формате Unix и координированном всемирном времени (UTC). Значение LastExecutionDate точное до миллисекунд. Например, значение 1516925490.087 соответствует пятнице, 26 января 2018 года, 00:11:30.087.

AdvancedBackupSettings -> (список)

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

(структура)

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

ResourceType -> (строка)

Указывает объект, содержащий тип ресурса и параметры резервного копирования. Единственный поддерживаемый тип ресурса — экземпляры Amazon EC2 с Windows Volume Shadow Copy Service (VSS). Пример CloudFormation см. в образце шаблона CloudFormation для включения Windows VSS в Руководстве пользователя Backup.

Допустимые значения: EC2.

BackupOptions -> (карта)

Указывает параметр резервного копирования для выбранного ресурса. Этот параметр доступен только для задач резервного копирования с Windows VSS.

Допустимые значения:

Установите "WindowsVSS":"enabled", чтобы включить параметр резервного копирования WindowsVSS и создать резервную копию Windows VSS.

Установите "WindowsVSS":"disabled", чтобы создать обычную резервную копию. Параметр WindowsVSS не включён по умолчанию.

Если вы укажете недопустимый параметр, вы получите исключение InvalidParameterValueException.

Дополнительную информацию о резервных копиях Windows VSS см. в статье Создание резервной копии Windows с поддержкой VSS.

key -> (строка)

value -> (строка)

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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