기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
ListSearchJobBackups
이 작업은 검색 작업에 포함된 페이지 매김 형식의 모든 백업(복구 지점) 목록을 반환합니다.
검색 결과 예상 백업이 표시되지 않는 경우 이 작업을 호출하여 검색에 포함된 각 백업을 표시할 수 있습니다. 권한 문제로 인해 FAILED 상태가 되어 포함되지 않은 모든 백업은 상태 메시지와 함께 표시됩니다.
백업 인덱스 상태가 ACTIVE인 복구 시점만 검색 결과에 포함됩니다. 인덱스에 다른 상태가 있는 경우 상태 메시지와 함께 상태가 표시됩니다.
Request Syntax
GET /search-jobs/SearchJobIdentifier/backups?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
- MaxResults
-
반환할 리소스 목록 항목의 최대 수입니다.
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.
- NextToken
-
검색 작업에 포함된 반환된 백업의 부분 목록을 따르는 다음 항목입니다.
예를 들어, 백업의
MaxResults수를 반환하기 위한 요청을 한 경우,NextToken을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다. - SearchJobIdentifier
-
검색 작업을 지정하는 고유한 문자열입니다.
필수 여부: 예
Request Body
해당 요청에는 본문이 없습니다.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Results": [
{
"BackupCreationTime": number,
"BackupResourceArn": "string",
"IndexCreationTime": number,
"ResourceType": "string",
"SourceResourceArn": "string",
"Status": "string",
"StatusMessage": "string"
}
]
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- NextToken
-
검색 작업에 포함된 반환된 백업의 부분 목록을 따르는 다음 항목입니다.
예를 들어, 백업의
MaxResults수를 반환하기 위한 요청을 한 경우,NextToken을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.유형: 문자열
- Results
-
복구 시점이 검색 작업의 결과를 반환했습니다.
타입: SearchJobBackupsResult 객체 배열
오류
모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- 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 SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
