ListRecoveryPointsByResource - AWS Backup
Syntaxe de la demandeParamètres de demande URICorps 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.

ListRecoveryPointsByResource

Les informations sur les points de récupération du type spécifié par le nom de ressource Amazon (ARN) d'une ressource.

Note

Pour Amazon EFS et Amazon EC2, cette action répertorie uniquement les points de récupération créés par AWS Backup.

Syntaxe de la demande

GET /resources/resourceArn/recovery-points/?managedByAWSBackupOnly=ManagedByAWSBackupOnly&maxResults=MaxResults&nextToken=NextToken HTTP/1.1

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

ManagedByAWSBackupOnly

Cet attribut filtre les points de récupération en fonction de leur propriétaire.

Si ce paramètre est défini surTRUE, la réponse contiendra les points de récupération associés aux ressources sélectionnées gérées par AWS Backup.

Si ce paramètre est défini surFALSE, la réponse contiendra tous les points de récupération associés à la ressource sélectionnée.

Type : booléen

MaxResults

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

Note

Amazon RDS nécessite une valeur d'au moins 20.

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

Un ARN qui identifie de façon unique une ressource. Le format de l'ARN dépend du type de ressource.

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",
   "RecoveryPoints": [ 
      { 
         "BackupSizeBytes": number,
         "BackupVaultName": "string",
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "IsParent": boolean,
         "ParentRecoveryPointArn": "string",
         "RecoveryPointArn": "string",
         "ResourceName": "string",
         "Status": "string",
         "StatusMessage": "string",
         "VaultType": "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.

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 : chaîne

RecoveryPoints

Tableau d'objets contenant des informations détaillées sur les points de récupération du type de ressource spécifié.

Note

Seuls les points de récupération Amazon EFS et Amazon EC2 sont renvoyés. BackupVaultName

Type : tableau d’objets RecoveryPointByResource

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.

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 :