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.
ListRecoveryPointsByBackupVault
Gibt detaillierte Informationen zu den Wiederherstellungspunkten zurück, die in einem Backup-Tresor gespeichert sind.
Anforderungssyntax
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
URIAnforderungsparameter
Die Anfrage verwendet die folgenden URI Parameter.
- BackupVaultAccountId
-
Dieser Parameter sortiert die Liste der Wiederherstellungspunkte nach Konto-ID.
Pattern:
^[0-9]{12}$
- backupVaultName
-
Der Name eines logischen Containers, in dem die Sicherungen gespeichert werden. Backup-Tresore werden durch Namen identifiziert, die für das Konto, mit dem sie erstellt wurden, und die AWS -Region, in der sie erstellt wurden, eindeutig sind.
Anmerkung
Der Name des Backup-Tresors ist möglicherweise nicht verfügbar, wenn ein unterstützter Service das Backup erstellt.
Pattern:
^[a-zA-Z0-9\-\_]{2,50}$
Erforderlich: Ja
- ByBackupPlanId
-
Gibt nur Wiederherstellungspunkte zurück, die der angegebenen Backup-Plan-ID entsprechen.
- ByCreatedAfter
-
Gibt nur Wiederherstellungspunkte zurück, die nach dem angegebenen Zeitstempel erstellt wurden.
- ByCreatedBefore
-
Gibt nur Wiederherstellungspunkte zurück, die vor dem angegebenen Zeitstempel erstellt wurden.
- ByParentRecoveryPointArn
-
Dadurch werden nur Wiederherstellungspunkte zurückgegeben, die dem angegebenen übergeordneten (zusammengesetzten) Wiederherstellungspunkt Amazon Resource Name (ARN) entsprechen.
- ByResourceArn
-
Gibt nur Wiederherstellungspunkte zurück, die mit der angegebenen Ressource Amazon Resource Name (ARN) übereinstimmen.
- ByResourceType
-
Gibt nur Wiederherstellungspunkte zurück, die mit dem/den angegebenen Ressourcentyp(en) übereinstimmen:
-
Aurora
für Amazon Aurora -
CloudFormation
für AWS CloudFormation -
DocumentDB
für Amazon DocumentDB (mit MongoDB-Kompatibilität) -
DynamoDB
für Amazon DynamoDB -
EBS
für Amazon Elastic Block Store -
EC2
für Amazon Elastic Compute Cloud -
EFS
für Amazon Elastic File System -
FSx
für Amazon FSx -
Neptune
für Amazon Neptune -
RDS
für Amazon Relational Database Service -
Redshift
für Amazon Redshift -
S3
für Amazon Simple Storage Service (Amazon S3) -
SAP HANA on Amazon EC2
für SAP HANA Datenbanken auf Amazon Elastic Compute Cloud-Instances -
Storage Gateway
für AWS Storage Gateway -
Timestream
für Amazon Timestream -
VirtualMachine
für VMware virtuelle Maschinen
Pattern:
^[a-zA-Z0-9\-\_\.]{1,50}$
-
- MaxResults
-
Die maximale Anzahl der zurückzugebenden Elemente.
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 IhnenNextToken
, mehr Elemente in Ihrer Liste zurückzugeben, beginnend mit der Position, auf die das nächste Token verweist.
Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
Antwortsyntax
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"
}
]
}
Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Dienst eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Dienst 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 IhnenNextToken
, 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 enthalten, die in einem Backup-Tresor gespeichert sind.
Typ: Array von RecoveryPointByBackupVault-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.
HTTPStatuscode: 400
- MissingParameterValueException
-
Zeigt an, dass ein erforderlicher Parameter fehlt.
HTTPStatuscode: 400
- ResourceNotFoundException
-
Eine Ressource, die für die Aktion erforderlich ist, ist nicht vorhanden.
HTTPStatuscode: 400
- ServiceUnavailableException
-
Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen.
HTTPStatuscode: 500
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: