describe-recovery-point

Описание

Возвращает метаданные, связанные с точкой восстановления, включая идентификатор, состояние, шифрование и жизненный цикл.

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

Синтаксис

  describe-recovery-point
--backup-vault-name <value>
--recovery-point-arn <value>
[--backup-vault-account-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-vault-name (строка)

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

--recovery-point-arn (строка)

Идентификатор Amazon Resource Name (ARN), уникально определяющий точку восстановления; например, arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45 .

--backup-vault-account-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
таблица
yaml
yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

включить
выключить
автоматически

--no-sign-request (логическое значение)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего двоичный блок fileb://, всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

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

Отключить вывод страницы CLI.

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

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

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

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

Вывод

RecoveryPointArn -> (строка)

Идентификатор ARN, уникально определяющий точку восстановления; например, arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45 .

BackupVaultName -> (строка)

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

BackupVaultArn -> (строка)

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

SourceBackupVaultArn -> (строка)

Идентификатор Amazon Resource Name (ARN) исходного хранилища, где ресурс был первоначально резервирован; например, arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault . Если восстановление выполняется в той же учетной записи Amazon Web Services или регионе, это значение будет null .

ResourceArn -> (строка)

Идентификатор ARN, уникально определяющий сохраненный ресурс. Формат ARN зависит от типа ресурса.

ResourceType -> (строка)

Тип ресурса Amazon Web Services, который необходимо сохранить как точку восстановления; например, том Amazon Elastic Block Store (Amazon EBS) или база данных Amazon Relational Database Service (Amazon RDS).

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

Содержит идентификационную информацию о создании точки восстановления, включая BackupPlanArn , BackupPlanId , BackupPlanVersion и BackupRuleId используемого плана резервного копирования для её создания.

BackupPlanId -> (строка)

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

BackupPlanArn -> (строка)

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

BackupPlanVersion -> (строка)

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

BackupRuleId -> (строка)

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

IamRoleArn -> (строка)

Указывает ARN роли IAM, используемой для создания целевой точки восстановления; например, arn:aws:iam::123456789012:role/S3Access .

Status -> (строка)

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

PARTIAL статус указывает, что Backup не смог создать точку восстановления до закрытия окна резервного копирования. Чтобы увеличить окно вашего плана резервного копирования с помощью API, см. UpdateBackupPlan . Вы также можете увеличить окно плана резервного копирования с помощью консоли, выбрав и отредактировав свой план резервного копирования.

EXPIRED статус указывает, что точка восстановления превысила срок хранения, но Backup не имеет разрешений или по другим причинам не может её удалить. Чтобы вручную удалить эти точки восстановления, см. Шаг 3: Удаление точек восстановления в разделе «Очистка ресурсов» в разделе «Начало работы».

STOPPED статус возникает при непрерывном резервном копировании, когда пользователь выполнил какое-либо действие, вызвавшее отключение непрерывного резервного копирования. Это может быть вызвано удалением разрешений, отключением версиирования, отключением отправки событий в EventBridge или отключением правил EventBridge, которые были реализованы Backup. Для точек восстановления ресурсов Amazon S3, Amazon RDS и Amazon Aurora этот статус возникает при изменении срока хранения правила непрерывного резервного копирования.

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

Для SAP HANA на Amazon EC2 STOPPED статус возникает из-за действий пользователя, неправильной конфигурации приложения или сбоя резервного копирования. Чтобы гарантировать успешное выполнение будущих непрерывных резервных копий, обратитесь к статусу точки восстановления и проверьте SAP HANA для получения дополнительных сведений.

StatusMessage -> (строка)

Сообщение со статусом, объясняющее статус точки восстановления.

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

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

CompletionDate -> (временная метка)

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

BackupSizeInBytes -> (длинное целое число)

Размер резервной копии в байтах.

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

Объект CalculatedLifecycle , содержащий DeleteAt и MoveToColdStorageAt временные метки.

MoveToColdStorageAt -> (временная метка)

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

DeleteAt -> (временная метка)

Временная метка, указывающая время удаления точки восстановления.

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

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

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

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

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

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

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

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

OptInToArchiveForSupportedResources -> (булево)

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

EncryptionKeyArn -> (строка)

Ключ шифрования серверной стороны, используемый для защиты ваших резервных копий; например, arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab .

IsEncrypted -> (булево)

Булево значение, возвращаемое как TRUE , если указанная точка восстановления зашифрована, или как FALSE , если точка восстановления не зашифрована.

StorageClass -> (строка)

Указывает класс хранения точки восстановления. Допустимые значения — WARM или COLD .

LastRestoreTime -> (временная метка)

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

ParentRecoveryPointArn -> (строка)

Это ARN, уникально определяющий родительскую (составную) точку восстановления; например, arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45 .

CompositeMemberIdentifier -> (строка)

Идентификатор ресурса в составной группе, например, вложенной (дочерней) точки восстановления, принадлежащей составной (родительской) сборке. Идентификатор передается из логического идентификатора в пределах сборки.

IsParent -> (булево)

Возвращает булево значение, что точка восстановления является родительской (составной) задачей.

ResourceName -> (строка)

Имя ресурса, принадлежащего указанной резервной копии.

VaultType -> (строка)

Тип хранилища, в котором хранится описанная точка восстановления.

IndexStatus -> (строка)

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

Статусы: PENDING | ACTIVE | FAILED | DELETING

Точка восстановления с индексом со статусом ACTIVE может быть включена в поиск.

IndexStatusMessage -> (строка)

Строка с подробным сообщением, объясняющим состояние индекса резервной копии, связанного с точкой восстановления.