Exemples d’utilisation de l’AWS CLI avec AWS Backup - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec AWS Backup

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec AWS Backup.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser create-backup-plan.

AWS CLI

Pour créer un plan de sauvegarde

L’exemple create-backup-plan suivant crée le plan de sauvegarde spécifié avec une durée de conservation de 35 jours.

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

Sortie :

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

Pour plus d’informations, consultez Création d’un plan de sauvegarde dans le Manuel du développeur AWS Backup.

  • Pour plus de détails sur l’API, consultez CreateBackupPlan dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-backup-vault.

AWS CLI

Pour créer un coffre-fort de sauvegarde

L’exemple create-backup-vault suivant crée un coffre-fort de sauvegarde avec le nom spécifié.

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

Cette commande ne produit aucune sortie. Sortie :

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

Pour plus d’informations, consultez Création d’un coffre-fort de sauvegarde dans le Manuel du développeur AWS Backup.

  • Pour plus de détails sur l’API, consultez CreateBackupVault dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-backup-plan-from-template.

AWS CLI

Pour obtenir un plan de sauvegarde existant à partir d’un modèle

L’exemple get-backup-plan-from-template suivant obtient un plan de sauvegarde existant à partir d’un modèle qui spécifie une sauvegarde quotidienne avec une durée de conservation de 35 jours.

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

Sortie :

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

Pour plus d’informations, consultez Création d’un plan de sauvegarde dans le Manuel du développeur AWS Backup.

L’exemple de code suivant montre comment utiliser get-backup-plan.

AWS CLI

Pour obtenir les informations d’un plan de sauvegarde

L’exemple get-backup-plan suivant affiche les informations du plan de sauvegarde spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Création d’un plan de sauvegarde dans le Manuel du développeur AWS Backup.

  • Pour plus de détails sur l’API, consultez GetBackupPlan dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-backup-jobs.

AWS CLI

Exemple 1 : pour répertorier toutes les tâches de sauvegarde

L’exemple list-backup-jobs suivant renvoie des métadonnées relatives à vos tâches de sauvegarde dans votre compte AWS.

aws backup list-backup-jobs

Sortie :

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

Pour plus d’informations, consultez Création d’une sauvegarde dans le Manuel du développeur AWS Backup.

Exemple 2 : pour répertorier les tâches de sauvegarde terminées

L’exemple list-backup-jobs suivant renvoie des métadonnées relatives à vos tâches de sauvegarde terminées dans votre compte AWS.

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

Sortie :

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

Pour plus d’informations, consultez Création d’une sauvegarde dans le Manuel du développeur AWS Backup.

  • Pour plus de détails sur l’API, consultez ListBackupJobs dans la Référence des commandes de l’AWS CLI.