Ejemplos de AWS Backup que utilizan la AWS CLI - AWS Command Line Interface
Acciones

Ejemplos de AWS Backup que utilizan la AWS CLI

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 funciones de servicio individuales, 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.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar create-backup-plan.

AWS CLI

Creación de 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 periodo 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

Creación de 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-name sample-vault

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

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

Salida:

{
    "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: 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-state COMPLETED

Salida:

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