Esempi di AWS Backup con la AWS CLI - AWS Command Line Interface
Operazioni

Esempi di AWS Backup con la AWS CLI

Gli esempi di codice seguenti mostrano come eseguire azioni e implementare scenari comuni utilizzando la AWS Command Line Interface con AWS Backup.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

L’esempio di codice seguente mostra come utilizzare create-backup-plan.

AWS CLI

Per creare un piano di backup

Nell’esempio seguente create-backup-plan crea il piano di backup specificato con una conservazione di 35 giorni.

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}}]}"

Output:

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

Per ulteriori informazioni, consulta Creazione di un piano di backup nella Guida per sviluppatori di AWS.

  • Per informazioni dettagliate sull’API, consulta CreateBackupPlan in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-backup-vault.

AWS CLI

Per creare un vault di backup

Nell’esempio seguente create-backup-vault crea un vault di backup con il nome specificato.

aws backup create-backup-vault
    --backup-vault-name sample-vault

Questo comando non produce alcun output. Output:

{
    "BackupVaultName": "sample-vault",
    "BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:sample-vault",
    "CreationDate": 1568928338.385
}

Per ulteriori informazioni, consulta Creazione di un vault di backup nella Guida per sviluppatori di AWS.

  • Per informazioni dettagliate sull’API, consulta CreateBackupVault in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-backup-plan-from-template.

AWS CLI

Come ottenere un piano di backup esistente da un modello

Nell’esempio seguente get-backup-plan-from-template ottiene un piano di backup esistente da un modello che specifica un backup giornaliero con una conservazione di 35 giorni.

aws backup get-backup-plan-from-template \
    --backup-plan-template-id "87c0c1ef-254d-4180-8fef-2e76a2c38aaa"

Output:

{
    "BackupPlanDocument": {
        "Rules": [
            {
                "RuleName": "DailyBackups",
                "ScheduleExpression": "cron(0 5 ? * * *)",
                "StartWindowMinutes": 480,
                "Lifecycle": {
                    "DeleteAfterDays": 35
                }
            }
        ]
    }
}

Per ulteriori informazioni, consulta Creazione di un piano di backup nella Guida per sviluppatori di AWS.

L’esempio di codice seguente mostra come utilizzare get-backup-plan.

AWS CLI

Come ottenere i dettagli di un piano di backup

Nell’esempio seguente get-backup-plan mostra i dettagli della policy specificata.

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

Output:

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

Per ulteriori informazioni, consulta Creazione di un piano di backup nella Guida per sviluppatori di AWS.

  • Per informazioni dettagliate sull’API, consulta GetBackupPlan in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-backup-jobs.

AWS CLI

Esempio 1: elencare tutti i processi di backup

Nell’esempio seguente list-backup-jobs restituisce i metadati relativi ai processi di backup nel tuo account AWS.

aws backup list-backup-jobs

Output:

{
    "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"
        }
    ]
}

Per ulteriori informazioni, consulta Creazione di un backup nella Guida per sviluppatori di AWS.

Esempio 2: elencare i processi di backup completati

Nell’esempio seguente list-backup-jobs restituisce i metadati relativi ai processi di backup completati nel tuo account AWS.

aws backup list-backup-jobs \
    --by-state COMPLETED

Output:

{
    "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"
        }
    ]
}

Per ulteriori informazioni, consulta Creazione di un backup nella Guida per sviluppatori di AWS.

  • Per informazioni dettagliate sull’API, consulta ListBackupJobs in AWS CLI Command Reference.