ListRecoveryPointsByBackupVault - AWS Backup
AnforderungssyntaxURIAnforderungsparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere 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.

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

  • CloudFormationfü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

  • FSxfür Amazon FSx

  • Neptune für Amazon Neptune

  • RDS für Amazon Relational Database Service

  • Redshift fü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

  • Timestream fü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 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.

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 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 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: