list-recovery-points-by-backup-vault
Описание
Возвращает подробную информацию о точках восстановления, хранящихся в хранилище резервных копий.
См. также: Документацию API AWS
list-recovery-points-by-backup-vault является постраничной операцией. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничную обработку, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответ на постраничный запрос аргумент --query должен извлекать данные из результатов следующих выражений запроса: RecoveryPoints
Синтаксис
list-recovery-points-by-backup-vault
--backup-vault-name <value>
[--backup-vault-account-id <value>]
[--by-resource-arn <value>]
[--by-resource-type <value>]
[--by-backup-plan-id <value>]
[--by-created-before <value>]
[--by-created-after <value>]
[--by-parent-recovery-point-arn <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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, в котором они созданы.
Примечание
Имя хранилища резервных копий может отсутствовать, когда резервную копию создаёт поддерживаемая служба.--backup-vault-account-id (строка)
--by-resource-arn (строка)
--by-resource-type (строка)
Возвращает только точки восстановления, соответствующие указанному типу(ам) ресурса:
-
Auroraдля Amazon Aurora -
CloudFormationдля CloudFormation -
DocumentDBдля Amazon DocumentDB (с совместимостью MongoDB) -
DynamoDBдля Amazon DynamoDB -
EBSдля Amazon Elastic Block Store -
EC2для Amazon Elastic Compute Cloud -
EFSдля Amazon Elastic File System -
FSxдля Amazon FSx -
Neptuneдля Amazon Neptune -
RDSдля Amazon Relational Database Service -
Redshiftдля Amazon Redshift -
S3для Amazon Simple Storage Service (Amazon S3) -
SAP HANA on Amazon EC2для баз данных SAP HANA на экземплярах Amazon Elastic Compute Cloud -
Storage Gatewayдля Storage Gateway -
Timestreamдля Amazon Timestream -
VirtualMachineдля виртуальных машин VMware
--by-backup-plan-id (строка)
--by-created-before (метка времени)
--by-created-after (метка времени)
--by-parent-recovery-point-arn (строка)
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, указанному в --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные данные с помощью значения, предоставленного в JSON, так как строка будет взята буквально. Это может не быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Маркер для указания места начала постраничной обработки. Это NextToken из ранее урезанного ответа.
Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface .
--page-size (целое число)
Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.
Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface .
--max-items (целое число)
Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Чтобы возобновить постраничную обработку, предоставьте значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken непосредственно за пределами AWS CLI.
Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface .
--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.
Вывод
NextToken -> (строка)
MaxResults количества элементов, NextToken позволяет вернуть больше элементов в вашем списке, начиная с позиции, указанной следующим маркером.RecoveryPoints -> (список)
Массив объектов, содержащих подробную информацию о точках восстановления, сохранённых в хранилище резервных копий.
(структура)
Содержит подробную информацию о точках восстановления, хранящихся в хранилище резервных копий.
RecoveryPointArn -> (строка)
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45 .BackupVaultName -> (строка)
BackupVaultArn -> (строка)
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault .SourceBackupVaultArn -> (строка)
null .ResourceArn -> (строка)
ResourceType -> (строка)
CreatedBy -> (структура)
Содержит идентификационную информацию о создании точки восстановления, включая BackupPlanArn , BackupPlanId , BackupPlanVersion и BackupRuleId плана резервного копирования, используемого для её создания.
BackupPlanId -> (строка)
BackupPlanArn -> (строка)
arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50 .BackupPlanVersion -> (строка)
BackupRuleId -> (строка)
IamRoleArn -> (строка)
arn:aws:iam::123456789012:role/S3Access .Status -> (строка)
StatusMessage -> (строка)
CreationDate -> (временная метка)
CreationDate точно до миллисекунд. Например, значение 1516925490.087 соответствует пятнице, 26 января 2018 года, 00:11:30.087.CompletionDate -> (временная метка)
CompletionDate точно до миллисекунд. Например, значение 1516925490.087 соответствует пятнице, 26 января 2018 года, 00:11:30.087.BackupSizeInBytes -> (длинное целое число)
CalculatedLifecycle -> (структура)
Объект CalculatedLifecycle, содержащий временные метки DeleteAt и MoveToColdStorageAt.
MoveToColdStorageAt -> (временная метка)
DeleteAt -> (временная метка)
Lifecycle -> (структура)
Жизненный цикл определяет, когда защищённый ресурс переносится в холодное хранилище и когда он истекает. Переходы резервных копий и истечение срока действия резервных копий автоматически происходят в соответствии с определённым вами жизненным циклом.
Резервные копии, переведённые в холодное хранилище, должны храниться в нём не менее 90 дней. Поэтому значение «retention» должно быть на 90 дней больше значения «transition to cold after days». Значение «transition to cold after days» нельзя изменить после того, как резервная копия была переведена в холодное хранилище.
Типы ресурсов, которые могут быть переведены в холодное хранилище, перечислены в таблице Доступность функций по ресурсам. Для других типов ресурсов резервное копирование игнорирует это выражение.
MoveToColdStorageAfterDays -> (длинное целое число)
DeleteAfterDays -> (длинное целое число)
MoveToColdStorageAfterDays .OptInToArchiveForSupportedResources -> (булево)
EncryptionKeyArn -> (строка)
arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab .IsEncrypted -> (булево)
TRUE, если указанная точка восстановления зашифрована, или как FALSE, если точка восстановления не зашифрована.LastRestoreTime -> (временная метка)
LastRestoreTime точно до миллисекунд. Например, значение 1516925490.087 соответствует пятнице, 26 января 2018 года, 00:11:30.087.ParentRecoveryPointArn -> (строка)
CompositeMemberIdentifier -> (строка)
IsParent -> (булево)
ResourceName -> (строка)
VaultType -> (строка)
IndexStatus -> (строка)
Текущее состояние индекса резервной копии, связанного с указанной точкой восстановления.
Состояния: PENDING | ACTIVE | FAILED | DELETING
Точка восстановления с индексом, имеющим состояние ACTIVE, может быть включена в поиск.
IndexStatusMessage -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.