翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # StartRestoreJob Amazon リソースネーム (ARN) で識別された保存されたリソースを回復します。 ## リクエストの構文 ``` PUT /restore-jobs HTTP/1.1 Content-type: application/json { "CopySourceTagsToRestoredResource": boolean, "IamRoleArn": "string", "IdempotencyToken": "string", "Metadata": { "string" : "string" }, "RecoveryPointArn": "string", "ResourceType": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [CopySourceTagsToRestoredResource](#API_StartRestoreJob_RequestSyntax) ** このパラメータはオプションです。これが `True` に等しい場合、バックアップに含まれるタグは復元されたリソースにコピーされます。 これは、 で作成されたバックアップにのみ適用されます AWS Backup。 タイプ: ブール値 必須: いいえ ** [IamRoleArn](#API_StartRestoreJob_RequestSyntax) ** がターゲットリソースの作成 AWS Backup に使用する IAM ロールの Amazon リソースネーム (ARN)。例: `arn:aws:iam::123456789012:role/S3Access`。 タイプ: 文字列 必須: いいえ ** [IdempotencyToken](#API_StartRestoreJob_RequestSyntax) ** 別の `StartRestoreJob` への同じコール間を区別するために使用できる顧客が選択した文字列。同じ冪等性トークンで成功したリクエストを再試行すると、アクションは実行されず、成功メッセージが表示されます。 タイプ: 文字列 必須: いいえ ** [Metadata](#API_StartRestoreJob_RequestSyntax) ** メタデータのキーと値のペアのセット。 `GetRecoveryPointRestoreMetadata` を呼び出して、バックアップ時にリソースに関する構成メタデータを取得できます。ただし、`GetRecoveryPointRestoreMetadata` によって提供される値に加えて値リソースの復元が必要になる場合があります。たとえば、元のリソースがすでに存在する場合は、新しいリソース名を指定する必要があります。 各リソースのメタデータの詳細については、以下を参照してください。 + [Amazon Aurora のメタデータ](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-aur.html#aur-restore-cli) + [Amazon DocumentDB のメタデータ](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-docdb.html#docdb-restore-cli) + [のメタデータ AWS CloudFormation](https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-application-stacks.html#restoring-cfn-cli) + [Amazon DynamoDB のメタデータ](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-dynamodb.html#ddb-restore-cli) + [Amazon EBS のメタデータ](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ebs.html#ebs-restore-cli) + [Amazon EC2 のメタデータ](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ec2.html#restoring-ec2-cli) + [Amazon EFS のメタデータ](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-efs.html#efs-restore-cli) + [Amazon EKS のメタデータ](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-eks.html#eks-restore-backup-section) + [Amazon FSx のメタデータ](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-fsx.html#fsx-restore-cli) + [Amazon Neptune のメタデータ](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-nep.html#nep-restore-cli) + [Amazon RDS のメタデータ](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-rds.html#rds-restore-cli) + [Amazon Redshift のメタデータ](https://docs.aws.amazon.com/aws-backup/latest/devguide/redshift-restores.html#redshift-restore-api) + [のメタデータ AWS Storage Gateway](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-storage-gateway.html#restoring-sgw-cli) + [Amazon S3 のメタデータ](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-s3.html#s3-restore-cli) + [Amazon Timestream のメタデータ](https://docs.aws.amazon.com/aws-backup/latest/devguide/timestream-restore.html#timestream-restore-api) + [仮想マシンのメタデータ](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-vm.html#vm-restore-cli) タイプ: 文字列間のマッピング 必須: はい ** [RecoveryPointArn](#API_StartRestoreJob_RequestSyntax) ** たとえば、`arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`などのリカバリポイントを一意に識別する ARN。 タイプ: 文字列 必須: はい ** [ResourceType](#API_StartRestoreJob_RequestSyntax) ** 次のいずれかのリソースのリカバリポイントを復元するジョブを開始します。 + `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 サービス + `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` – 仮想マシン タイプ: 文字列 パターン: `^[a-zA-Z0-9\-\_\.]{1,50}$` 必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "RestoreJobId": "string" } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [RestoreJobId](#API_StartRestoreJob_ResponseSyntax) ** リカバリポイントをリストアするジョブを一意に識別します。 タイプ: 文字列 ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** InvalidParameterValueException ** パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。 ** Context ** ** Type ** HTTP ステータスコード: 400 ** InvalidRequestException ** リクエストへの入力に何らかの問題が発生していることを示します。たとえば、パラメータのタイプが間違っています。 ** Context ** ** Type ** HTTP ステータスコード: 400 ** MissingParameterValueException ** 必須パラメータがないことを示します。 ** Context ** ** Type ** HTTP ステータスコード: 400 ** ResourceNotFoundException ** アクションに必要なリソースは存在しません。 ** Context ** ** Type ** HTTP ステータスコード: 400 ** ServiceUnavailableException ** サーバーの一時的障害のため、リクエストは失敗しました。 ** Context ** ** Type ** HTTP ステータスコード: 500 ## その他の参照資料 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス 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 for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartRestoreJob) + [AWS SDK for 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 for 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)