민감 데이터 검사 기록 API (V2)
ScanRecord는 특정 리소스에 특정 검사 구성(ScanConfiguration)을 적용한 한 번의 검사 기록입니다. 검사 구성은 반복 검사나 일회성 검사에 모두 사용할 수 있습니다. 기록 목록 조회에 검사 구성 ID와 검사 리소스가 속한 공간의 scopeRid를 전달합니다.
검사 상태
활성 여부는 ALL_SCANS, ACTIVE_SCANS, COMPLETED_SCANS로 필터링합니다. 별도의 결과 상태 필터는 다음 값을 사용합니다.
| 상태 | 의미 |
|---|---|
RUNNING | 검사 실행 중 |
FAILED | 검사 실패 |
SUCCEEDED_WITH_MATCHES | 검사를 마쳤고 일치 항목을 찾음 |
SUCCEEDED_WITHOUT_MATCHES | 검사를 마쳤고 일치 항목을 찾지 못함 |
CANCELLED | 검사 취소 |
UNPROCESSABLE_SKIPPED | 처리할 수 없어 건너뜀 |
NO_PERMISSION_SKIPPED | 권한이 없어 건너뜀 |
NO_NEW_DATA_SKIPPED | 새 데이터가 없어 건너뜀 |
상태 필터를 생략하면 해당 상태를 제한하지 않습니다. 완료 시각은 선택 필드이므로 모든 기록에 있다고 가정하지 않습니다.
조건별 결과
scanResult의 각 MatchConditionOutcome은 matchConditionRid, numberOfScannedRows, result를 포함합니다.
noMatch는 검사한 데이터에서 해당 조건을 검출하지 못한 결과입니다.datasetMatch는 일치한 열의 이름과 열별 일치 행 수를 제공합니다.mediasetMatch는 일치한 미디어 항목 수와 선택적인 미디어 항목 예시를 제공합니다. 예시에는mediaItemRid가 들어 있습니다.
검사한 행 수는 조건별 값입니다. 여러 조건의 수를 합쳐 전체 고유 행 수로 해석하지 않습니다. 같은 행이 여러 열에서 일치할 수도 있으므로 열별 일치 행 수의 합도 고유 행 수와 구분합니다.
matchConditionRids와 matchActionRids는 각각 탐지 조건과 탐지 대응의 식별자 목록입니다. 대응 RID가 포함되어 있다는 사실만으로 그 대응의 모든 효과가 완료되었다고 판단하지 않습니다. 이 API는 기존 검사 기록을 조회하며 새 검사를 시작하거나 대응을 실행하는 요청이 아닙니다.
pageSize로 페이지 크기를 지정할 수 있습니다. 다음 페이지가 있으면 응답의 nextPageToken을 다음 조회의 pageToken에 전달합니다.
검사 범위와 주기, 조건 및 자동 대응은 Sensitive Data Scanner에서 구성합니다.