기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeBackupJob
지정된 BackupJobId에 대한 백업 작업 세부 정보를 반환합니다.
Request Syntax
GET /backup-jobs/backupJobId HTTP/1.1
URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
- backupJobId
-
리소스 백업 요청을 고유하게 AWS Backup 식별합니다.
필수 여부: 예
Request Body
해당 요청에는 본문이 없습니다.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"AccountId": "string",
"BackupJobId": "string",
"BackupOptions": {
"string" : "string"
},
"BackupSizeInBytes": number,
"BackupType": "string",
"BackupVaultArn": "string",
"BackupVaultName": "string",
"BytesTransferred": number,
"ChildJobsInState": {
"string" : number
},
"CompletionDate": number,
"CreatedBy": {
"BackupPlanArn": "string",
"BackupPlanId": "string",
"BackupPlanVersion": "string",
"BackupRuleId": "string"
},
"CreationDate": number,
"ExpectedCompletionDate": number,
"IamRoleArn": "string",
"InitiationDate": number,
"IsParent": boolean,
"MessageCategory": "string",
"NumberOfChildJobs": number,
"ParentJobId": "string",
"PercentDone": "string",
"RecoveryPointArn": "string",
"ResourceArn": "string",
"ResourceName": "string",
"ResourceType": "string",
"StartBy": number,
"State": "string",
"StatusMessage": "string"
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- AccountId
-
백업 작업을 소유한 계정 ID를 반환합니다.
유형: String
패턴:
^[0-9]{12}$ - BackupJobId
-
리소스 백업 요청을 고유하게 AWS Backup 식별합니다.
타입: 문자열
- BackupOptions
-
백업 계획 또는 온디맨드 백업 작업의 일부로 지정된 옵션을 나타냅니다.
유형: String 간 맵
키 패턴:
^[a-zA-Z0-9\-\_\.]{1,50}$값 패턴:
^[a-zA-Z0-9\-\_\.]{1,50}$ - BackupSizeInBytes
-
백업의 크기(바이트 단위)입니다.
타입: Long
- BackupType
-
백업 작업을 위해 선택한 실제 백업 유형을 나타냅니다. 예를 들어, Windows VSS(Volume Shadow Copy Service) 백업이 성공적으로 수행된 경우
BackupType은"WindowsVSS"를 반환합니다.BackupType이 비어 있는 경우 백업 유형은 일반 백업입니다.타입: 문자열
- BackupVaultArn
-
백업 저장소를 고유하게 식별하는 Amazon 리소스 이름(ARN)(예:
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault)입니다.타입: 문자열
- BackupVaultName
-
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 AWS 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다. 백업 저장소는 소문자, 숫자, 하이픈(-)으로 구성됩니다.
유형: String
패턴:
^[a-zA-Z0-9\-\_]{2,50}$ - BytesTransferred
-
작업 상태를 쿼리할 때 백업 저장소로 전송된 크기(바이트)입니다.
타입: Long
- ChildJobsInState
-
포함된 하위(중첩) 백업 작업의 통계를 반환합니다.
유형: String과 Long 간의 맵
유효한 키:
CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL - CompletionDate
-
백업 작업을 생성하기 위한 작업이 완료된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다.
CompletionDate의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.유형: 타임스탬프
- CreatedBy
-
백업 작업을 생성하는 데 사용되는 백업 계획의
BackupPlanArn,BackupPlanId,BackupPlanVersion,BackupRuleId를 비롯하여, 백업 작업의 생성에 대한 식별 정보를 포함합니다.유형: RecoveryPointCreator객체
- CreationDate
-
백업 작업이 생성된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다.
CreationDate의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.유형: 타임스탬프
- ExpectedCompletionDate
-
리소스를 백업하는 작업이 완료될 것으로 예상되는 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다.
ExpectedCompletionDate의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.유형: 타임스탬프
- IamRoleArn
-
대상 복구 시점을 생성하는 데 사용되는 IAM 역할 ARN을 지정합니다(예:
arn:aws:iam::123456789012:role/S3Access).타입: 문자열
- InitiationDate
-
백업 작업이 시작된 날짜.
유형: 타임스탬프
- IsParent
-
백업 작업이 상위(복합) 작업인 부울 값을 반환합니다.
타입: 부울
- MessageCategory
-
지정된 메시지 범주의 작업 수입니다.
예시 문자열에는
AccessDenied,SUCCESS,AGGREGATE_ALL,INVALIDPARAMETERS등이 있습니다. 허용된 MessageCategory 문자열 목록에 대한 모니터링 보기.타입: 문자열
- NumberOfChildJobs
-
하위(중첩) 백업 작업 수를 반환합니다.
타입: Long
- ParentJobId
-
상위(복합) 리소스 백업 작업 ID를 반환합니다.
타입: 문자열
- PercentDone
-
작업 상태를 쿼리할 때 작업의 예상 완료율을 포함합니다.
타입: 문자열
- RecoveryPointArn
-
복구 시점을 고유하게 식별하는 ARN입니다(예:
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45).타입: 문자열
- ResourceArn
-
저장된 리소스를 고유하게 식별하는 ARN입니다. ARN의 형식은 리소스 유형에 따라 달라집니다.
타입: 문자열
- ResourceName
-
지정된 백업에 속하는 리소스의 고유하지 않은 이름.
타입: 문자열
- ResourceType
-
백업할 AWS 리소스 유형 (예: 아마존 엘라스틱 블록 스토어 (Amazon EBS) 볼륨 또는 아마존 관계형 데이터베이스 서비스 (Amazon RDS) 데이터베이스).
유형: String
패턴:
^[a-zA-Z0-9\-\_\.]{1,50}$ - StartBy
-
백업 작업을 취소하기 전에 시작해야 하는 시간을 Unix 형식 및 협정 세계시(UTC)로 지정합니다. 이 값은 시작 기간을 예약된 시간에 더하여 계산됩니다. 따라서 예약된 시간이 오후 6시이고 시작 기간이 2시간인 경우,
StartBy시간은 지정된 날짜의 오후 8시가 됩니다.StartBy의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.유형: 타임스탬프
- State
-
백업 작업의 현재 상태입니다.
타입: 문자열
유효 값:
CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL - StatusMessage
-
리소스를 백업하기 위한 작업의 상태를 설명하는 자세한 메시지입니다.
타입: 문자열
Errors
모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하십시오.
- DependencyFailureException
-
종속 AWS 서비스 또는 리소스가 서비스에 오류를 반환하여 작업을 완료할 수 없습니다. AWS Backup
HTTP 상태 코드: 500
- InvalidParameterValueException
-
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.
HTTP 상태 코드: 400
- MissingParameterValueException
-
필수 파라미터가 누락되었음을 나타냅니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
작업에 필요한 리소스가 존재하지 않습니다.
HTTP 상태 코드: 400
- ServiceUnavailableException
-
요청이 서버의 일시적 장애 때문에 실패했습니다.
HTTP 상태 코드: 500
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
