기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeRestoreJob
작업 ID로 지정된 복원 작업과 관련된 메타데이터를 반환합니다.
Request Syntax
GET /restore-jobs/restoreJobId HTTP/1.1
URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
- restoreJobId
-
복구 시점을 복원하는 작업을 고유하게 식별합니다.
필수 여부: 예
Request Body
해당 요청에는 본문이 없습니다.
Response Syntax
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를 반환합니다.
유형: String
패턴:
^[0-9]{12}$ - BackupSizeInBytes
-
복원된 리소스의 크기(바이트 단위)입니다.
타입: Long
- 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
-
복구 시점을 복원하는 작업에 소요될 것으로 예상되는 시간(분)입니다.
타입: Long
- IamRoleArn
-
대상 복구 시점을 생성하는 데 사용되는 IAM 역할 ARN을 지정합니다(예:
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
-
복원 작업과 관련된 메타데이터를 리소스 유형별로 나열하여 반환합니다.
유형: String
패턴:
^[a-zA-Z0-9\-\_\.]{1,50}$ - RestoreJobId
-
복구 시점을 복원하는 작업을 고유하게 식별합니다.
유형: 문자열
- Status
-
복구 시점을 복원하기 위해 AWS Backup에서 시작한 작업의 상태를 지정하는 상태 코드입니다.
타입: 문자열
유효 값:
PENDING | RUNNING | COMPLETED | ABORTED | FAILED - StatusMessage
-
복구 시점을 복원하기 위한 작업의 상태를 보여 주는 메시지입니다.
유형: 문자열
- ValidationStatus
-
표시된 복원 작업에 대한 검증 실행 상태입니다.
타입: 문자열
유효 값:
FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING - ValidationStatusMessage
-
상태 메시지입니다.
유형: 문자열
Errors
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- DependencyFailureException
-
종속 AWS 서비스 또는 리소스가 AWS Backup 서비스에 오류를 반환하며, 작업을 완료할 수 없습니다.
HTTP 상태 코드: 500
- InvalidParameterValueException
-
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.
HTTP 상태 코드: 400
- MissingParameterValueException
-
필수 파라미터가 누락되었음을 나타냅니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
작업에 필요한 리소스가 존재하지 않습니다.
HTTP 상태 코드: 400
- ServiceUnavailableException
-
요청이 서버의 일시적 장애 때문에 실패했습니다.
HTTP 상태 코드: 500
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
