AWS Backup exemples utilisant AWS CLI - AWS Command Line Interface
Actions

Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWS Backup exemples utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with 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 montrent comment appeler des fonctions de service individuelles, vous pouvez les visualiser dans leur contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utilisercreate-backup-plan.

AWS CLI

Pour créer un plan de sauvegarde

L'create-backup-planexemple suivant crée le plan de sauvegarde spécifié avec une rétention 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 la section Création d'un plan de sauvegarde dans le AWS Backup Developer Guide.

  • Pour API plus de détails, voir CreateBackupPlanla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-backup-vault.

AWS CLI

Pour créer un coffre-fort de sauvegarde

L'create-backup-vaultexemple suivant crée un coffre-fort de sauvegarde portant le nom spécifié.

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

Cette commande ne produit aucun résultat. Sortie :

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

Pour plus d'informations, consultez la section Création d'un coffre-fort de sauvegarde dans le AWS Backup Developer Guide.

  • Pour API plus de détails, voir CreateBackupVaultla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-backup-plan-from-template.

AWS CLI

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

L'get-backup-plan-from-templateexemple suivant extrait 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 la section Création d'un plan de sauvegarde dans le AWS Backup Developer Guide.

L'exemple de code suivant montre comment utiliserget-backup-plan.

AWS CLI

Pour obtenir les détails d'un plan de sauvegarde

L'get-backup-planexemple suivant affiche les détails 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 la section Création d'un plan de sauvegarde dans le AWS Backup Developer Guide.

  • Pour API plus de détails, voir GetBackupPlanla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-backup-jobs.

AWS CLI

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

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

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 Creating a Backup dans le AWS Backup Developer Guide.

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

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

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 Creating a Backup dans le AWS Backup Developer Guide.

  • Pour API plus de détails, voir ListBackupJobsla section Référence des AWS CLI commandes.