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. # DescribeRecoveryPoint Gibt Metadaten zurück, die einem Wiederherstellungspunkt zugeordnet sind, einschließlich ID, Status, Verschlüsselung und Lebenszyklus. ## Anforderungssyntax ``` GET /backup-vaults/backupVaultName/recovery-points/recoveryPointArn?backupVaultAccountId=BackupVaultAccountId HTTP/1.1 ``` ## URI-Anfrageparameter Die Anforderung verwendet die folgenden URI-Parameter. ** [BackupVaultAccountId](#API_DescribeRecoveryPoint_RequestSyntax) ** Die Konto-ID des angegebenen Backup-Tresors. Pattern: `^[0-9]{12}$` ** [backupVaultName](#API_DescribeRecoveryPoint_RequestSyntax) ** 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. Pattern: `^[a-zA-Z0-9\-\_]{2,50}$` Erforderlich: Ja ** [recoveryPointArn](#API_DescribeRecoveryPoint_RequestSyntax) ** Ein Amazon-Ressourcenname (ARN), der einen Wiederherstellungspunkt eindeutig identifiziert, z. B. `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`. Erforderlich: Ja ## Anforderungstext Der Anforderung besitzt keinen Anforderungstext. ## Antwortsyntax ``` HTTP/1.1 200 Content-type: application/json { "BackupSizeInBytes": number, "BackupVaultArn": "string", "BackupVaultName": "string", "CalculatedLifecycle": { "DeleteAt": number, "MoveToColdStorageAt": number }, "CompletionDate": number, "CompositeMemberIdentifier": "string", "CreatedBy": { "BackupPlanArn": "string", "BackupPlanId": "string", "BackupPlanName": "string", "BackupPlanVersion": "string", "BackupRuleCron": "string", "BackupRuleId": "string", "BackupRuleName": "string", "BackupRuleTimezone": "string" }, "CreationDate": number, "EncryptionKeyArn": "string", "EncryptionKeyType": "string", "IamRoleArn": "string", "IndexStatus": "string", "IndexStatusMessage": "string", "InitiationDate": number, "IsEncrypted": boolean, "IsParent": boolean, "LastRestoreTime": number, "Lifecycle": { "DeleteAfterDays": number, "DeleteAfterEvent": "string", "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean }, "ParentRecoveryPointArn": "string", "RecoveryPointArn": "string", "ResourceArn": "string", "ResourceName": "string", "ResourceType": "string", "ScanResults": [ { "Findings": [ "string" ], "LastScanTimestamp": number, "MalwareScanner": "string", "ScanJobState": "string" } ], "SourceBackupVaultArn": "string", "Status": "string", "StatusMessage": "string", "StorageClass": "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. ** [BackupSizeInBytes](#API_DescribeRecoveryPoint_ResponseSyntax) ** Die Größe eines Backups in Byte Type: Long ** [BackupVaultArn](#API_DescribeRecoveryPoint_ResponseSyntax) ** Ein ARN, der einen Backup-Tresor eindeutig identifiziert, z. B. `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`. Typ: Zeichenfolge ** [BackupVaultName](#API_DescribeRecoveryPoint_ResponseSyntax) ** 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 -Region, in der sie erstellt wurden, eindeutig sind. Typ: Zeichenfolge Pattern: `^[a-zA-Z0-9\-\_]{2,50}$` ** [CalculatedLifecycle](#API_DescribeRecoveryPoint_ResponseSyntax) ** Ein `CalculatedLifecycle`-Objekt, das `DeleteAt`- und `MoveToColdStorageAt`-Zeitstempel enthält. Typ: [CalculatedLifecycle](API_CalculatedLifecycle.md) Objekt ** [CompletionDate](#API_DescribeRecoveryPoint_ResponseSyntax) ** Das Datum und die Uhrzeit, zu der ein Auftrag zum Erstellen eines Wiederherstellungspunkts abgeschlossen wird, im Unix-Format und in der koordinierten Weltzeit (UTC). Der Wert von `CompletionDate` ist auf Millisekunden genau. Der Wert 1516925490.087 steht beispielsweise für Freitag, 26. Januar 2018, 12:11:30.087 Uhr. Typ: Zeitstempel ** [CompositeMemberIdentifier](#API_DescribeRecoveryPoint_ResponseSyntax) ** Die ID einer Ressource innerhalb einer Verbundgruppe, z. B. eines verschachtelten (untergeordneten) Wiederherstellungspunkts, der zu einem zusammengesetzten (übergeordneten) Stack gehört. Die ID wird von der [logischen ID](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-syntax) innerhalb eines Stacks übertragen. Typ: Zeichenfolge ** [CreatedBy](#API_DescribeRecoveryPoint_ResponseSyntax) ** Enthält identifizierende Informationen über die Erstellung eines Wiederherstellungspunkts, einschließlich `BackupPlanArn`, `BackupPlanId`, `BackupPlanVersion` und `BackupRuleId` des Backup-Plans, mit dem er erstellt wurde. Typ: [RecoveryPointCreator](API_RecoveryPointCreator.md) Objekt ** [CreationDate](#API_DescribeRecoveryPoint_ResponseSyntax) ** Das Datum und die Uhrzeit der Erstellung eines Wiederherstellungspunkts im Unix-Zeitformat und in der koordinierten Weltzeit (UTC). Der Wert von `CreationDate` ist auf Millisekunden genau. Der Wert 1516925490.087 steht beispielsweise für Freitag, 26. Januar 2018, 12:11:30.087 Uhr. Typ: Zeitstempel ** [EncryptionKeyArn](#API_DescribeRecoveryPoint_ResponseSyntax) ** Die serverseitige Verschlüsselung zum Schutz Ihrer Backups, z. B. `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`. Typ: Zeichenfolge ** [EncryptionKeyType](#API_DescribeRecoveryPoint_ResponseSyntax) ** Der Typ des Verschlüsselungsschlüssels, der für den Erholungspunkt verwendet wird. Gültige Werte sind CUSTOMER\$1MANAGED\$1KMS\$1KEY für vom Kunden verwaltete Schlüssel oder \$1OWNED\$1KMS\$1KEY für Schlüssel, die dem Kunden gehören. AWS AWS Typ: Zeichenfolge Zulässige Werte: `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY` ** [IamRoleArn](#API_DescribeRecoveryPoint_ResponseSyntax) ** Gibt den ARN der IAM-Rolle an, der zum Erstellen des Ziel-Wiederherstellungspunkts verwendet wurde; zum Beispiel `arn:aws:iam::123456789012:role/S3Access`. Typ: Zeichenfolge ** [IndexStatus](#API_DescribeRecoveryPoint_ResponseSyntax) ** Dies ist der aktuelle Status für den Backup-Index, der dem angegebenen Wiederherstellungspunkt zugeordnet ist. Die Status sind: `PENDING` \$1 \$1 `ACTIVE` \$1 `FAILED` `DELETING` Ein Wiederherstellungspunkt mit einem Index, der den Status von hat, `ACTIVE` kann in eine Suche aufgenommen werden. Typ: Zeichenfolge Zulässige Werte: `PENDING | ACTIVE | FAILED | DELETING` ** [IndexStatusMessage](#API_DescribeRecoveryPoint_ResponseSyntax) ** Eine Zeichenfolge in Form einer ausführlichen Meldung, die den Status eines Backup-Indexes erklärt, der dem Erholungspunkt zugeordnet ist. Typ: Zeichenfolge ** [InitiationDate](#API_DescribeRecoveryPoint_ResponseSyntax) ** Datum und Uhrzeit der Initiierung des Sicherungsauftrags, mit dem dieser Wiederherstellungspunkt erstellt wurde, im Unix-Format und in koordinierter Weltzeit (UTC). Typ: Zeitstempel ** [IsEncrypted](#API_DescribeRecoveryPoint_ResponseSyntax) ** Ein boolescher Wert, der als `TRUE` zurückgegeben wird, wenn der angegebene Wiederherstellungspunkt verschlüsselt ist, oder als `FALSE`, wenn der Wiederherstellungspunkt nicht verschlüsselt ist. Typ: Boolescher Wert ** [IsParent](#API_DescribeRecoveryPoint_ResponseSyntax) ** Dies gibt den booleschen Wert zurück, dass es sich bei einem Wiederherstellungspunkt um einen übergeordneten (zusammengesetzten) Auftrag handelt. Typ: Boolescher Wert ** [LastRestoreTime](#API_DescribeRecoveryPoint_ResponseSyntax) ** Das Datum und die Uhrzeit der letzten Wiederherstellung eines Wiederherstellungspunkts im Unix-Zeitformat und in der koordinierten Weltzeit (UTC). Der Wert von `LastRestoreTime` ist auf Millisekunden genau. Der Wert 1516925490.087 steht beispielsweise für Freitag, 26. Januar 2018, 12:11:30.087 Uhr. Typ: Zeitstempel ** [Lifecycle](#API_DescribeRecoveryPoint_ResponseSyntax) ** Der Lebenszyklus definiert, wann eine geschützte Ressource in einen Cold Storage übertragen wird und wann sie abläuft. AWS Backup überträgt Backups automatisch entsprechend dem von Ihnen definierten Lebenszyklus und lässt sie ablaufen. In den Archivspeicher übertragene Sicherungen müssen mindestens 90 Tage lang im Archivspeicher gespeichert werden. Daher muss die Einstellung für „Ablauf nach Tagen“ 90 Tage größer als die Einstellung für „Übertragung in Archivspeicher nach Tagen“ sein. Die Einstellung „Übertragung in Archivspeicher nach Tagen“ kann nicht mehr geändert werden, nachdem ein Backup in den Archivspeicher übertragen wurde. Ressourcentypen, die auf Cold Storage umgestellt werden können, sind in der Tabelle [Verfügbarkeit von Funktionen nach Ressourcen](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource) aufgeführt. AWS Backup ignoriert diesen Ausdruck für andere Ressourcentypen. Typ: [Lifecycle](API_Lifecycle.md) Objekt ** [ParentRecoveryPointArn](#API_DescribeRecoveryPoint_ResponseSyntax) ** Dies ist ein ARN, der einen übergeordneten (zusammengesetzten) Wiederherstellungspunkt eindeutig identifiziert, z. B. `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`. Typ: Zeichenfolge ** [RecoveryPointArn](#API_DescribeRecoveryPoint_ResponseSyntax) ** Ein ARN, der einen Wiederherstellungspunkt eindeutig identifiziert, z. B. `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`. Typ: Zeichenfolge ** [ResourceArn](#API_DescribeRecoveryPoint_ResponseSyntax) ** Ein ARN bezeichnet eindeutig eine gespeicherte Ressource. Das Format eines ARN hängt vom Ressourcentyp ab. Typ: Zeichenfolge ** [ResourceName](#API_DescribeRecoveryPoint_ResponseSyntax) ** Der Name der Ressource, die zu der angegebenen Sicherung gehört. Typ: Zeichenfolge ** [ResourceType](#API_DescribeRecoveryPoint_ResponseSyntax) ** Der AWS Ressourcentyp, der als Erholungspunkt gespeichert werden soll, z. B. ein Amazon Elastic Block Store (Amazon EBS) -Volume oder eine Amazon Relational Database Service (Amazon RDS) -Datenbank. Typ: Zeichenfolge Pattern: `^[a-zA-Z0-9\-\_\.]{1,50}$` ** [ScanResults](#API_DescribeRecoveryPoint_ResponseSyntax) ** Enthält die neuesten Scanergebnisse anhand des Wiederherstellungspunkts und umfasst derzeit`MalwareScanner`,`ScanJobState`, `Findings` und `LastScanTimestamp` Typ: Array von [ScanResult](API_ScanResult.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 5 Elemente. ** [SourceBackupVaultArn](#API_DescribeRecoveryPoint_ResponseSyntax) ** Ein Amazon-Ressourcenname (ARN), der den Quelltresor, in dem die Ressource ursprünglich gesichert wurde, eindeutig identifiziert, z. B. `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`. Wenn die Wiederherstellung für dasselbe AWS Konto oder dieselbe Region wiederhergestellt wird, gilt dieser Wert`null`. Typ: Zeichenfolge ** [Status](#API_DescribeRecoveryPoint_ResponseSyntax) ** Ein Statuscode, der den Status des Wiederherstellungspunkts angibt. Weitere Informationen finden Sie unter [Status des Wiederherstellungspunkts](https://docs.aws.amazon.com/aws-backup/latest/devguide/applicationstackbackups.html#cfnrecoverypointstatus) im * AWS Backup Entwicklerhandbuch*. + `CREATING`Der Status gibt an, dass ein AWS Backup Job für eine Ressource initiiert wurde. Der Backup-Vorgang wurde gestartet und verarbeitet aktiv einen Backup-Job für den zugehörigen Recovery Point. + `AVAILABLE`Der Status gibt an, dass das Backup für den Wiederherstellungspunkt erfolgreich erstellt wurde. Der Backup-Vorgang wurde ohne Probleme abgeschlossen und der Recovery Point ist jetzt einsatzbereit. + `PARTIAL`Der Status gibt an, dass ein Verbundwiederherstellungspunkt über einen oder mehrere verschachtelte Wiederherstellungspunkte verfügt, die nicht im Backup enthalten waren. + `EXPIRED`Der Status gibt an, dass der Wiederherstellungspunkt seinen Aufbewahrungszeitraum überschritten hat, aber nicht AWS Backup berechtigt ist oder er aus anderen Gründen nicht gelöscht werden kann. Informationen zum manuellen Löschen dieser Wiederherstellungspunkte finden Sie unter [Schritt 3: Löschen der Wiederherstellungspunkte](https://docs.aws.amazon.com/aws-backup/latest/devguide/gs-cleanup-resources.html#cleanup-backups) im Abschnitt *Ressourcen bereinigen* unter *Erste Schritte*. + Der Status `STOPPED` tritt bei einem kontinuierlichen Backup auf, bei dem ein Benutzer durch eine Aktion das kontinuierliche Backup deaktiviert hat. Dies kann durch das Entfernen von Berechtigungen, das Deaktivieren der Versionsverwaltung, das Deaktivieren von Ereignissen, an die gesendet werden EventBridge, oder das Deaktivieren der EventBridge Regeln, die von eingerichtet wurden, verursacht werden. AWS Backup Für Wiederherstellungspunkte von Amazon S3-, Amazon RDS- und Amazon Aurora Aurora-Ressourcen tritt dieser Status auf, wenn die Aufbewahrungsdauer einer Regel für kontinuierliche Backups geändert wird. Um den Status `STOPPED` zu lösen, stellen Sie sicher, dass alle angeforderten Berechtigungen vorhanden sind und dass die Versionierung für den S3-Bucket aktiviert ist. Sobald diese Bedingungen erfüllt sind, führt die nächste Ausführung einer Backup-Regel dazu, dass ein neuer kontinuierlicher Wiederherstellungspunkt erstellt wird. Die Wiederherstellungspunkte mit dem Status „ANGEHALTEN“ müssen nicht gelöscht werden. Bei SAP HANA auf Amazon tritt der EC2 `STOPPED` Status aufgrund einer Benutzeraktion, einer Fehlkonfiguration der Anwendung oder eines Backup-Fehlers auf. Um sicherzustellen, dass zukünftige kontinuierliche Backups erfolgreich sind, beziehen Sie sich auf den Status des Wiederherstellungspunkts und überprüfen Sie SAP HANA auf Einzelheiten. Typ: Zeichenfolge Zulässige Werte: `COMPLETED | PARTIAL | DELETING | EXPIRED | AVAILABLE | STOPPED | CREATING` ** [StatusMessage](#API_DescribeRecoveryPoint_ResponseSyntax) ** Eine Statusmeldung, die den Status des Wiederherstellungspunkts erklärt. Typ: Zeichenfolge ** [StorageClass](#API_DescribeRecoveryPoint_ResponseSyntax) ** Gibt die Speicherklasse des Wiederherstellungspunkts zurück. Gültige Werte sind `WARM` oder `COLD`. Typ: Zeichenfolge Zulässige Werte: `WARM | COLD | DELETED` ** [VaultType](#API_DescribeRecoveryPoint_ResponseSyntax) ** Der Typ des Tresors, in dem der beschriebene Wiederherstellungspunkt gespeichert ist. Typ: Zeichenfolge Zulässige Werte: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT` ## Fehler Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md). ** InvalidParameterValueException ** Zeigt an, dass etwas mit dem Wert eines Parameters nicht stimmt. Beispielsweise liegt der Wert außerhalb des zulässigen Bereichs. ** Context ** ** Type ** HTTP-Statuscode: 400 ** MissingParameterValueException ** Zeigt an, dass ein erforderlicher Parameter fehlt. ** Context ** ** Type ** HTTP-Statuscode: 400 ** ResourceNotFoundException ** Eine Ressource, die für die Aktion erforderlich ist, ist nicht vorhanden. ** Context ** ** Type ** HTTP-Statuscode: 400 ** ServiceUnavailableException ** Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen. ** Context ** ** Type ** HTTP Status Code: 500 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeRecoveryPoint)