GetBackupPlan - AWS Backup
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere 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.

GetBackupPlan

Gibt BackupPlan-Details für die angegebene BackupPlanId zurück. Bei den Details handelt es sich zusätzlich zu den Plan-Metadaten um den Text eines Backup-Plans im JSON-Format.

Anforderungssyntax

GET /backup/plans/backupPlanId/?versionId=VersionId HTTP/1.1

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

backupPlanId

Identifiziert einen Backup-Plan.

Erforderlich: Ja

VersionId

Eindeutige, zufällig generierte Unicode- und UTF-8-kodierte Zeichenfolgen, die maximal 1.024 Bytes lang sind. Version-IDs können nicht bearbeitet werden.

Anforderungstext

Der Anforderung besitzt keinen Anforderungstext.

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "AdvancedBackupSettings": [ 
      { 
         "BackupOptions": { 
            "string" : "string" 
         },
         "ResourceType": "string"
      }
   ],
   "BackupPlan": { 
      "AdvancedBackupSettings": [ 
         { 
            "BackupOptions": { 
               "string" : "string" 
            },
            "ResourceType": "string"
         }
      ],
      "BackupPlanName": "string",
      "Rules": [ 
         { 
            "CompletionWindowMinutes": number,
            "CopyActions": [ 
               { 
                  "DestinationBackupVaultArn": "string",
                  "Lifecycle": { 
                     "DeleteAfterDays": number,
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "Lifecycle": { 
               "DeleteAfterDays": number,
               "MoveToColdStorageAfterDays": number,
               "OptInToArchiveForSupportedResources": boolean
            },
            "RecoveryPointTags": { 
               "string" : "string" 
            },
            "RuleId": "string",
            "RuleName": "string",
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "string"
         }
      ]
   },
   "BackupPlanArn": "string",
   "BackupPlanId": "string",
   "CreationDate": number,
   "CreatorRequestId": "string",
   "DeletionDate": number,
   "LastExecutionDate": number,
   "VersionId": "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.

AdvancedBackupSettings

Enthält eine Liste von BackupOptions für jeden Ressourcentyp. Die Liste wird nur aufgefüllt, wenn die erweiterte Option für den Backup-Plan festgelegt ist.

Typ: Array von AdvancedBackupSetting-Objekten

BackupPlan

Gibt den Text eines Backup-Plans an. Beinhaltet einen BackupPlanName und einen oder mehrere Sätze von Rules.

Typ: BackupPlan Objekt

BackupPlanArn

Ein Amazon-Ressourcenname (ARN), der einen Backup-Plan eindeutig identifiziert, z. B. arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50.

Typ: Zeichenfolge

BackupPlanId

Identifiziert einen Backup-Plan.

Typ: Zeichenfolge

CreationDate

Das Datum und die Uhrzeit der Erstellung der Domainliste 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

CreatorRequestId

Eine eindeutige Zeichenfolge, die die Anfrage angibt und die Wiederholung fehlgeschlagener Anforderungen ermöglicht, ohne dass das Risiko besteht, dass die Operation zweimal ausgeführt wird.

Typ: Zeichenfolge

DeletionDate

Das Datum und die Uhrzeit der Löschung eines Backup-Plans im Unix-Zeitformat und in der koordinierten Weltzeit (UTC). Der Wert von DeletionDate ist auf Millisekunden genau. Der Wert 1516925490.087 steht beispielsweise für Freitag, 26. Januar 2018, 12:11:30.087 Uhr.

Typ: Zeitstempel

LastExecutionDate

Das letzte Mal, als dieser Backup-Plan ausgeführt wurde. Datum und Uhrzeit im Unix-Format sowie in UTC (Universal Coordinated Time). Der Wert von LastExecutionDate ist auf Millisekunden genau. Der Wert 1516925490.087 steht beispielsweise für Freitag, 26. Januar 2018, 12:11:30.087 Uhr.

Typ: Zeitstempel

VersionId

Eindeutige, zufällig generierte Unicode- und UTF-8-kodierte Zeichenfolgen, die maximal 1.024 Bytes lang sind. Version-IDs können nicht bearbeitet werden.

Typ: Zeichenfolge

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.

HTTP Status Code: 400

MissingParameterValueException

Zeigt an, dass ein erforderlicher Parameter fehlt.

HTTP Status Code: 400

ResourceNotFoundException

Eine Ressource, die für die Aktion erforderlich ist, ist nicht vorhanden.

HTTP Status Code: 400

ServiceUnavailableException

Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen.

HTTP Status Code: 500

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: