Je souhaite utiliser l'interface de la ligne de commande AWS (AWS CLI) pour créer un plan de sauvegarde dans AWS Backup. Ou bien, je souhaite utiliser l'AWS CLI pour exécuter une tâche à la demande dans AWS Backup.
Résolution
Remarque : si des erreurs surviennent lorsque vous exécutez des commandes de l'interface de la ligne de commande AWS (AWS CLI), consultez la section Résoudre des erreurs liées à l’AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l'AWS CLI.
Créer un plan AWS Backup
Remarque : l'exemple de plan de sauvegarde suivant est donné avec une configuration de tâche de copie dans la règle de sauvegarde. Vous créez un coffre-fort de sauvegarde principal qui héberge les points de reprise dans la région AWS source. Vous créez ensuite un coffre-fort secondaire dans la région de destination. Le coffre-fort secondaire stocke les points de reprise créés par AWS Backup dans le cadre de la configuration de copie du plan de sauvegarde.
-
Pour créer un coffre principal dans la région source, exécutez la commande create-backup-vault :
aws backup create-backup-vault --backup-vault-name primary --region eu-west-1
Remarque : remplacez eu-west-1 par la région source.
-
Pour créer un coffre-fort secondaire dans la région de destination, exécutez à nouveau la commande create-backup-vault :
aws backup create-backup-vault --backup-vault-name secondary --region eu-west-2
Remarque : remplacez eu-west-2 par la région de destination.
-
Configurez un fichier JSON avec les options de votre plan de sauvegarde.
Exemple de fichier JSON :
{ "BackupPlanName": "testplan",
"Rules": [{
"RuleName": "HalfDayBackups",
"TargetBackupVaultName": "primary",
"ScheduleExpression": "cron(0 5/12 ? * * *)",
"StartWindowMinutes": 480,
"CompletionWindowMinutes": 10080,
"Lifecycle": {
"DeleteAfterDays": 30
},
"CopyActions": [{
"DestinationBackupVaultArn": "arn:aws:backup:eu-west-2:123456789:backup-vault:secondary",
"Lifecycle": {
"DeleteAfterDays": 30
}
}]
}]
}
Remarque : pour ScheduleExpression, définissez la valeur en fonction de l'objectif de point de reprise de votre organisation. Le paramètre Cycle de vie est facultatif. Vous pouvez spécifier une valeur basée sur la période de conservation de votre stratégie de sauvegarde.
-
Exécutez la commande create-backup-plan et incluez le fichier JSON du plan de sauvegarde :
aws backup create-backup-plan --backup-plan file://
-
Dans la sortie de la commande précédente, notez la valeur que vous avez reçue pour BackupPlanId.
-
Créez un fichier JSON qui définit les paramètres permettant d'affecter des ressources au plan de sauvegarde.
Exemple de fichier JSON :
{ "SelectionName": "Myselection",
"IamRoleArn": "arn:aws:iam::123456789:role/service-role/AWSBackupDefaultServiceRole",
"Resources": ["arn:aws:ec2:eu-west-1:123456789:volume/vol-0abcdef1234"],
"ListOfTags": [{
"ConditionType": "STRINGEQUALS",
"ConditionKey": "backup",
"ConditionValue": "yes"
}]
}
Remarque : pour spécifier les ressources d'un plan de sauvegarde, vous pouvez utiliser des Amazon Resource Names (ARN), des identifications ou les deux.
-
Exécutez la commande create-backup-selection et incluez le fichier JSON de sélection de sauvegarde :
aws backup create-backup-selection --backup-plan-id abcd-efgh-ijkl-mnop --backup-selection file://
Remarque : remplacez backup-plan-id par l'ID du plan de sauvegarde.
Exécuter une tâche à la demande dans AWS Backup
Pour démarrer une tâche de sauvegarde à la demande, exécutez la commande start-backup-job.
L'exemple suivant exécute une tâche de sauvegarde pour la ressource vol-0abcdef1234 :
aws backup start-backup-job --backup-vault-name primary --resource-arn arn:aws:ec2:eu-west-1:123456789:volume/vol-0abcdef1234 --iam-role-arn arn:aws:iam::123456789:role/service-role/AWSBackupDefaultServiceRole --idempotency-token 623f13d2-78d2-11ea-bc55-0242ac130003 --start-window-minutes 60 --complete-window-minutes 10080 --lifecycle DeleteAfterDays=30 --region eu-west-1
Remarque : la commande précédente inclut une valeur pour IdempotencyToken afin de faire la distinction entre les appels StartBackupJob. Pour générer un identifiant unique sur un système d'exploitation Linux, exécutez la commande uuid :
uuid -r
Pour démarrer une tâche de copie à la demande, exécutez la commande start-copy-job.
L'exemple suivant illustre l’exécution d’une tâche qui copie le point de reprise pour snap-0abcdaf2247b33dbc depuis le coffre source nommé principal vers un coffre de destination nommé secondaire :
aws backup start-copy-job --recovery-point-arn arn:aws:ec2:eu-west-1::snapshot/snap-0abcdaf2247b33dbc --source-backup-vault-name primary --destination-backup-vault-arn arn:aws:backup:eu-west-2:123456789:backup-vault:secondary --iam-role-arn arn:aws:iam::123456789:role/service-role/AWSBackupDefaultServiceRole --idempotency-token 5aac8974-78d2-11ea-bc55-0242ac130003 --lifecycle DeleteAfterDays=30 --region eu-west-1
Pour démarrer une tâche de restauration, exécutez la commande start-restore-job :
L'exemple suivant illustre l’exécution d’une tâche de restauration qui utilise un fichier de métadonnées JSON :
aws backup start-restore-job --region us-east-1 --recovery-point-arn "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347" --iam-role-arn "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole" --metadata file://path_to_json_file