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. # StartRestoreJob Récupère la ressource enregistrée identifiée par un Amazon Resource Name (ARN). ## Syntaxe de la demande ``` PUT /restore-jobs HTTP/1.1 Content-type: application/json { "CopySourceTagsToRestoredResource": boolean, "IamRoleArn": "string", "IdempotencyToken": "string", "Metadata": { "string" : "string" }, "RecoveryPointArn": "string", "ResourceType": "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. ** [CopySourceTagsToRestoredResource](#API_StartRestoreJob_RequestSyntax) ** Ce paramètre est facultatif. S'il est égal à `True`, les balises incluses dans la sauvegarde seront copiées sur la ressource restaurée. Cela ne peut être appliqué qu'aux sauvegardes créées via AWS Backup. Type : booléen Obligatoire : non ** [IamRoleArn](#API_StartRestoreJob_RequestSyntax) ** Le nom de ressource Amazon (ARN) du rôle IAM AWS Backup utilisé pour créer la ressource cible ; par exemple :`arn:aws:iam::123456789012:role/S3Access`. Type : chaîne Obligatoire : non ** [IdempotencyToken](#API_StartRestoreJob_RequestSyntax) ** Chaîne choisie par le client que vous pouvez utiliser pour faire la distinction entre des appels par ailleurs identiques à `StartRestoreJob`. Toute nouvelle tentative d'une demande réussie avec le même jeton d'idempotence entraîne un message de réussite sans qu'aucune action ne soit entreprise. Type : chaîne Obligatoire : non ** [Metadata](#API_StartRestoreJob_RequestSyntax) ** Un ensemble de paires clé-valeur de métadonnées. Vous pouvez obtenir les métadonnées de configuration relatives à une ressource au moment de sa sauvegarde en appelant `GetRecoveryPointRestoreMetadata`. Cependant, des valeurs autres que celles fournies par `GetRecoveryPointRestoreMetadata` peuvent être nécessaires pour restaurer une ressource. Par exemple, vous devrez peut-être fournir un nouveau nom de ressource si l'original existe déjà. Pour plus d'informations sur les métadonnées de chaque ressource, consultez les rubriques suivantes : + [Métadonnées pour Amazon Aurora](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-aur.html#aur-restore-cli) + [Métadonnées pour Amazon DocumentDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-docdb.html#docdb-restore-cli) + [Métadonnées pour AWS CloudFormation](https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-application-stacks.html#restoring-cfn-cli) + [Métadonnées pour Amazon DynamoDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-dynamodb.html#ddb-restore-cli) + [Métadonnées pour Amazon EBS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ebs.html#ebs-restore-cli) + [Métadonnées pour Amazon EC2](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ec2.html#restoring-ec2-cli) + [Métadonnées pour Amazon EFS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-efs.html#efs-restore-cli) + [Métadonnées pour Amazon EKS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-eks.html#eks-restore-backup-section) + [Métadonnées pour Amazon FSx](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-fsx.html#fsx-restore-cli) + [Métadonnées pour Amazon Neptune](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-nep.html#nep-restore-cli) + [Métadonnées pour Amazon RDS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-rds.html#rds-restore-cli) + [Métadonnées pour Amazon Redshift](https://docs.aws.amazon.com/aws-backup/latest/devguide/redshift-restores.html#redshift-restore-api) + [Métadonnées pour AWS Storage Gateway](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-storage-gateway.html#restoring-sgw-cli) + [Métadonnées pour Amazon S3](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-s3.html#s3-restore-cli) + [Métadonnées pour Amazon Timestream](https://docs.aws.amazon.com/aws-backup/latest/devguide/timestream-restore.html#timestream-restore-api) + [Métadonnées pour les machines virtuelles](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-vm.html#vm-restore-cli) Type : mappage chaîne/chaîne Obligatoire : oui ** [RecoveryPointArn](#API_StartRestoreJob_RequestSyntax) ** Un ARN qui identifie de façon unique un point de récupération ; par exemple, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`. Type : Chaîne Obligatoire : oui ** [ResourceType](#API_StartRestoreJob_RequestSyntax) ** Démarre une tâche visant à restaurer un point de récupération pour l'une des ressources suivantes : + `Aurora`- Amazon Aurora + `DocumentDB`- Amazon DocumentDB + `CloudFormation` - AWS CloudFormation + `DynamoDB`- Amazon DynamoDB + `EBS`- Boutique Amazon Elastic Block + `EC2`- Amazon Elastic Compute Cloud + `EFS`- Amazon Elastic File System + `EKS`- Amazon Elastic Kubernetes Service + `FSx`- Amazon FSx + `Neptune`- Amazon Neptune + `RDS`- Amazon Relational Database Service + `Redshift`- Amazon Redshift + `Storage Gateway` - AWS Storage Gateway + `S3`- Amazon Simple Storage Service + `Timestream`- Amazon Timestream + `VirtualMachine`- Machines virtuelles Type : Chaîne Modèle : `^[a-zA-Z0-9\-\_\.]{1,50}$` Obligatoire : non ## Syntaxe de la réponse ``` HTTP/1.1 200 Content-type: application/json { "RestoreJobId": "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. ** [RestoreJobId](#API_StartRestoreJob_ResponseSyntax) ** Identifie de manière unique la tâche qui restaure un point de récupération. Type : Chaîne ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md). ** 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 ** InvalidRequestException ** Indique une erreur dans la saisie de la demande. Par exemple, un paramètre n'est pas du bon type. ** Context ** ** Type ** Code d’état HTTP : 400 ** MissingParameterValueException ** Indique qu'un paramètre obligatoire est manquant. ** Context ** ** Type ** Code d’état HTTP : 400 ** ResourceNotFoundException ** Aucune ressource requise pour l'action n'existe. ** 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/StartRestoreJob) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartRestoreJob) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartRestoreJob) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartRestoreJob) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartRestoreJob) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartRestoreJob) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartRestoreJob) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartRestoreJob) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartRestoreJob) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartRestoreJob)