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 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 utilisercreate-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 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 Création d’un plan de sauvegarde dans le Guide du développeur AWS Backup.

  • Pour plus de détails sur l'API, reportez-vous CreateBackupPlanà la 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’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 Guide du développeur AWS Backup.

  • Pour plus de détails sur l'API, reportez-vous CreateBackupVaultà la 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’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 Guide du développeur AWS Backup.

L'exemple de code suivant montre comment utiliserget-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 Guide du développeur AWS Backup.

  • Pour plus de détails sur l'API, reportez-vous GetBackupPlanà la 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 Création d’une sauvegarde dans le Guide du développeur AWS Backup.

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 Création d’une sauvegarde dans le Guide du développeur AWS Backup.

  • Pour plus de détails sur l'API, reportez-vous ListBackupJobsà la section Référence des AWS CLI commandes.