

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.

# DescribeRestoreJob
<a name="API_DescribeRestoreJob"></a>

Renvoie les métadonnées associées à une tâche de restauration spécifiée par un ID de tâche.

## Syntaxe de la demande
<a name="API_DescribeRestoreJob_RequestSyntax"></a>

```
GET /restore-jobs/restoreJobId HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DescribeRestoreJob_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [restoreJobId](#API_DescribeRestoreJob_RequestSyntax) **   <a name="Backup-DescribeRestoreJob-request-uri-RestoreJobId"></a>
Identifie de manière unique la tâche qui restaure un point de récupération.  
Obligatoire : oui

## Corps de la demande
<a name="API_DescribeRestoreJob_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DescribeRestoreJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountId": "string",
   "BackupSizeInBytes": number,
   "BackupVaultArn": "string",
   "CompletionDate": number,
   "CreatedBy": { 
      "RestoreTestingPlanArn": "string"
   },
   "CreatedResourceArn": "string",
   "CreationDate": number,
   "DeletionStatus": "string",
   "DeletionStatusMessage": "string",
   "ExpectedCompletionTimeMinutes": number,
   "IamRoleArn": "string",
   "IsParent": boolean,
   "ParentJobId": "string",
   "PercentDone": "string",
   "RecoveryPointArn": "string",
   "RecoveryPointCreationDate": number,
   "ResourceType": "string",
   "RestoreJobId": "string",
   "SourceResourceArn": "string",
   "Status": "string",
   "StatusMessage": "string",
   "ValidationStatus": "string",
   "ValidationStatusMessage": "string"
}
```

## Eléments de réponse
<a name="API_DescribeRestoreJob_ResponseElements"></a>

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.

 ** [AccountId](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-AccountId"></a>
Renvoie l'ID de compte du propriétaire de la tâche de restauration.  
Type : Chaîne  
Modèle : `^[0-9]{12}$` 

 ** [BackupSizeInBytes](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-BackupSizeInBytes"></a>
Taille, en octets, de la ressource restaurée.  
Type : Long

 ** [BackupVaultArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-BackupVaultArn"></a>
Nom de ressource Amazon (ARN) du coffre de sauvegarde contenant le point de restauration. Cela permet d'identifier les politiques et les autorisations d'accès au coffre-fort.  
Type : Chaîne

 ** [CompletionDate](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-CompletionDate"></a>
Date et heure de fin d'une tâche de restauration d'un point de récupération, au format Unix et au format UTC (temps universel coordonné). La valeur de `CompletionDate` 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

 ** [CreatedBy](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-CreatedBy"></a>
Contient des informations d’identification relatives à la création d’une tâche de restauration.  
Type : objet [RestoreJobCreator](API_RestoreJobCreator.md)

 ** [CreatedResourceArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-CreatedResourceArn"></a>
Le nom de ressource Amazon (ARN) de la ressource créée par la tâche de restauration.  
Le format de l'ARN dépend du type de ressource sauvegardée.  
Type : Chaîne

 ** [CreationDate](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-CreationDate"></a>
Date et heure de création d'une tâche de restauration, 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

 ** [DeletionStatus](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-DeletionStatus"></a>
État des données générées par le test de restauration.  
Type : Chaîne  
Valeurs valides : `DELETING | FAILED | SUCCESSFUL` 

 ** [DeletionStatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-DeletionStatusMessage"></a>
Cela décrit le statut de suppression de la tâche de restauration.  
Type : Chaîne

 ** [ExpectedCompletionTimeMinutes](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ExpectedCompletionTimeMinutes"></a>
Durée en minutes prévue d'une tâche de restauration d'un point de récupération.  
Type : Long

 ** [IamRoleArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-IamRoleArn"></a>
Spécifie l'ARN du rôle IAM utilisé pour créer le point de récupération cible ; par exemple, `arn:aws:iam::123456789012:role/S3Access`.  
Type : Chaîne

 ** [IsParent](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-IsParent"></a>
Il s'agit d'une valeur booléenne indiquant si la tâche de restauration est une tâche de restauration parent (composite).  
Type : Boolean

 ** [ParentJobId](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ParentJobId"></a>
Il s'agit de l'identifiant unique de la tâche de restauration parent pour la tâche de restauration sélectionnée.  
Type : Chaîne

 ** [PercentDone](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-PercentDone"></a>
Contient une estimation du pourcentage d'achèvement d'une tâche au moment où le statut de la tâche a été demandé.  
Type : Chaîne

 ** [RecoveryPointArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-RecoveryPointArn"></a>
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

 ** [RecoveryPointCreationDate](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-RecoveryPointCreationDate"></a>
Date de création du point de restauration créé par la tâche de restauration spécifiée.  
Type : Timestamp

 ** [ResourceType](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ResourceType"></a>
Renvoie les métadonnées associées à une tâche de restauration répertoriées par type de ressource.  
Type : Chaîne  
Modèle : `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [RestoreJobId](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-RestoreJobId"></a>
Identifie de manière unique la tâche qui restaure un point de récupération.  
Type : Chaîne

 ** [SourceResourceArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-SourceResourceArn"></a>
Le nom de ressource Amazon (ARN) de la ressource d'origine qui a été sauvegardée. Cela fournit un contexte sur la ressource en cours de restauration.  
Type : Chaîne

 ** [Status](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-Status"></a>
Code d'état spécifiant l'état de la tâche initiée AWS Backup pour restaurer un point de restauration.  
Type : Chaîne  
Valeurs valides : `PENDING | RUNNING | COMPLETED | ABORTED | FAILED` 

 ** [StatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-StatusMessage"></a>
Message indiquant le statut d'une tâche de restauration d'un point de récupération.  
Type : Chaîne

 ** [ValidationStatus](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ValidationStatus"></a>
État de la validation exécutée sur la tâche de restauration indiquée.  
Type : Chaîne  
Valeurs valides : `FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING` 

 ** [ValidationStatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ValidationStatusMessage"></a>
Message d'état.  
Type : Chaîne

## Erreurs
<a name="API_DescribeRestoreJob_Errors"></a>

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).

 ** DependencyFailureException **   
Un AWS service ou une ressource dépendant a renvoyé une erreur au AWS Backup service et l'action ne peut pas être terminée.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 500

 ** 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

 ** 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
<a name="API_DescribeRestoreJob_SeeAlso"></a>

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/DescribeRestoreJob) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeRestoreJob) 