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. # CreateBackupPlan Crée un plan de sauvegarde à l'aide d'un nom de plan de sauvegarde et de règles de sauvegarde. Un plan de sauvegarde est un document qui contient des informations permettant de AWS Backup planifier des tâches qui créent des points de récupération pour les ressources. Si vous appelez `CreateBackupPlan` avec un plan qui existe déjà, vous recevez une exception `AlreadyExistsException`. ## Syntaxe de la demande ``` PUT /backup/plans/ HTTP/1.1 Content-type: application/json { "BackupPlan": { "AdvancedBackupSettings": [ { "BackupOptions": { "string" : "string" }, "ResourceType": "string" } ], "BackupPlanName": "string", "Rules": [ { "CompletionWindowMinutes": number, "CopyActions": [ { "DestinationBackupVaultArn": "string", "Lifecycle": { "DeleteAfterDays": number, "DeleteAfterEvent": "string", "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean } } ], "EnableContinuousBackup": boolean, "IndexActions": [ { "ResourceTypes": [ "string" ] } ], "Lifecycle": { "DeleteAfterDays": number, "DeleteAfterEvent": "string", "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean }, "RecoveryPointTags": { "string" : "string" }, "RuleName": "string", "ScanActions": [ { "MalwareScanner": "string", "ScanMode": "string" } ], "ScheduleExpression": "string", "ScheduleExpressionTimezone": "string", "StartWindowMinutes": number, "TargetBackupVaultName": "string", "TargetLogicallyAirGappedBackupVaultArn": "string" } ], "ScanSettings": [ { "MalwareScanner": "string", "ResourceTypes": [ "string" ], "ScannerRoleArn": "string" } ] }, "BackupPlanTags": { "string" : "string" }, "CreatorRequestId": "string" } ``` ## Paramètres de demande URI La demande n’utilise pas de paramètres URI. ## Corps de la demande Cette demande accepte les données suivantes au format JSON. ** [BackupPlan](#API_CreateBackupPlan_RequestSyntax) ** Le corps d'un plan de secours. Comprend un `BackupPlanName` et un ou plusieurs ensembles de `Rules`. Type : objet [BackupPlanInput](API_BackupPlanInput.md) Obligatoire : oui ** [BackupPlanTags](#API_CreateBackupPlan_RequestSyntax) ** Les balises à attribuer au plan de sauvegarde. Type : mappage chaîne/chaîne Obligatoire : non ** [CreatorRequestId](#API_CreateBackupPlan_RequestSyntax) ** Identifie la demande et permet de réessayer les demandes ayant échoué sans risque d'exécuter l'opération deux fois. Si la demande inclut un `CreatorRequestId` qui correspond à un plan de sauvegarde existant, ce plan est renvoyé. Ce paramètre est facultatif. S'il est utilisé, ce paramètre doit contenir de 1 à 50 caractères alphanumériques ou « -\$1. » caractères. Type : chaîne Obligatoire : non ## Syntaxe de la réponse ``` HTTP/1.1 200 Content-type: application/json { "AdvancedBackupSettings": [ { "BackupOptions": { "string" : "string" }, "ResourceType": "string" } ], "BackupPlanArn": "string", "BackupPlanId": "string", "CreationDate": number, "VersionId": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [AdvancedBackupSettings](#API_CreateBackupPlan_ResponseSyntax) ** Les paramètres d'un type de ressource. Cette option est uniquement disponible pour les tâches de sauvegarde Windows Volume Shadow Copy Service (VSS). Type : tableau d’objets [AdvancedBackupSetting](API_AdvancedBackupSetting.md) ** [BackupPlanArn](#API_CreateBackupPlan_ResponseSyntax) ** Amazon Resource Name (ARN) qui identifie de façon unique un plan de secours ; par exemple, `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`. Type : Chaîne ** [BackupPlanId](#API_CreateBackupPlan_ResponseSyntax) ** ID du plan de sauvegarde. Type : Chaîne ** [CreationDate](#API_CreateBackupPlan_ResponseSyntax) ** Date et heure de création d'un plan de sauvegarde, au format Unix et au format UTC (temps universel coordonné). La valeur de `CreationDate` est précise en millisecondes. Par exemple, la valeur 1516925490,087 représente le vendredi 26 janvier 2018 à 00 h 11 m 30,087 s. Type : Timestamp ** [VersionId](#API_CreateBackupPlan_ResponseSyntax) ** Chaînes codées en Unicode, UTF-8 et générées de façon aléatoire qui contiennent au maximum 1 024 octets. Ils ne peuvent pas être modifiés. Type : Chaîne ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md). ** AlreadyExistsException ** La ressource demandée existe déjà. ** Arn ** ** Context ** ** CreatorRequestId ** ** Type ** Code d’état HTTP : 400 ** InvalidParameterValueException ** Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée. ** Context ** ** Type ** Code d’état HTTP : 400 ** LimitExceededException ** Une limite de la demande a été dépassée ; par exemple, le nombre maximum d'éléments autorisés dans une demande. ** Context ** ** Type ** Code d’état HTTP : 400 ** MissingParameterValueException ** Indique qu'un paramètre obligatoire est manquant. ** Context ** ** Type ** Code d’état HTTP : 400 ** ServiceUnavailableException ** La demande a échoué en raison d'une défaillance temporaire du serveur. ** Context ** ** Type ** Code d’état HTTP : 500 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateBackupPlan) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateBackupPlan) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateBackupPlan) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateBackupPlan) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateBackupPlan) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateBackupPlan) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateBackupPlan) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateBackupPlan) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateBackupPlan) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateBackupPlan)