Method: customers.v2.Groups.list

그룹 목록을 가져옵니다.

  • 요청은 필터를 지정해야 합니다. filter 매개변수가 없는 요청은 tooMany 오류를 반환합니다.
  • filter 매개변수는 displayName (예: displayName eq "Group Name") 또는 externalId (예: externalId eq "ddaafa46e2b6")의 동등성만 지원합니다.
  • 부분 문자열 일치 (co, sw, ew), 논리 연산자 (and, or), 복잡한 값 필터는 지원되지 않습니다.
  • 페이지로 나누기는 지원되지 않습니다. 그룹 일치 항목이 50개를 초과하면 처음 50개의 결과만 반환됩니다.

HTTP 요청

GET https://cloudidentityscim.googleapis.com/v1/customers/{customerId}/v2/Groups

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

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 고객 ID입니다.

쿼리 파라미터

매개변수
filter

string

필터 매개변수입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

그룹 목록에서 가져온 응답 메시지입니다.

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

JSON 표현 
{
  "schemas": [
    string
  ],
  "resources": [
    {
      object (Group)
    }
  ],
  "totalResults": integer
}
필드
schemas[]

string

반환된 리소스의 스키마입니다.
resources[]

object (Group)

요청된 리소스 목록입니다.
totalResults

integer

총 결과 수입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 승인 가이드를 참고하세요.