기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeScanJob
지정된 ScanJobID에 대한 스캔 작업 세부 정보를 반환합니다.
Request Syntax
GET /scan/jobs/ScanJobId HTTP/1.1
URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
- ScanJobId
-
에 AWS Backup 대한 리소스 스캔 요청을 고유하게 식별합니다.
필수 항목 여부: 예
Request Body
해당 요청에는 본문이 없습니다.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"AccountId": "string",
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CompletionDate": number,
"CreatedBy": {
"BackupPlanArn": "string",
"BackupPlanId": "string",
"BackupPlanVersion": "string",
"BackupRuleId": "string"
},
"CreationDate": number,
"IamRoleArn": "string",
"MalwareScanner": "string",
"RecoveryPointArn": "string",
"ResourceArn": "string",
"ResourceName": "string",
"ResourceType": "string",
"ScanBaseRecoveryPointArn": "string",
"ScanId": "string",
"ScanJobId": "string",
"ScanMode": "string",
"ScannerRoleArn": "string",
"ScanResult": {
"ScanResultStatus": "string"
},
"State": "string",
"StatusMessage": "string"
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- AccountId
-
스캔 작업을 소유한 계정 ID를 반환합니다.
패턴:
^[0-9]{12}$유형: 문자열
- BackupVaultArn
-
백업 볼트를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다. 예:
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault유형: 문자열
- BackupVaultName
-
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소를 생성하는 데 사용된 계정과 백업 저장소가 생성된 AWS 리전에 고유한 이름으로 식별됩니다.
패턴:
^[a-zA-Z0-9\-\_\.]{2,50}$유형: 문자열
- CompletionDate
-
백업 인덱스가 생성을 완료한 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다.
CompletionDate의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.유형: 타임스탬프
- CreatedBy
-
스캔을 시작한 백업 계획 및 규칙을 포함하여 스캔 작업 생성에 대한 식별 정보를 포함합니다.
유형: ScanJobCreator객체
- CreationDate
-
백업 인덱스가 생성을 완료한 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다.
CreationDate의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.유형: 타임스탬프
- IamRoleArn
-
백업 저장소를 고유하게 식별하는 Amazon 리소스 이름(ARN)(예:
arn:aws:iam::123456789012:role/S3Access)입니다.유형: 문자열
- MalwareScanner
-
해당 스캔 작업에 사용되는 스캔 엔진입니다. 현재
GUARDUTY만 지원됩니다.타입: 문자열
유효 값:
GUARDDUTY - RecoveryPointArn
-
스캔을 위한 대상 복구 시점을 고유하게 식별하는 ARN입니다. 예:
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.유형: 문자열
- ResourceArn
-
해당 복구 시점 ARN의 소스 리소스를 고유하게 식별하는 ARN입니다.
유형: 문자열
- ResourceName
-
지정된 백업에 속하는 리소스의 고유하지 않은 이름입니다.
유형: 문자열
- ResourceType
-
백업할 AWS 리소스 유형. 예: Amazon Elastic Block Store(Amazon EBS) 볼륨.
패턴:
^[a-zA-Z0-9\-\_\.]{1,50}$타입: 문자열
유효 값:
EBS | EC2 | S3 - ScanBaseRecoveryPointArn
-
스캔을 위한 기본 복구 시점을 고유하게 식별하는 ARN입니다. 이 필드는 증분 스캔 작업이 수행된 경우에만 채워집니다.
유형: 문자열
- ScanId
-
Amazon GuardDuty에서 해당 스캔 작업 ID 요청에 대해 생성한 스캔 ID입니다 AWS Backup.
유형: 문자열
- ScanJobId
-
요청을 고유하게 식별한 스캔 작업 ID입니다 AWS Backup.
유형: 문자열
- ScanMode
-
스캔 작업에 사용되는 스캔 유형을 지정합니다.
타입: 문자열
유효 값:
FULL_SCAN | INCREMENTAL_SCAN - ScannerRoleArn
-
스캔 작업에 사용되는 스캐너 IAM 역할 ARN을 지정합니다.
유형: 문자열
- ScanResult
-
스캔 작업에
ScanResultsStatus대한를 포함하고 완료된 작업에NO_THREATS_FOUND대해THREATS_FOUND또는를 반환합니다.유형: ScanResultInfo객체
- State
-
스캔 작업의 현재 상태입니다.
타입: 문자열
유효 값:
CANCELED | COMPLETED | COMPLETED_WITH_ISSUES | CREATED | FAILED | RUNNING - StatusMessage
-
리소스를 백업하기 위한 작업의 상태를 설명하는 자세한 메시지입니다.
유형: 문자열
오류
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- InvalidParameterValueException
-
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.
- Context
- Type
HTTP 상태 코드: 400
- MissingParameterValueException
-
필수 파라미터가 누락되었음을 나타냅니다.
- Context
- Type
HTTP 상태 코드: 400
- ResourceNotFoundException
-
작업에 필요한 리소스가 존재하지 않습니다.
- Context
- Type
HTTP 상태 코드: 400
- ServiceUnavailableException
-
요청이 서버의 일시적 장애 때문에 실패했습니다.
- Context
- Type
HTTP 상태 코드: 500
참고
언어별 AWS SDKs