本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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用于创建目标恢复点的IAM角色;例如
arn:aws:iam::123456789012:role/S3Access
。类型:字符串
- PercentDone
-
包含在查询作业状态时作业已完成的估计百分比。
类型:字符串
- RecoveryPointArn
-
ARN唯一标识恢复点的;例如,
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45
。类型:字符串
- RecoveryPointCreationDate
-
由指定还原任务创建的恢复点的创建日期。
类型:时间戳
- ResourceType
-
返回与按资源类型列出的还原作业关联的元数据。
类型:字符串
模式:
^[a-zA-Z0-9\-\_\.]{1,50}$
- RestoreJobId
-
唯一标识还原恢复点的作业。
类型:字符串
- Status
-
状态码,用于指定为恢复恢复点而启动 Amazon Backup 的任务的状态。
类型:字符串
有效值:
PENDING | RUNNING | COMPLETED | ABORTED | FAILED
- StatusMessage
-
一条显示恢复点还原作业状态的消息。
类型:字符串
- ValidationStatus
-
在指定的还原作业上运行验证的状态。
类型:字符串
有效值:
FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING
- ValidationStatusMessage
-
状态消息。
类型:字符串
错误
有关所有操作的常见错误的信息,请参阅常见错误。
- DependencyFailureException
-
依赖的 Amazon 服务或资源向该 Amazon Backup 服务返回了错误,操作无法完成。
HTTP状态码:500
- InvalidParameterValueException
-
表示参数的值有问题。例如,该值超出了范围。
HTTP状态码:400
- MissingParameterValueException
-
表示缺少必需的参数。
HTTP状态码:400
- ResourceNotFoundException
-
该操作所需的资源不存在。
HTTP状态码:400
- ServiceUnavailableException
-
由于服务器发生临时故障而导致请求失败。
HTTP状态码:500
另请参阅
有关在特定语言API中使用它的更多信息 Amazon SDKs,请参阅以下内容: