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
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
GET /restore-jobs/restoreJobId
HTTP/1.1
Paramètres de demande URI
La demande utilise les paramètres URI suivants.
- restoreJobId
-
Identifie de manière unique la tâche qui restaure un point de récupération.
Obligatoire : oui
Corps de la demande
La demande n’a pas de corps de requête.
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"AccountId": "string",
"BackupSizeInBytes": number,
"CompletionDate": number,
"CreatedBy": {
"RestoreTestingPlanArn": "string"
},
"CreatedResourceArn": "string",
"CreationDate": number,
"DeletionStatus": "string",
"DeletionStatusMessage": "string",
"ExpectedCompletionTimeMinutes": number,
"IamRoleArn": "string",
"PercentDone": "string",
"RecoveryPointArn": "string",
"RecoveryPointCreationDate": number,
"ResourceType": "string",
"RestoreJobId": "string",
"Status": "string",
"StatusMessage": "string",
"ValidationStatus": "string",
"ValidationStatusMessage": "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.
- AccountId
-
Renvoie l'ID de compte du propriétaire de la tâche de restauration.
Type : chaîne
Modèle :
^[0-9]{12}$
- BackupSizeInBytes
-
Taille, en octets, de la ressource restaurée.
Type : long
- CompletionDate
-
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
-
Contient des informations d’identification relatives à la création d’une tâche de restauration.
Type : objet RestoreJobCreator
- CreatedResourceArn
-
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
-
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
-
État des données générées par le test de restauration.
Type : chaîne
Valeurs valides :
DELETING | FAILED | SUCCESSFUL
- DeletionStatusMessage
-
Cela décrit le statut de suppression de la tâche de restauration.
Type : chaîne
- ExpectedCompletionTimeMinutes
-
Durée en minutes prévue d'une tâche de restauration d'un point de récupération.
Type : long
- IamRoleArn
-
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
- PercentDone
-
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
-
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
-
Date de création du point de restauration créé par la tâche de restauration spécifiée.
Type : Timestamp
- ResourceType
-
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
-
Identifie de manière unique la tâche qui restaure un point de récupération.
Type : chaîne
- Status
-
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
-
Message indiquant le statut d'une tâche de restauration d'un point de récupération.
Type : chaîne
- ValidationStatus
-
É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
-
Message d'état.
Type : chaîne
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- 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.
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.
Code d’état HTTP : 400
- MissingParameterValueException
-
Indique qu'un paramètre obligatoire est manquant.
Code d’état HTTP : 400
- ResourceNotFoundException
-
Aucune ressource requise pour l'action n'existe.
Code d’état HTTP : 400
- ServiceUnavailableException
-
La demande a échoué en raison d'une défaillance temporaire du serveur.
Code d’état HTTP : 500
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :