POSIX 그룹 만들기 및 삭제

이 문서에서는 POSIX 그룹을 만들고 삭제하는 방법을 설명합니다.

시작하기 전에

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

POSIX 그룹 만들기

기존 Google 그룹에서 POSIX 그룹을 만들거나, Google 그룹을 새로 만들고 POSIX 정보를 추가하여 만들 수도 있습니다.

기존 Google 그룹에서 POSIX 그룹 만들기

다음 예시에서는 기존 Google 그룹에서 POSIX 그룹을 만드는 방법을 보여줍니다.

gcloud

gcloud beta identity groups update 명령어를 사용하여 기존 Google 그룹을 POSIX 그룹으로 업데이트합니다.

gcloud beta identity groups update EMAIL \
   --add-posix-group=gid=GROUP_ID,name=POSIX_NAME

다음을 바꿉니다.

  • EMAIL: 업데이트할 그룹의 이메일 주소입니다.
  • GROUP_ID: POSIX 그룹에 할당할 그룹 ID(GID)입니다.
  • POSIX_NAME: POSIX 그룹에 할당할 이름입니다.

REST

Google 그룹을 POSIX 그룹으로 업데이트하려면 지정된 POSIX 그룹 필드를 사용하여 groups.patch() 메서드를 호출합니다.

PATCH 'https://cloudidentity.googleapis.com/v1beta1/groups/GROUP_RESOURCE_NAME?updateMask=posix_group

{
  "posixGroups": [
    {
      "name": "POSIX_NAME",
      "gid": GROUP_ID
    }
  ]
}

다음을 바꿉니다.

  • GROUP_RESOURCE_NAME: Google 그룹의 리소스 이름입니다. 그룹의 리소스 이름을 찾으려면 gcloud identity groups describe 명령어를 실행합니다.
  • POSIX_NAME: POSIX 그룹에 할당할 이름입니다.
  • GROUP_ID: POSIX 그룹에 할당할 그룹 ID(GID)입니다.

Python

다음 예시에서는 Python 클라이언트 라이브러리를 사용하여 Google 그룹을 POSIX 그룹으로 업데이트하는 도우미 함수를 보여줍니다.

def add_posix_group_data_to_group(service, group_name, posix_name, posix_gid):
  group = {
    "posix_groups": [
          {
              "name": posix_name,
              "gid": posix_gid,
          }
      ]
  }
  try:
    request = service.groups().patch(name=group_name, body=group)
    request.uri = request.uri + '&updateMask=posix_groups'
    response = request.execute()
    print(response)
  except Exception as e:
    print(e)

새 Google 그룹에서 POSIX 그룹 만들기

다음 예시에서는 새 Google 그룹에서 POSIX 그룹을 만드는 방법을 보여줍니다.

gcloud

gcloud beta identity groups create 명령어를 사용하여 POSIX 그룹을 만듭니다.

gcloud beta identity groups create EMAIL \
  --organization=ORGANIZATION_ID \
  --labels=cloudidentity.googleapis.com/groups.discussion_forum \
  --posix-group=gid=GROUP_ID,name=POSIX_NAME

다음을 바꿉니다.

  • EMAIL: 만들려는 그룹의 이메일 주소입니다.
  • ORGANIZATION_ID: 그룹이 속한 조직입니다. ID('123456789') 또는 연결된 도메인('example.com')입니다.
  • GROUP_ID: 그룹에 설정한 그룹 ID(GID)입니다.
  • POSIX_NAME: 그룹에 설정한 이름입니다.

REST

그룹을 만들려면 이메일 주소, 조직 ID, POSIX 그룹, 새 그룹의 라벨을 사용하여 groups.create() 메서드를 호출합니다.

POST 'https://cloudidentity.googleapis.com/v1beta1/groups?initialGroupConfig=WITH_INITIAL_OWNER

{
"parent": "customers/CUSTOMER_ID",
"groupKey": {"id": "EMAIL"},
"labels": {"cloudidentity.googleapis.com/groups.discussion_forum": ""},
"posixGroups": [
  {
    "name": "POSIX_NAME",
     "gid": GROUP_ID,
  }
]
}

다음을 바꿉니다.

  • initialGroupConfig=WITH_INITIAL_OWNER: ?initialGroupConfig=WITH_INITIAL_OWNER이거나 비어 있습니다. 빈 그룹은 조직 관리자만 만들 수 있습니다.
  • CUSTOMER_ID: 조직의 고객 ID입니다. 고객 ID를 찾으려면 gcloud organizations list 명령어를 실행합니다.
  • EMAIL: 만들려는 그룹의 이메일 주소입니다.
  • POSIX_NAME: POSIX 그룹에 할당할 이름입니다.
  • GROUP_ID: POSIX 그룹에 할당할 그룹 ID(GID)입니다.

Python

다음 예시에서는 Python 클라이언트 라이브러리를 사용하여 POSIX 그룹을 만드는 도우미 함수가 나와 있습니다.

def create_posix_group(customer_id, email, query, posix_name, posix_gid):
  service = build_service()
  groupDef = {
      "parent": "customerId/{}".format(customer_id),
      "groupKey": {"id": email},
      "labels": {"cloudidentity.googleapis.com/groups.discussion_forum": ""},
      "posixGroups": [
          {
              "name": posix_name,
              "gid": posix_gid,
          }
      ]
  }
  request = service.groups().create(body=groupDef)
  request.uri += "&initialGroupConfig=WITH_INITIAL_OWNER"
  response = request.execute()
  return response

POSIX 그룹 삭제

다음 예시에서는 Google 그룹에서 POSIX 정보를 삭제하는 방법을 보여줍니다.

gcloud

gcloud beta identity groups update 명령어를 사용하고 GROUP_ID 또는 POSIX_NAME 값으로 --remove-posix-groups 플래그를 지정합니다.

gcloud beta identity groups update \
   EMAIL \
   --remove-posix-groups=GROUP_ID_or_POSIX_NAME

다음을 바꿉니다.

  • EMAIL: 삭제할 그룹의 이메일 주소입니다.
  • GROUP_ID_or_POSIX_NAME: 삭제할 그룹의 그룹 ID 또는 POSIX 그룹 이름입니다.

REST

Google 그룹을 POSIX 그룹으로 업데이트하려면 지정된 POSIX 그룹 필드를 사용하여 groups.patch() 메서드를 호출합니다.

PATCH 'https://cloudidentity.googleapis.com/v1beta1/groups/GROUP_RESOURCE_NAME?updateMask=posix_group

{
  "posixGroups": []
}

다음을 바꿉니다.

Python

다음 예시에서는 Python 클라이언트 라이브러리를 사용하여 Google 그룹을 POSIX 그룹으로 업데이트하는 도우미 함수를 보여줍니다.

def remove_posix_data_from_group(service, group_name, posix_name, posix_gid):
  group = {
    "posix_groups": []
  }
  try:
    request = service.groups().patch(name=group_name, body=group)
    request.uri = request.uri + '&updateMask=posix_groups'
    response = request.execute()
    print(response)
  except Exception as e:
    print(e)

다음 단계

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