REST Resource: customers.v2.Groups

리소스: 그룹

그룹의 SCIM 표현입니다.

JSON 표현
{
  "schemas": [
    string
  ],
  "members": [
    {
      object (Member)
    }
  ],
  "id": string,
  "externalId": string,
  "meta": {
    object (Meta)
  },
  "displayName": string,
  "urn:ietf:params:scim:schemas:extension:google:2.0:CloudIdentityGroup": {
    object (CloudIdentityGroupExtension)
  }
}
필드
schemas[]

string

필수 항목입니다. 현재 JSON 구조에 있는 속성을 정의하는 SCIM 스키마의 네임스페이스를 나타내는 URI 목록입니다. 그룹 ResourceType에 대해 schemaschemaExtensions로 정의된 값만 포함해야 합니다.

members[]

object (Member)

선택사항입니다. 이 그룹의 구성원 목록입니다. 이 속성은 현재 반환되지 않습니다. 그룹 멤버십은 PATCH 요청을 통해 수정할 수 있습니다.

id

string

식별자. 그룹의 고유 ID입니다. 속성 특성은 caseExacttrue, 변경 가능성이 readOnly, returned 특성이 always입니다.

externalId

string

선택사항입니다. 프로비저닝 클라이언트에서 정의한 리소스의 식별자입니다.

meta

object (Meta)

출력 전용입니다. 리소스 메타데이터입니다. 모든 하위 속성의 변경 가능성은 readOnly이고 returned 특성은 default입니다.

displayName

string

필수 항목입니다. 그룹의 표시 이름입니다.

urn:ietf:params:scim:schemas:extension:google:2.0:CloudIdentityGroup

object (CloudIdentityGroupExtension)

필수 항목입니다. Cloud ID 관련 그룹 속성입니다.

구성원

그룹 구성원의 SCIM 표현입니다.

JSON 표현
{
  "value": string,
  "$ref": string
}
필드
value

string

변경할 수 없습니다. 이 그룹의 구성원 식별자입니다.

$ref

string

변경할 수 없습니다. 구성원의 URI입니다.

CloudIdentityGroupExtension

Google Cloud ID 그룹 확장 프로그램의 속성을 정의합니다. 이 확장 프로그램의 스키마 URN은 urn:ietf:params:scim:schemas:extension:google:2.0:CloudIdentityGroup입니다.

JSON 표현
{
  "email": string,
  "description": string
}
필드
email

string

필수 항목입니다. 그룹의 이메일 주소입니다. 계정에 도메인이 여러 개 있는 경우 이메일 주소에 적합한 도메인을 선택합니다. email은 고유해야 합니다. 그룹 이메일 주소에는 사용자 이름과 동일한 문자 사용 규칙이 적용됩니다. 자세한 내용은 고객센터 문서를 참고하세요.

description

string

선택사항입니다. 사용자가 Group의 목적을 파악하는 데 도움이 되는 확장된 설명입니다.

제한: 4,096자(영문 기준)

메서드

create

그룹을 만듭니다.

delete

그룹을 삭제합니다.

get

그룹을 검색합니다.

list

그룹 목록을 검색합니다.

patch

SCIM 패치 의미 체계를 사용하여 그룹을 업데이트합니다.