GetSearchJob - AWS Backup

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

GetSearchJob

이 작업은 진행 상황을 포함하여 검색 작업의 메타데이터를 검색합니다.

Request Syntax

GET /search-jobs/SearchJobIdentifier HTTP/1.1

URI 요청 파라미터

요청은 다음 URI 파라미터를 사용합니다.

SearchJobIdentifier

검색 작업을 지정하는 필수 고유 문자열입니다.

필수 여부: 예

Request Body

해당 요청에는 본문이 없습니다.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "CompletionTime": number, "CreationTime": number, "CurrentSearchProgress": { "ItemsMatchedCount": number, "ItemsScannedCount": number, "RecoveryPointsScannedCount": number }, "EncryptionKeyArn": "string", "ItemFilters": { "EBSItemFilters": [ { "CreationTimes": [ { "Operator": "string", "Value": number } ], "FilePaths": [ { "Operator": "string", "Value": "string" } ], "LastModificationTimes": [ { "Operator": "string", "Value": number } ], "Sizes": [ { "Operator": "string", "Value": number } ] } ], "S3ItemFilters": [ { "CreationTimes": [ { "Operator": "string", "Value": number } ], "ETags": [ { "Operator": "string", "Value": "string" } ], "ObjectKeys": [ { "Operator": "string", "Value": "string" } ], "Sizes": [ { "Operator": "string", "Value": number } ], "VersionIds": [ { "Operator": "string", "Value": "string" } ] } ] }, "Name": "string", "SearchJobArn": "string", "SearchJobIdentifier": "string", "SearchScope": { "BackupResourceArns": [ "string" ], "BackupResourceCreationTime": { "CreatedAfter": number, "CreatedBefore": number }, "BackupResourceTags": { "string" : "string" }, "BackupResourceTypes": [ "string" ], "SourceResourceArns": [ "string" ] }, "SearchScopeSummary": { "TotalItemsToScanCount": number, "TotalRecoveryPointsToScanCount": number }, "Status": "string", "StatusMessage": "string" }

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

CompletionTime

Unix 형식 및 협정 세계시(UTC)로 검색 작업이 완료된 날짜와 시간입니다. CompletionTime의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.

유형: 타임스탬프

CreationTime

Unix 형식 및 협정 세계시(UTC)로 검색 작업이 생성된 날짜와 시간입니다. CompletionTime의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.

유형: 타임스탬프

CurrentSearchProgress

BackupsScannedCount, ItemsScanned 및 ItemsMatched를 나타내는 숫자를 반환합니다.

유형: CurrentSearchProgress객체

EncryptionKeyArn

지정된 검색 작업에 대한 암호화 키입니다.

예시: arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.

유형: 문자열

ItemFilters

항목 필터는 검색 생성 시 지정된 모든 입력 항목 속성을 나타냅니다.

유형: ItemFilters객체

Name

지정된 검색 작업의 반환된 이름입니다.

유형: 문자열

SearchJobArn

지정된 검색 작업의 Amazon 리소스 이름(ARN)을 식별하는 고유 문자열입니다.

유형: 문자열

SearchJobIdentifier

지정된 검색 작업을 식별하는 고유 문자열입니다.

유형: 문자열

SearchScope

검색 범위는 검색에 입력되는 모든 백업 속성입니다.

유형: SearchScope객체

SearchScopeSummary

다음을 포함하여 지정된 검색 작업 범위에 대한 요약을 반환했습니다.

  • TotalBackupsToScanCount, 검색에서 반환된 복구 시점 수입니다.

  • TotalItemsToScanCount, 검색에서 반환된 항목 수입니다.

유형: SearchScopeSummary객체

Status

지정된 검색 작업의 현재 상태입니다.

검색 작업의 상태는 , RUNNING, COMPLETED, STOPPED, FAILED TIMED_OUT또는 중 하나일 수 있습니다EXPIRED.

타입: 문자열

유효 값: RUNNING | COMPLETED | STOPPING | STOPPED | FAILED

StatusMessage

상태가 인 이어치 작업 ERRORED 또는 문제가 있는 COMPLETED 작업 상태에 대한 상태 메시지가 반환됩니다.

예를 들어 권한 문제로 인해 검색에 스캔할 수 없는 복구 시점이 포함되어 있다는 메시지가 표시될 수 있습니다.

유형: 문자열

오류

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.

AccessDeniedException

이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.

message

사용자에게이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.

HTTP 상태 코드: 403

InternalServerException

내부 서버 오류가 발생했습니다. 요청을 재시도합니다.

message

요청을 처리하는 동안 예기치 않은 오류가 발생했습니다.

retryAfterSeconds

몇 초 후에 호출을 다시 시도합니다.

HTTP 상태 코드: 500

ResourceNotFoundException

이 요청에 대한 리소스를 찾을 수 없습니다.

ARN 또는 유형과 같은 리소스 정보가 올바르고 존재하는지 확인한 다음 요청을 다시 시도합니다.

message

요청은 존재하지 않는 리소스를 참조합니다.

resourceId

영향을 받는 리소스의 가상 식별자입니다.

resourceType

영향을 받는 리소스의 가상 유형입니다.

HTTP 상태 코드: 404

ThrottlingException

요청 제한 때문에 요청이 거부되었습니다.

message

요청 제한으로 인해 요청이 실패했습니다.

quotaCode

할당량이 있는 원래 서비스에 고유한 코드입니다.

retryAfterSeconds

몇 초 후에 호출을 다시 시도합니다.

serviceCode

이는 원래 서비스에 고유한 코드입니다.

HTTP 상태 코드: 429

ValidationException

입력이 서비스에서 지정한 제약 조건을 충족하지 못합니다.

message

입력이 Amazon 서비스에서 지정한 제약 조건을 충족하지 못합니다.

HTTP 상태 코드: 400

참고

언어별 AWS SDKs