ListRecoveryPointsByResource - AWS Backup

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

ListRecoveryPointsByResource

Le informazioni sui punti di ripristino del tipo specificato da una risorsa Amazon Resource Name (ARN).

Nota

Per Amazon EFS e Amazon EC2, questa azione elenca solo i punti di ripristino creati da AWS Backup.

Sintassi della richiesta

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

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

ManagedByAWSBackupOnly

Questo attributo filtra i punti di ripristino in base alla proprietà.

Se è impostato suTRUE, la risposta conterrà i punti di ripristino associati alle risorse selezionate gestite da AWS Backup.

Se è impostato suFALSE, la risposta conterrà tutti i punti di ripristino associati alla risorsa selezionata.

Tipo: Booleano

MaxResults

Il numero massimo di elementi da restituire.

Nota

Amazon RDS richiede un valore pari almeno 20.

Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

NextToken

L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero MaxResults di elementi, NextToken consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.

resourceArn

Un ARN che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.

Campo obbligatorio: sì

Corpo della richiesta

La richiesta non ha un corpo della richiesta.

Sintassi della risposta

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" } ] }

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

NextToken

L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero MaxResults di elementi, NextToken consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.

▬Tipo: stringa

RecoveryPoints

Un array di oggetti contenente informazioni dettagliate sui punti di ripristino del tipo di risorsa specificato.

Nota

Restituiscono solo i punti di ripristino Amazon EFS e Amazon EC2. BackupVaultName

Tipo: matrice di oggetti RecoveryPointByResource

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

InvalidParameterValueException

Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.

Codice di stato HTTP: 400

MissingParameterValueException

Indica che manca un parametro obbligatorio.

Codice di stato HTTP: 400

ResourceNotFoundException

Una risorsa necessaria per l'azione non esiste.

Codice di stato HTTP: 400

ServiceUnavailableException

La richiesta non è riuscita a causa di un errore temporaneo del server.

Codice di stato HTTP: 500

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: