ListRecoveryPointsByBackupVault - AWS Backup
Sintassi della richiestaParametri della richiesta URICorpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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à.

ListRecoveryPointsByBackupVault

Restituisce informazioni dettagliate sui punti di ripristino archiviati in un vault di backup.

Sintassi della richiesta

GET /backup-vaults/backupVaultName/recovery-points/?backupPlanId=ByBackupPlanId&backupVaultAccountId=BackupVaultAccountId&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&maxResults=MaxResults&nextToken=NextToken&parentRecoveryPointArn=ByParentRecoveryPointArn&resourceArn=ByResourceArn&resourceType=ByResourceType HTTP/1.1

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

BackupVaultAccountId

Questo parametro ordina l'elenco dei punti di ripristino in base all'ID account.

Modello: ^[0-9]{12}$

backupVaultName

Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati. Consistono di minuscole, numeri e trattini.

Nota

È possibile che il nome del vault di backup non sia disponibile quando un servizio supportato crea il backup.

Modello: ^[a-zA-Z0-9\-\_]{2,50}$

Campo obbligatorio: sì

ByBackupPlanId

Restituisce solo i punti di ripristino che corrispondono all'ID del piano di backup specificato.

ByCreatedAfter

Restituisce solo i punti di ripristino creati dopo il timestamp specificato.

ByCreatedBefore

Restituisce solo i punti di ripristino creati prima del timestamp specificato.

ByParentRecoveryPointArn

Ciò restituisce solo i punti di ripristino che corrispondono al nome della risorsa Amazon (ARN) del punto di ripristino (composito) padre.

ByResourceArn

Restituisce solo i processi di ripristino che corrispondono al nome della risorsa Amazon (ARN) specificata.

ByResourceType

Restituisce solo i punti di ripristino che corrispondono ai tipi di risorsa specificati.

  • Aurora per Amazon Aurora

  • CloudFormationper AWS CloudFormation

  • DocumentDB per Amazon DocumentDB (compatibile con MongoDB)

  • DynamoDB per Amazon DynamoDB

  • EBS per Amazon Elastic Block Store

  • EC2 per Amazon Elastic Compute Cloud

  • EFS per Amazon Elastic File System

  • FSx per Amazon FSx

  • Neptune per Amazon Neptune

  • RDS per Amazon Relational Database Service

  • Redshift per Amazon Redshift

  • S3per Amazon Simple Storage Service (Amazon S3)

  • SAP HANA on Amazon EC2per database SAP HANA su istanze Amazon Elastic Compute Cloud

  • Storage Gatewayper AWS Storage Gateway

  • Timestream per Amazon Timestream

  • VirtualMachineper macchine virtuali VMware

Modello: ^[a-zA-Z0-9\-\_\.]{1,50}$

MaxResults

Il numero massimo di elementi da restituire.

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.

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": [ 
      { 
         "BackupSizeInBytes": number,
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "CalculatedLifecycle": { 
            "DeleteAt": number,
            "MoveToColdStorageAt": number
         },
         "CompletionDate": number,
         "CompositeMemberIdentifier": "string",
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanVersion": "string",
            "BackupRuleId": "string"
         },
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "IamRoleArn": "string",
         "IsEncrypted": boolean,
         "IsParent": boolean,
         "LastRestoreTime": number,
         "Lifecycle": { 
            "DeleteAfterDays": number,
            "MoveToColdStorageAfterDays": number,
            "OptInToArchiveForSupportedResources": boolean
         },
         "ParentRecoveryPointArn": "string",
         "RecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "SourceBackupVaultArn": "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 contenenti informazioni dettagliate sui punti di ripristino salvati in un vault di backup.

Tipo: matrice di oggetti RecoveryPointByBackupVault

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: