ListRecoveryPointsByResource - AWS Backup
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

ListRecoveryPointsByResource

Die Informationen über die Wiederherstellungspunkte des Typs, der durch den Amazon Resource Name (ARN) einer Ressource angegeben wird.

Anmerkung

Für Amazon EFS und Amazon EC2 listet diese Aktion nur Wiederherstellungspunkte auf, die von AWS Backup erstellt wurden.

Anforderungssyntax

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

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

ManagedByAWSBackupOnly

Dieses Attribut filtert Wiederherstellungspunkte auf der Grundlage des Besitzes.

Wenn dies auf gesetzt istTRUE, enthält die Antwort Wiederherstellungspunkte, die den ausgewählten Ressourcen zugeordnet sind und von verwaltet werden AWS Backup.

Wenn dieser Wert auf gesetzt istFALSE, enthält die Antwort alle Wiederherstellungspunkte, die der ausgewählten Ressource zugeordnet sind.

Typ: Boolesch

MaxResults

Die maximale Anzahl der zurückzugebenden Elemente.

Anmerkung

Amazon RDS erfordert einen Wert von mindestens 20.

Gültiger Bereich: Mindestwert 1. Maximaler Wert von 1 000.

NextToken

Das nächste Element folgt auf eine unvollständige Liste der zurückgegebenen Elemente. Wenn beispielsweise eine Anforderung zur Rückgabe der MaxResults Anzahl von Elementen gestellt wird, ermöglicht Ihnen NextToken, mehr Elemente in Ihrer Liste zurückzugeben, beginnend mit der Position, auf die das nächste Token verweist.

resourceArn

Ein ARN bezeichnet eindeutig eine Ressource. Das Format eines ARN hängt vom Ressourcentyp ab.

Erforderlich: Ja

Anforderungstext

Der Anforderung besitzt keinen Anforderungstext.

Antwortsyntax

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

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

NextToken

Das nächste Element folgt auf eine unvollständige Liste der zurückgegebenen Elemente. Wenn beispielsweise eine Anforderung zur Rückgabe der MaxResults Anzahl von Elementen gestellt wird, ermöglicht Ihnen NextToken, mehr Elemente in Ihrer Liste zurückzugeben, beginnend mit der Position, auf die das nächste Token verweist.

Typ: Zeichenfolge

RecoveryPoints

Eine Reihe von Objekten, die detaillierte Informationen zu Wiederherstellungspunkten des angegebenen Ressourcentyps enthalten.

Anmerkung

Nur Amazon EFS- und Amazon EC2 EC2-Wiederherstellungspunkte kehren zurück BackupVaultName.

Typ: Array von RecoveryPointByResource-Objekten

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

InvalidParameterValueException

Zeigt an, dass etwas mit dem Wert eines Parameters nicht stimmt. Beispielsweise liegt der Wert außerhalb des zulässigen Bereichs.

HTTP Status Code: 400

MissingParameterValueException

Zeigt an, dass ein erforderlicher Parameter fehlt.

HTTP Status Code: 400

ResourceNotFoundException

Eine Ressource, die für die Aktion erforderlich ist, ist nicht vorhanden.

HTTP Status Code: 400

ServiceUnavailableException

Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen.

HTTP Status Code: 500

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: