翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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
-
このパラメータはオプションです。これが
True
に等しい場合、バックアップに含まれるタグは復元されたリソースにコピーされます。これは、 を通じて作成されたバックアップにのみ適用されます AWS Backup。
型: ブール値
必須:いいえ
- IamRoleArn
-
AWS Backup がターゲットリソースの作成に使用するIAMロールの Amazon リソースネーム (ARN)。例:
arn:aws:iam::123456789012:role/S3Access
。型: 文字列
必須: いいえ
- IdempotencyToken
-
別の
StartRestoreJob
への同じコール間を区別するために使用できる顧客が選択した文字列。同じ冪等性トークンで成功したリクエストを再試行すると、アクションは実行されず、成功メッセージが表示されます。型: 文字列
必須: いいえ
- Metadata
-
メタデータのキーと値のペアのセット。
GetRecoveryPointRestoreMetadata
を呼び出して、バックアップ時にリソースに関する構成メタデータを取得できます。ただし、GetRecoveryPointRestoreMetadata
によって提供される値に加えて値リソースの復元が必要になる場合があります。たとえば、元のリソースがすでに存在する場合は、新しいリソース名を指定する必要があります。各リソースのメタデータの詳細については、以下を参照してください。
型: 文字列間のマッピング
必須:はい
- RecoveryPointArn
-
リカバリポイントを一意に識別ARNする 。例えば、
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45
。型: 文字列
必須: はい
- ResourceType
-
次のいずれかのリソースのリカバリポイントを復元するジョブを開始します。
-
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 -
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"
}
レスポンス要素
アクションが成功すると、サービスは 200 HTTP レスポンスを送り返します。
次のデータは、 サービスによって JSON 形式で返されます。
- RestoreJobId
-
リカバリーポイントを復元するジョブを一意に識別します。
型: 文字列
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- InvalidParameterValueException
-
パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。
HTTP ステータスコード: 400
- InvalidRequestException
-
リクエストへの入力に何らかの問題が発生していることを示します。たとえば、パラメータのタイプが間違っています。
HTTP ステータスコード: 400
- MissingParameterValueException
-
必須パラメータがないことを示します。
HTTP ステータスコード: 400
- ResourceNotFoundException
-
アクションに必要なリソースは存在しません。
HTTP ステータスコード: 400
- ServiceUnavailableException
-
サーバーの一時的障害のため、リクエストは失敗しました。
HTTP ステータスコード: 500
以下の資料も参照してください。
言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。