ListRestoreJobsByProtectedResource - AWS Backup
Syntaxe de la requêteURIParamètres de demandeCorps de la demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

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.

ListRestoreJobsByProtectedResource

Cela renvoie les tâches de restauration contenant la ressource protégée spécifiée.

Vous devez inclure ResourceArn. Vous pouvez éventuellement inclure NextToken, ByStatus, MaxResults, ByRecoveryPointCreationDateAfter et ByRecoveryPointCreationDateBefore.

Syntaxe de la requête

GET /resources/resourceArn/restore-jobs/?maxResults=MaxResults&nextToken=NextToken&recoveryPointCreationDateAfter=ByRecoveryPointCreationDateAfter&recoveryPointCreationDateBefore=ByRecoveryPointCreationDateBefore&status=ByStatus HTTP/1.1

URIParamètres de demande

La demande utilise les URI paramètres suivants.

ByRecoveryPointCreationDateAfter

Renvoie uniquement les tâches de restauration des points de récupération créées après la date spécifiée.

ByRecoveryPointCreationDateBefore

Renvoie uniquement les tâches de restauration des points de récupération créées avant la date spécifiée.

ByStatus

Renvoie uniquement les tâches de restauration associées au statut de tâche spécifié.

Valeurs valides : PENDING | RUNNING | COMPLETED | ABORTED | FAILED

MaxResults

Le nombre maximum d'éléments à renvoyer.

Plage valide : valeur minimum de 1. La valeur maximale est 1 000.

NextToken

L'élément suivant selon une liste partielle des éléments renvoyés. Par exemple, si une demande est faite pour renvoyer MaxResults éléments, NextToken vous permet de renvoyer d’autres éléments dans votre liste en commençant par l’emplacement indiqué par le jeton suivant.

resourceArn

Renvoie uniquement les tâches de restauration qui correspondent à la ressource spécifiée Amazon Resource Name (ARN).

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

{
   "NextToken": "string",
   "RestoreJobs": [ 
      { 
         "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 sous JSON forme formatée par le service.

NextToken

L'élément suivant selon une liste partielle des éléments renvoyés. Par exemple, si une demande est faite pour renvoyer MaxResults éléments, NextToken vous permet de renvoyer d’autres éléments dans votre liste en commençant par l’emplacement indiqué par le jeton suivant.

Type : String

RestoreJobs

Tableau d’objets contenant des informations détaillées sur les tâches de restauration des ressources enregistrées.

Type : tableau d’objets RestoreJobsListMember

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

InvalidParameterValueException

Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée.

HTTPCode de statut : 400

MissingParameterValueException

Indique qu'un paramètre obligatoire est manquant.

HTTPCode de statut : 400

ResourceNotFoundException

Aucune ressource requise pour l'action n'existe.

HTTPCode de statut : 400

ServiceUnavailableException

La demande a échoué en raison d'une défaillance temporaire du serveur.

HTTPCode de statut : 500

consultez aussi

Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :