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. # CreateBackupPlan Erstellt einen Backup-Plan unter Verwendung eines Backup-Plannamens und der Backup-Regeln. Ein Backup-Plan ist ein Dokument, das Informationen enthält, AWS Backup anhand derer Aufgaben geplant werden, mit denen Wiederherstellungspunkte für Ressourcen erstellt werden. Wenn Sie `CreateBackupPlan` mit einem Plan aufrufen, der bereits existiert, erhalten Sie ein `AlreadyExistsException`-Beispiel. ## Anforderungssyntax ``` PUT /backup/plans/ HTTP/1.1 Content-type: application/json { "BackupPlan": { "AdvancedBackupSettings": [ { "BackupOptions": { "string" : "string" }, "ResourceType": "string" } ], "BackupPlanName": "string", "Rules": [ { "CompletionWindowMinutes": number, "CopyActions": [ { "DestinationBackupVaultArn": "string", "Lifecycle": { "DeleteAfterDays": number, "DeleteAfterEvent": "string", "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean } } ], "EnableContinuousBackup": boolean, "IndexActions": [ { "ResourceTypes": [ "string" ] } ], "Lifecycle": { "DeleteAfterDays": number, "DeleteAfterEvent": "string", "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean }, "RecoveryPointTags": { "string" : "string" }, "RuleName": "string", "ScanActions": [ { "MalwareScanner": "string", "ScanMode": "string" } ], "ScheduleExpression": "string", "ScheduleExpressionTimezone": "string", "StartWindowMinutes": number, "TargetBackupVaultName": "string", "TargetLogicallyAirGappedBackupVaultArn": "string" } ], "ScanSettings": [ { "MalwareScanner": "string", "ResourceTypes": [ "string" ], "ScannerRoleArn": "string" } ] }, "BackupPlanTags": { "string" : "string" }, "CreatorRequestId": "string" } ``` ## URI-Anfrageparameter Die Anforderung verwendet keine URI-Parameter. ## Anforderungstext Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [BackupPlan](#API_CreateBackupPlan_RequestSyntax) ** Der Hauptteil eines Backup-Plans. Beinhaltet einen `BackupPlanName` und einen oder mehrere Sätze von `Rules`. Typ: [BackupPlanInput](API_BackupPlanInput.md) Objekt Erforderlich: Ja ** [BackupPlanTags](#API_CreateBackupPlan_RequestSyntax) ** Die Tags, die dem Backup-Plan zugewiesen werden sollen. Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge Erforderlich: Nein ** [CreatorRequestId](#API_CreateBackupPlan_RequestSyntax) ** Identifiziert die Anforderung und ermöglicht die Wiederholung fehlgeschlagener Anforderungen, ohne dass das Risiko besteht, dass der Vorgang zweimal ausgeführt wird. Wenn die Anforderung eine `CreatorRequestId` enthält, der einem vorhandenen Backup-Plan entspricht, wird dieser Plan zurückgegeben. Dieser Parameter ist optional. Wenn dieser Parameter verwendet wird, muss er 1 bis 50 alphanumerische Zeichen oder „-\$1“ enthalten. Zeichen. Typ: Zeichenfolge Erforderlich: Nein ## Antwortsyntax ``` HTTP/1.1 200 Content-type: application/json { "AdvancedBackupSettings": [ { "BackupOptions": { "string" : "string" }, "ResourceType": "string" } ], "BackupPlanArn": "string", "BackupPlanId": "string", "CreationDate": 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](#API_CreateBackupPlan_ResponseSyntax) ** Die Einstellungen für einen Ressourcentyp. Diese Option ist nur für Windows-VSS-Backup-Aufträge (Volume Shadow Copy Service) verfügbar. Typ: Array von [AdvancedBackupSetting](API_AdvancedBackupSetting.md)-Objekten ** [BackupPlanArn](#API_CreateBackupPlan_ResponseSyntax) ** 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](#API_CreateBackupPlan_ResponseSyntax) ** Die ID des Backup-Plans. Typ: Zeichenfolge ** [CreationDate](#API_CreateBackupPlan_ResponseSyntax) ** 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 ** [VersionId](#API_CreateBackupPlan_ResponseSyntax) ** Eindeutige, zufällig generierte Unicode- und UTF-8-kodierte Zeichenfolgen, die maximal 1.024 Bytes lang sind. Sie 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 Fehlertypen](CommonErrors.md). ** AlreadyExistsException ** Die erforderliche Ressource ist bereits vorhanden. ** Arn ** ** Context ** ** CreatorRequestId ** ** Type ** HTTP-Statuscode: 400 ** 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 ** LimitExceededException ** Ein Limit in der Anforderung wurde überschritten, z. B. die maximale Anzahl von Elementen, die in einer Anforderung zulässig sind. ** Context ** ** Type ** HTTP-Statuscode: 400 ** MissingParameterValueException ** Zeigt an, dass ein erforderlicher Parameter fehlt. ** 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/CreateBackupPlan) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateBackupPlan) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateBackupPlan) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateBackupPlan) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateBackupPlan) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateBackupPlan) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateBackupPlan) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateBackupPlan) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateBackupPlan) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateBackupPlan)