DescribeScanJob - AWS Backup

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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