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. # StartRestoreJob Stellt die gespeicherte Ressource wieder her, die durch einen Amazon-Ressourcennamen (ARN) identifiziert wurde. ## Anforderungssyntax ``` PUT /restore-jobs HTTP/1.1 Content-type: application/json { "CopySourceTagsToRestoredResource": boolean, "IamRoleArn": "string", "IdempotencyToken": "string", "Metadata": { "string" : "string" }, "RecoveryPointArn": "string", "ResourceType": "string" } ``` ## URI-Anfrageparameter Die Anforderung verwendet keine URI-Parameter. ## Anforderungstext Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [CopySourceTagsToRestoredResource](#API_StartRestoreJob_RequestSyntax) ** Dieser Parameter ist optional. Entspricht dies `True`, werden die im Backup enthaltenen Tags in die wiederhergestellte Ressource kopiert. Dies kann nur auf Backups angewendet werden, die durch erstellt wurden AWS Backup. Typ: Boolesch Erforderlich: Nein ** [IamRoleArn](#API_StartRestoreJob_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) der IAM-Rolle, mit der AWS Backup die Zielressource erstellt wird; zum Beispiel:`arn:aws:iam::123456789012:role/S3Access`. Typ: Zeichenfolge Erforderlich: Nein ** [IdempotencyToken](#API_StartRestoreJob_RequestSyntax) ** Eine vom Kunden gewählte Zeichenfolge, mit der Sie zwischen ansonsten identischen Aufrufen an `StartRestoreJob` unterscheiden können. Der erneute Versuch einer erfolgreichen Anforderung mit demselben Idempotenz-Token führt zu einer Erfolgsmeldung, ohne dass Maßnahmen ergriffen werden. Typ: Zeichenfolge Erforderlich: Nein ** [Metadata](#API_StartRestoreJob_RequestSyntax) ** Eine Satz von Metadaten-Schlüssel-Wert-Paaren. Sie können Konfigurationsmetadaten zu einer Ressource zum Zeitpunkt des Backups abrufen, indem Sie `GetRecoveryPointRestoreMetadata` aufrufen. Für die Wiederherstellung einer Ressource sind jedoch möglicherweise zusätzlich zu den von `GetRecoveryPointRestoreMetadata` bereitgestellten Werten weitere Werte erforderlich. Sie müssen beispielsweise möglicherweise einen neuen Ressourcennamen angeben, wenn das Original bereits vorhanden ist. Weitere Informationen zu den Metadaten für jede Ressource finden Sie im Folgenden: + [Metadaten für Amazon Aurora](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-aur.html#aur-restore-cli) + [Metadaten für Amazon DocumentDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-docdb.html#docdb-restore-cli) + [Metadaten für AWS CloudFormation](https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-application-stacks.html#restoring-cfn-cli) + [Metadaten für Amazon DynamoDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-dynamodb.html#ddb-restore-cli) + [Metadaten für Amazon EBS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ebs.html#ebs-restore-cli) + [Metadaten für Amazon EC2](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ec2.html#restoring-ec2-cli) + [Metadaten für Amazon EFS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-efs.html#efs-restore-cli) + [Metadaten für Amazon EKS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-eks.html#eks-restore-backup-section) + [Metadaten für Amazon FSx](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-fsx.html#fsx-restore-cli) + [Metadaten für Amazon Neptune](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-nep.html#nep-restore-cli) + [Metadaten für Amazon RDS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-rds.html#rds-restore-cli) + [Metadaten für Amazon Redshift](https://docs.aws.amazon.com/aws-backup/latest/devguide/redshift-restores.html#redshift-restore-api) + [Metadaten für AWS Storage Gateway](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-storage-gateway.html#restoring-sgw-cli) + [Metadaten für Amazon S3](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-s3.html#s3-restore-cli) + [Metadaten für Amazon Timestream](https://docs.aws.amazon.com/aws-backup/latest/devguide/timestream-restore.html#timestream-restore-api) + [Metadaten für virtuelle Maschinen](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-vm.html#vm-restore-cli) Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge Erforderlich: Ja ** [RecoveryPointArn](#API_StartRestoreJob_RequestSyntax) ** 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 Erforderlich: Ja ** [ResourceType](#API_StartRestoreJob_RequestSyntax) ** Startet einen Auftrag zur Wiederherstellung eines Wiederherstellungspunkts für eine der folgenden Ressourcen: + `Aurora`- Amazon Aurora + `DocumentDB`- Amazon DocumentDB + `CloudFormation` - AWS CloudFormation + `DynamoDB`- Amazon DynamoDB + `EBS`- Amazon Elastic Block Store + `EC2`- Amazon Elastic Compute Cloud + `EFS`- Amazon Elastic File System + `EKS`- Amazon Elastic Kubernetes Service + `FSx`- Amazon FSx + `Neptune`- Amazon Neptune + `RDS`- Amazon Relational Database Service + `Redshift`- Amazon Redshift + `Storage Gateway` - AWS Storage Gateway + `S3`- Amazon Simple Storage Service + `Timestream`- Amazon Timestream + `VirtualMachine`- Virtuelle Maschinen Typ: Zeichenfolge Pattern: `^[a-zA-Z0-9\-\_\.]{1,50}$` Erforderlich: Nein ## Antwortsyntax ``` HTTP/1.1 200 Content-type: application/json { "RestoreJobId": "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. ** [RestoreJobId](#API_StartRestoreJob_ResponseSyntax) ** Identifiziert den Auftrag, der einen Wiederherstellungspunkt wiederherstellt, eindeutig. Typ: Zeichenfolge ## 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 ** InvalidRequestException ** Zeigt an, dass etwas mit der Eingabe für die Anforderung nicht stimmt. Beispielsweise ist ein Parameter vom falschen Typ. ** 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/StartRestoreJob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartRestoreJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartRestoreJob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartRestoreJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartRestoreJob) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartRestoreJob) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartRestoreJob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartRestoreJob) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartRestoreJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartRestoreJob)