DescribeRecoveryPoint - AWS Backup
AnforderungssyntaxURIParameter anfordernAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere 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.

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

URIParameter anfordern

Die Anfrage verwendet die folgenden URI Parameter.

BackupVaultAccountId

Die Konto-ID des angegebenen Backup-Tresors.

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.

Pattern: ^[a-zA-Z0-9\-\_]{2,50}$

Erforderlich: Ja

recoveryPointArn

Ein Amazon-Ressourcenname (ARN), der einen Wiederherstellungspunkt eindeutig identifiziert, zum Beispielarn: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",
      "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",
   "StorageClass": "string",
   "VaultType": "string"
}

Antwortelemente

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

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

BackupSizeInBytes

Die Größe eines Backups in Byte

Type: Long

BackupVaultArn

EinARN, das einen Backup-Tresor eindeutig identifiziert; zum Beispielarn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault.

Typ: Zeichenfolge

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 -Region, in der sie erstellt wurden, eindeutig sind.

Typ: Zeichenfolge

Pattern: ^[a-zA-Z0-9\-\_]{2,50}$

CalculatedLifecycle

Ein CalculatedLifecycle-Objekt, das DeleteAt- und MoveToColdStorageAt-Zeitstempel enthält.

Typ: CalculatedLifecycle Objekt

CompletionDate

Datum und Uhrzeit der Fertigstellung eines Jobs zur Erstellung eines Wiederherstellungspunkts im Unix-Format und in koordinierter 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

Der Bezeichner einer Ressource innerhalb einer zusammengesetzten Gruppe, z. B. eines verschachtelten (untergeordneten) Wiederherstellungspunkts, der zu einem zusammengesetzten (übergeordneten) Stapel gehört. Die ID wird von der logischen ID innerhalb eines Stacks übertragen.

Typ: Zeichenfolge

CreatedBy

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 Objekt

CreationDate

Datum und Uhrzeit der Erstellung eines Wiederherstellungspunkts im Unix-Format und in koordinierter 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

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

IamRoleArn

Gibt die IAM Rolle an, die zum Erstellen des Ziel-Wiederherstellungspunkts ARN verwendet wurde; zum Beispielarn:aws:iam::123456789012:role/S3Access.

Typ: Zeichenfolge

IsEncrypted

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

IsParent

Dies gibt den booleschen Wert zurück, dass es sich bei einem Wiederherstellungspunkt um einen übergeordneten (zusammengesetzten) Auftrag handelt.

Typ: Boolesch

LastRestoreTime

Datum und Uhrzeit der letzten Wiederherstellung eines Wiederherstellungspunkts im Unix-Format und in koordinierter 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

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 geändert werden, sobald eine Sicherung in den Archivspeicher übertragen wurde.

Ressourcentypen, die auf Cold Storage umgestellt werden können, sind in der Tabelle Verfügbarkeit von Funktionen nach Ressourcen aufgeführt. AWS Backup ignoriert diesen Ausdruck für andere Ressourcentypen.

Typ: Lifecycle Objekt

ParentRecoveryPointArn

Dies ist einARN, das einen übergeordneten (zusammengesetzten) Wiederherstellungspunkt eindeutig identifiziert, arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45 z. B.

Typ: Zeichenfolge

RecoveryPointArn

EinARN, das einen Erholungspunkt eindeutig identifiziert, zum Beispielarn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.

Typ: Zeichenfolge

ResourceArn

EineARN, die eine gespeicherte Ressource eindeutig identifiziert. Das Format von ARN hängt vom Ressourcentyp ab.

Typ: Zeichenfolge

ResourceName

Der Name der Ressource, die zu der angegebenen Sicherung gehört.

Typ: Zeichenfolge

ResourceType

Der AWS Ressourcentyp, der als Erholungspunkt gespeichert werden soll, z. B. ein Amazon Elastic Block Store (AmazonEBS) -Volume oder eine Amazon Relational Database Service (AmazonRDS) -Datenbank.

Typ: Zeichenfolge

Pattern: ^[a-zA-Z0-9\-\_\.]{1,50}$

SourceBackupVaultArn

Ein Amazon-Ressourcenname (ARN), der den Quelltresor, in dem die Ressource ursprünglich gesichert wurde, eindeutig identifiziert; zum Beispielarn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault. Wenn die Wiederherstellung für dasselbe AWS Konto oder dieselbe Region wiederhergestellt wird, gilt dieser Wertnull.

Typ: Zeichenfolge

Status

Ein Statuscode, der den Status des Wiederherstellungspunkts angibt.

PARTIALDer Status gibt an, dass der Wiederherstellungspunkt nicht erstellt werden AWS Backup konnte, bevor das Backup-Fenster geschlossen wurde. Informationen zur Vergrößerung des Zeitfensters für Ihren Backup-Plan mithilfe von finden Sie unter UpdateBackupPlan. API Sie können das Fenster Ihres Backup-Plans auch mithilfe der Konsole vergrößern, indem Sie Ihren Backup-Plan auswählen und bearbeiten.

EXPIREDDer Status gibt an, dass der Wiederherstellungspunkt seine Aufbewahrungsfrist ü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 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 Bei Wiederherstellungspunkten von Amazon S3-RDS, Amazon- 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 STOPPED Status müssen nicht gelöscht werden.

Der EC2 STOPPED Status „Bei SAP HANA Amazon“ wird aufgrund einer Benutzeraktion, einer Fehlkonfiguration der Anwendung oder eines Backup-Fehlers angezeigt. Um sicherzustellen, dass future kontinuierliche Backups erfolgreich sind, überprüfen Sie den Status des Wiederherstellungspunkts und überprüfen Sie SAP HANA die Einzelheiten.

Typ: Zeichenfolge

Zulässige Werte: COMPLETED | PARTIAL | DELETING | EXPIRED

StatusMessage

Eine Statusmeldung, die den Status des Wiederherstellungspunkts erklärt.

Typ: Zeichenfolge

StorageClass

Gibt die Speicherklasse des Wiederherstellungspunkts zurück. Gültige Werte sind WARM oder COLD.

Typ: Zeichenfolge

Zulässige Werte: WARM | COLD | DELETED

VaultType

Der Typ des Tresors, in dem der beschriebene Wiederherstellungspunkt gespeichert ist.

Typ: Zeichenfolge

Zulässige Werte: BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT

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: