Method: organizations.sources.findings.group

조직 또는 소스의 발견 항목을 필터링하고 지정된 속성별로 그룹화합니다.

모든 소스를 기준으로 그룹화하려면 소스 ID로 -를 제공합니다. 예: /v1beta1/organizations/{organization_id}/sources/-/findings

HTTP 요청


URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 입력란입니다. groupBy할 소스의 이름입니다. 형식은 'organizations/[organization_id]/sources/[source_id]'입니다. 모든 소스에서 그룹화하려면 source_id를 -로 지정합니다. 예: organizations/{organization_id}/sources/-

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "filter": string,
  "groupBy": string,
  "readTime": string,
  "pageToken": string,
  "pageSize": integer
}
필드
filter

string

발견 항목 전체에 적용할 필터를 정의하는 표현식입니다. 이 표현식은 논리 연산자 AND 및 OR를 통해 결합된 하나 이상의 제한사항 목록입니다. 괄호는 지원되지 않으며 OR의 우선순위가 AND보다 높습니다.

제약조건은 <field> <operator> <value> 형식이며 앞에 - 문자가 있어 부정을 나타낼 수 있습니다. 예를 들면 다음과 같습니다.

  • name
  • sourceProperties.a_property
  • securityMarks.marks.marka

지원되는 연산자는 다음과 같습니다.

  • 모든 값 유형의 경우 =입니다.
  • 정수 값: >, <, >=, <=
  • :: 문자열의 하위 문자열 일치를 의미합니다.

지원되는 값 유형은 다음과 같습니다.

  • 문자열 리터럴을 따옴표로 묶습니다.
  • 따옴표가 없는 정수 리터럴
  • 따옴표가 없는 불리언 리터럴 true 및 false

예를 들어 sourceProperties.size = 100은 유효한 필터 문자열입니다.
groupBy

string

필수 입력란입니다. 그룹화에 사용할 애셋 필드를 정의하는 표현식입니다 (state 포함). 문자열 값은 SQL 구문, 즉 쉼표로 구분된 필드 목록을 따라야 합니다. 예: 'parent,resourceName'

다음 필드가 지원됩니다.

  • resourceName
  • 카테고리
  • state
  • parent
readTime

string (Timestamp format)

발견 항목을 필터링할 때 참조점으로 사용되는 시간입니다. 필터는 제공된 시간에 존재하는 발견 항목으로 제한되며 값은 해당 시간의 값입니다. 이 필드가 없으면 기본값은 API의 NOW 버전입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
pageToken

string

마지막 GroupFindingsResponse에서 반환한 값입니다. 이 값은 이전 findings.group 호출의 연속이며 시스템에서 다음 데이터 페이지를 반환해야 함을 나타냅니다.
pageSize

integer

단일 응답에서 반환할 최대 결과 수입니다. 기본값은 10, 최소는 1, 최대는 1,000입니다.

응답 본문

발견 항목별 그룹에 대한 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "groupByResults": [
    {
      object (GroupResult)
    }
  ],
  "readTime": string,
  "nextPageToken": string
}
필드
groupByResults[]

object (GroupResult)

결과 그룹화 기존의 고유한 속성/값 조합마다 요소가 있습니다. 이 요소에는 이러한 특정 속성/값이 표시된 횟수의 개수가 포함됩니다.
readTime

string (Timestamp format)

groupBy 요청을 실행하는 데 사용된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
nextPageToken

string

결과의 다음 페이지를 검색하는 토큰으로, 결과가 더 이상 없으면 비어 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참고하세요.