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
URIParameter anfordern
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:
-
Aurorafür Amazon Aurora -
CloudFormationfür AWS CloudFormation -
DocumentDBfür Amazon DocumentDB (mit MongoDB-Kompatibilität) -
DynamoDBfür Amazon DynamoDB -
EBSfür Amazon Elastic Block Store -
EC2für Amazon Elastic Compute Cloud -
EFSfür Amazon Elastic File System -
FSxfür Amazon FSx -
Neptunefür Amazon Neptune -
RDSfür Amazon Relational Database Service -
Redshiftfür Amazon Redshift -
S3für Amazon Simple Storage Service (Amazon S3) -
SAP HANA on Amazon EC2für SAP HANA Datenbanken auf Amazon Elastic Compute Cloud-Instances -
Storage Gatewayfür AWS Storage Gateway -
Timestreamfür Amazon Timestream -
VirtualMachinefü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
MaxResultsAnzahl 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
MaxResultsAnzahl 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:
