Esta documentación es para la versión 1 de AWS CLI. Para obtener documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.
En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con AWS Backup.
Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
Temas
Acciones
En el siguiente ejemplo de código, se muestra cómo utilizar create-backup-plan.
- AWS CLI
-
Cómo crear un plan de copias de seguridad
En el siguiente ejemplo de
create-backup-plan, se crea el plan de copias de seguridad especificado con un período de retención de 35 días.aws backup create-backup-plan \ --backup-plan "{\"BackupPlanName\":\"Example-Backup-Plan\",\"Rules\":[{\"RuleName\":\"DailyBackups\",\"ScheduleExpression\":\"cron(0 5 ? * * *)\",\"StartWindowMinutes\":480,\"TargetBackupVaultName\":\"Default\",\"Lifecycle\":{\"DeleteAfterDays\":35}}]}"Salida:
{ "BackupPlanId": "1fa3895c-a7f5-484a-a371-2dd6a1a9f729", "BackupPlanArn": "arn:aws:backup:us-west-2:123456789012:backup-plan:1fa3895c-a7f5-484a-a371-2dd6a1a9f729", "CreationDate": 1568928754.747, "VersionId": "ZjQ2ZTI5YWQtZDg5Yi00MzYzLWJmZTAtMDI1MzhlMDhjYjEz" }Para obtener más información, consulte Creating a Backup Plan en la Guía para desarrolladores de AWS Backup.
-
Para obtener información sobre la API, consulte CreateBackupPlan
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar create-backup-vault.
- AWS CLI
-
Cómo crear un almacén de copias de seguridad
En el siguiente ejemplo de
create-backup-vault, se crea un almacén de copia de seguridad con el nombre especificado.aws backup create-backup-vault --backup-vault-namesample-vaultEste comando no genera ninguna salida. Salida:
{ "BackupVaultName": "sample-vault", "BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:sample-vault", "CreationDate": 1568928338.385 }Para obtener más información, consulte Creating a Backup Vault en la Guía para desarrolladores AWS Backup.
-
Para obtener información sobre la API, consulte CreateBackupVault
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar get-backup-plan-from-template.
- AWS CLI
-
Para obtener un plan de copias de seguridad existente a partir de una plantilla
En el siguiente ejemplo de
get-backup-plan-from-template, se obtiene un plan de copias de seguridad existente a partir de una plantilla que especifica una copia de seguridad diaria con un período de retención de 35 días.aws backup get-backup-plan-from-template \ --backup-plan-template-id"87c0c1ef-254d-4180-8fef-2e76a2c38aaa"Salida:
{ "BackupPlanDocument": { "Rules": [ { "RuleName": "DailyBackups", "ScheduleExpression": "cron(0 5 ? * * *)", "StartWindowMinutes": 480, "Lifecycle": { "DeleteAfterDays": 35 } } ] } }Para obtener más información, consulte Creating a Backup Plan en la Guía para desarrolladores de AWS Backup.
-
Para obtener información sobre la API, consulte GetBackupPlanFromTemplate
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar get-backup-plan.
- AWS CLI
-
Para obtener los detalles de un plan de copias de seguridad
En el siguiente ejemplo de
get-backup-plan, se muestran los detalles del plan de copias de seguridad especificado.aws backup get-backup-plan \ --backup-plan-id"fcbf5d8f-bd77-4f3a-9c97-f24fb3d373a5"Salida:
{ "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 }Para obtener más información, consulte Creating a Backup Plan en la Guía para desarrolladores de AWS Backup.
-
Para obtener información sobre la API, consulte GetBackupPlan
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar list-backup-jobs.
- AWS CLI
-
Ejemplo 1: cómo obtener una lista de todos los trabajos de copia de seguridad
En el siguiente de
list-backup-jobs, se muestran los metadatos sobre los trabajos de copia de seguridad de la cuenta de AWS.aws backup list-backup-jobsSalida:
{ "BackupJobs": [ { "BackupJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "BackupVaultName": "Default", "BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:Default", "ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-12345678901234567", "CreationDate": 1600721892.929, "State": "CREATED", "PercentDone": "0.0", "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/AWSBackupDefaultServiceRole", "StartBy": 1600725492.929, "ResourceType": "EC2" }, { "BackupJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "BackupVaultName": "Default", "BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:Default", "RecoveryPointArn": "arn:aws:backup:us-west-2:123456789012:recovery-point:a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "ResourceArn": "arn:aws:elasticfilesystem:us-west-2:123456789012:file-system/fs-12345678", "CreationDate": 1600721724.77, "CompletionDate": 1600721744.488, "State": "COMPLETED", "PercentDone": "100.0", "BackupSizeInBytes": 71, "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/AWSBackupDefaultServiceRole", "StartBy": 1600725324.77, "ResourceType": "EFS" } ] }Para obtener más información, consulte Creating a Backup en la Guía para desarrolladores de AWS Backup.
Ejemplo 2: cómo obtener una lista de los trabajos de copia de seguridad completados
En el siguiente de
list-backup-jobs, se muestran los metadatos sobre los trabajos de copia de seguridad completados de la cuenta de AWS.aws backup list-backup-jobs \ --by-stateCOMPLETEDSalida:
{ "BackupJobs": [ { "BackupJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "BackupVaultName": "Default", "BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:Default", "RecoveryPointArn": "arn:aws:backup:us-west-2:123456789012:recovery-point:a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "ResourceArn": "arn:aws:elasticfilesystem:us-west-2:123456789012:file-system/fs-12345678", "CreationDate": 1600721724.77, "CompletionDate": 1600721744.488, "State": "COMPLETED", "PercentDone": "100.0", "BackupSizeInBytes": 71, "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/AWSBackupDefaultServiceRole", "StartBy": 1600725324.77, "ResourceType": "EFS" } ] }Para obtener más información, consulte Creating a Backup en la Guía para desarrolladores de AWS Backup.
-
Para obtener información sobre la API, consulte ListBackupJobs
en la Referencia de comandos de la AWS CLI.
-
