동적 그룹 만들기 및 업데이트

이 페이지에서는 동적 그룹을 만들고 업데이트하는 방법을 설명합니다.

시작하기 전에

이 페이지의 정보를 계속 진행하기 전에 다음 작업을 수행하세요.

동적 그룹 만들기

다음은 동적 그룹 만들기의 예시입니다.

REST

동적 그룹을 만들려면 그룹의 인스턴스로 groups.create()를 호출합니다. 그룹의 인스턴스에는 그룹을 채우는 데 사용되는 쿼리와 함께 dynamicGroupMetadata가 포함되어야 합니다.

Python

동적 그룹을 만들려면 그룹의 인스턴스로 service.groups().create 메서드를 호출합니다. 그룹의 인스턴스에는 그룹을 채우는 데 사용되는 쿼리와 함께 dynamicGroupMetadata가 포함되어야 합니다. 다음 샘플은 엔지니어링 부서의 기존 사용자가 모두 포함된 동적 그룹을 만드는 방법을 보여줍니다.

def create_dynamic_group(customer_id, email, query):
  service = build_service()
  groupDef = {
      "parent": "customerId/{}".format(customer_id),
      "groupKey": {"id": email},
      "labels": {"cloudidentity.googleapis.com/groups.discussion_forum": ""},
      "dynamicGroupMetadata": {
          "queries": [
              {
                  "resourceType": "USER",
                  "query": "user.organizations.exists(org, org.department=='engineering')"
              }
          ]
      }
  }
  request = service.groups().create(body=groupDef)
  request.uri += "&initialGroupConfig=EMPTY"
  response = request.execute()
  return response

동적 그룹 업데이트

다음은 동적 그룹 업데이트의 예시입니다.

REST

동적 그룹을 업데이트하려면 그룹의 인스턴스로 groups.patch()를 호출합니다. 그룹의 인스턴스에는 그룹을 채우는 데 사용되는 새 쿼리와 함께 dynamicGroupMetadata가 포함되어야 합니다.

Python

동적 그룹을 업데이트하려면 업데이트할 그룹의 이름과 그룹의 인스턴스로 service.groups().patch 메서드를 호출합니다. 그룹의 인스턴스에는 그룹을 채우는 데 사용되는 쿼리와 함께 dynamicGroupMetadata가 포함되어야 합니다. 다음 샘플은 엔지니어링의 모든 사용자를 포함하는 동적 그룹을 엔지니어링 또는 재무 부서의 모든 사용자가 포함된 그룹으로 업데이트하는 방법을 보여줍니다.

# name (i.e. groups/01234abcdeef) uniquely identifies the group
def update_dynamic_group(name, query):
  service = build_service()
  groupDef = {
    "dynamicGroupMetadata": {
    "queries": [
        {
          "resourceType": "USER",
          "query": "user.organizations.exists(org, org.department=='engineering' || org.department=='finance')"
        }
      ]
    }
  }
  request = service.groups().patch(name=name, body=groupDef)
  request.uri += "&updateMask=dynamicGroupMetadata"
  response = request.execute()

  return response

다음 단계

동적 그룹이 존재하면 이를 검색하고 멤버십을 나열할 수 있습니다. 자세한 내용은 동적 그룹 검색 및 구성원 나열을 참조하세요.