翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
DescribeRestoreJob
ジョブ ID で指定された復元ジョブに関連付けられたメタデータを返します。
リクエストの構文
GET /restore-jobs/restoreJobId HTTP/1.1
URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- restoreJobId
-
リカバリポイントを復元するジョブを一意に識別します。
必須: はい
リクエストボディ
リクエストにリクエスト本文がありません。
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"AccountId": "string",
"BackupSizeInBytes": number,
"CompletionDate": number,
"CreatedBy": {
"RestoreTestingPlanArn": "string"
},
"CreatedResourceArn": "string",
"CreationDate": number,
"DeletionStatus": "string",
"DeletionStatusMessage": "string",
"ExpectedCompletionTimeMinutes": number,
"IamRoleArn": "string",
"PercentDone": "string",
"RecoveryPointArn": "string",
"RecoveryPointCreationDate": number,
"ResourceType": "string",
"RestoreJobId": "string",
"Status": "string",
"StatusMessage": "string",
"ValidationStatus": "string",
"ValidationStatusMessage": "string"
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- AccountId
-
復元ジョブを所有するアカウント ID を返します。
型: 文字列
パターン:
^[0-9]{12}$ - BackupSizeInBytes
-
復元されたリソースのサイズ (バイト単位)。
型: 長整数
- CompletionDate
-
リカバリポイントの復元ジョブが完了した日時 (Unix 形式および協定世界時 (UTC))。
CompletionDateの値はミリ秒単位の精度です。たとえば、1516925490.087 の値は、2018 年 1 月 26 日 (金) 午前12:11:30.087 を表します。型: タイムスタンプ
- CreatedBy
-
復元ジョブの作成に関する識別情報が含まれます。
型: RestoreJobCreator オブジェクト
- CreatedResourceArn
-
復元ジョブで作成されたリソースの Amazon リソースネーム (ARN)。
ARN の形式は、バックアップされたリソースのリソースタイプによって異なります。
型: 文字列
- CreationDate
-
復元ジョブが作成された日時 (Unix 時刻形式および協定世界時 (UTC))。
CreationDateの値はミリ秒単位の精度です。たとえば、1516925490.087 の値は、2018 年 1 月 26 日 (金) 午前12:11:30.087 を表します。型: タイムスタンプ
- DeletionStatus
-
復元テストで生成されたデータのステータス。
型: 文字列
有効な値:
DELETING | FAILED | SUCCESSFUL - DeletionStatusMessage
-
復元ジョブの削除ステータスを示します。
型: 文字列
- ExpectedCompletionTimeMinutes
-
リカバリーポイントを復元するジョブに要する予想される分単位の時間です。
型: 長整数
- IamRoleArn
-
たとえば、
arn:aws:iam::123456789012:role/S3Accessなどのターゲットリカバリポイントの作成に使用する IAM ロール ARN を指定します。型: 文字列
- PercentDone
-
ジョブのステータスが照会された時点でジョブが完了した推定パーセンテージが含まれます。
型: 文字列
- RecoveryPointArn
-
たとえば、
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45などのリカバリポイントを一意に識別する ARN。型: 文字列
- RecoveryPointCreationDate
-
指定された復元ジョブで作成された復旧ポイントの作成日。
型: タイムスタンプ
- ResourceType
-
リソースタイプ別にリストされた復元ジョブに関連付けられたメタデータを返します。
型: 文字列
パターン:
^[a-zA-Z0-9\-\_\.]{1,50}$ - RestoreJobId
-
リカバリポイントを復元するジョブを一意に識別します。
型: 文字列
- Status
-
リカバリポイントを復元する AWS Backup によって開始されるジョブの状態を指定するステータスコード。
型: 文字列
有効な値:
PENDING | RUNNING | COMPLETED | ABORTED | FAILED - StatusMessage
-
リカバリポイントを復元するジョブのステータスを示すメッセージ。
型: 文字列
- ValidationStatus
-
指定された復元ジョブで実行された検証のステータス。
型: 文字列
有効な値:
FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING - ValidationStatusMessage
-
ステータスメッセージ。
型: 文字列
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- DependencyFailureException
-
依存関係 AWS サービスまたはリソースから AWS Backup サービスにエラーが返され、アクションを完了できません。
HTTP ステータスコード：500
- InvalidParameterValueException
-
パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。
HTTP ステータスコード：400
- MissingParameterValueException
-
必須パラメータがないことを示します。
HTTP ステータスコード：400
- ResourceNotFoundException
-
アクションに必要なリソースは存在しません。
HTTP ステータスコード：400
- ServiceUnavailableException
-
サーバーの一時的障害のため、リクエストは失敗しました。
HTTP ステータスコード：500
その他の参照資料
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
