POSIX 그룹 검색 및 나열

주의: POSIX 그룹은 지원 중단되었습니다. 2024년 9월 26일부터 더 이상 새 POSIX 그룹을 만들 수 없습니다. 자세한 내용은 POSIX 그룹 지원 중단을 참조하세요.

이 문서에서는 POSIX 그룹을 검색 및 나열하는 방법을 설명합니다.

미리보기

이 제품에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 제품은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

참고: POSIX 그룹을 검색하고 나열하려면 베타 버전의 Cloud Identity Groups API를 사용해야 합니다.

POSIX 그룹 회원 검색

Google 그룹 이름, POSIX 그룹 이름, POSIX 그룹 ID, 이메일을 사용해서 그룹 정보를 검색할 수 있습니다.

그룹 이름으로 POSIX 그룹 검색

다음 샘플은 그룹 이름을 사용하여 POSIX 그룹을 검색하는 방법을 보여줍니다.

REST

이름으로 POSIX 그룹을 검색하려면 그룹의 리소스 이름으로 groups.get() 메서드를 호출합니다.

GET "https://cloudidentity.googleapis.com/v1beta1/groups/GROUP_RESOURCE_NAME"

다음을 바꿉니다.

• GROUP_RESOURCE_NAME: Google 그룹의 리소스 이름입니다. 그룹의 리소스 이름을 찾으려면 gcloud identity groups describe 명령어를 실행합니다.

Python

다음 예시에서는 Python 클라이언트 라이브러리를 사용하여 이름으로 POSIX 그룹을 검색하는 방법을 보여줍니다.

def get_posix_group_by_name(name):
  service = build_service()
  response = service.groups().get(name=name).execute()
  return response

POSIX 그룹 이름으로 POSIX 그룹 검색

다음 샘플은 POSIX 그룹 이름으로 그룹 정보를 검색하는 방법을 보여줍니다.

REST

POSIX 그룹 이름으로 POSIX 그룹을 검색하려면 다음 쿼리 문자열을 사용해서 groups.search() 메서드를 호출합니다.

query=parent=='customers/CUSTOMER_ID' && 'cloudidentity.googleapis.com/groups.posix' in labels && posix_groups.exists(pg, pg.name=='POSIX_NAME')

POSIX_NAME을 POSIX 그룹에 지정하려는 이름으로 바꿉니다.

다음은 쿼리를 사용하는 GET 요청입니다.

GET "https://cloudidentity.googleapis.com/v1beta1/groups:search?query=parent=='customers/CUSTOMER_ID'%26%26'cloudidentity.googleapis.com/groups.posix'%20in%20labels%26%26posix_groups.exists(pg,pg.name=='POSIX_GROUP_NAME')&view=VIEW"

다음을 바꿉니다.

• CUSTOMER_ID: 조직의 고객 ID입니다. 고객 ID를 찾으려면 gcloud organizations list 명령어를 실행합니다.
• POSIX_NAME: POSIX 그룹에 할당할 이름입니다.
• VIEW: FULL 또는 BASIC입니다.

Python

다음 예시에서는 Python 클라이언트 라이브러리를 사용해서 POSIX 그룹 이름으로 POSIX 그룹을 검색하는 방법을 보여줍니다.

def get_posix_group_by_posix_name((service, customer_id, posix_group_name, page_size, view):
  # Set the label to search for a POSIX group
  searchQuery = ("&query=parent=='customers/{customer_id}' "
         "&& 'cloudidentity.googleapis.com/groups.posix' in labels "
         "&& posix_groups.exists(pg, pg.name=='{posix_group_name}')"
         "?pageSize={page_size}&view={view}".format(
             customer_id=customer_id, posix_group_name=posix_group_name,
             page_size=page_size, view=view))
  try:
    searchGroupsRequest = service.groups().search()
    searchGroupsRequest.uri += searchQuery
    response = searchGroupsRequest.execute()
    print response
  except Exception as e:
    print e

POSIX 그룹 ID로 POSIX 그룹 검색

다음 샘플은 그룹 ID를 사용하여 그룹 정보를 검색하는 방법을 보여줍니다.

REST

ID로 POSIX 그룹을 검색하려면 다음 쿼리 문자열을 사용해서 groups.search() 메서드를 호출합니다.

query=parent=='customers/CUSTOMER_ID' && 'cloudidentity.googleapis.com/groups.posix' in labels && posix_groups.exists(pg, pg.gid==GIDu)

다음을 바꿉니다.

• CUSTOMER_ID: 조직의 고객 ID입니다. 고객 ID를 찾으려면 gcloud organizations list 명령어를 실행합니다.
• GROUP_ID: POSIX 그룹에 할당할 그룹 ID(GID)입니다.

다음은 쿼리를 사용하는 GET 요청입니다.

GET "https://cloudidentity.googleapis.com/v1beta1/groups:search?query=parent=='customers/CUSTOMER_ID'%26%26'cloudidentity.googleapis.com/groups.posix'%20in%20labels%26%26posix_groups.exists(pg,pg.gid==GROUP_IDu)&view=VIEW"

다음을 바꿉니다.

• CUSTOMER_ID: 조직의 고객 ID입니다. 고객 ID를 찾으려면 gcloud organizations list 명령어를 실행합니다.
• GROUP_ID: POSIX 그룹에 할당할 그룹 ID(GID)입니다.
• VIEW: FULL 또는 BASIC입니다.

Python

다음 예시에서는 Python 클라이언트 라이브러리를 사용해서 그룹 ID로 POSIX 그룹을 검색하는 방법을 보여줍니다.

def get_posix_group_by_gid(service, customer_id, posix_group_id, page_size, view):
  # Set the label to search for a POSIX group
  searchQuery = ("&query=parent=='customers/{customer_id}' "
         "&& 'cloudidentity.googleapis.com/groups.posix' in labels "
         "&& posix_groups.exists(pg, pg.gid=={posix_group_id}u)"
         "?pageSize={page_size}&view={view}".format(
             customer_id=customer_id, posix_group_id=posix_group_id,
             page_size=page_size, view=view))
  try:
    searchGroupsRequest = service.groups().search()
    searchGroupsRequest.uri += searchQuery
    response = searchGroupsRequest.execute()
    print response
  except Exception as e:
    print e

이메일로 POSIX 그룹 검색

다음 샘플은 그룹 이메일을 사용하여 그룹 정보를 검색하는 방법을 보여줍니다.

gcloud

gcloud beta identity groups describe 명령어를 사용하여 조직의 모든 POSIX 그룹을 나열합니다.

gcloud beta identity groups describe EMAIL_ADDRESS

EMAIL_ADDRESS를 검색할 그룹의 이메일 주소로 바꿉니다.

REST

이메일로 POSIX 그룹을 검색하려면 다음을 수행합니다.

1. 그룹 이메일 주소를 사용하여 groups.lookup() 메서드를 호출합니다.

   GET "https://cloudidentity.googleapis.com/v1beta1/groups:lookup?groupKey.id=EMAIL_ADDRESS"
   

   반환되는 그룹의 리소스 이름을 확인합니다.

2. 그룹의 리소스 이름으로 groups.get() 메서드를 호출합니다.

   GET "https://cloudidentity.googleapis.com/v1beta1/groups/GROUP_RESOURCE_NAME"
   

Python

다음 예시에서는 Python 클라이언트 라이브러리를 사용하여 이메일로 POSIX 그룹을 검색하는 방법을 보여줍니다.

def get_posix_group_by_email(email):
  service = build_service()

  # First we use the email to get the groups name calling lookup()
  lookup_group_name_request = service.groups().lookup()
  param = "&groupKey.id=" + email
  lookup_group_name_request.uri += param
  lookup_group_name_response = lookup_group_name_request.execute()
  name = lookup_group_name_response.get("name")

  # Then we can call get() by passing in the group's name
  response = service.groups().get(name=name).execute()
  return response

POSIX 그룹 나열

다음 예시에서는 조직의 모든 POSIX 그룹을 나열하는 방법을 보여줍니다.

gcloud

gcloud identity groups search 명령어를 사용하여 조직의 모든 POSIX 그룹을 나열합니다.

gcloud identity groups search \
    --labels=cloudidentity.googleapis.com/groups.posix \
    --organization=ORGANIZATION

ORGANIZATION을 검색할 그룹의 조직 ID로 바꿉니다.

REST

모든 POSIX 그룹을 검색하려면 다음 쿼리 문자열을 사용해서 groups.search() 메서드를 호출합니다.

query=parent=='customers/CUSTOMER_ID' && 'cloudidentity.googleapis.com/groups.posix' in labels

CUSTOMER_ID를 조직의 고객 ID로 바꿉니다. 고객 ID를 찾으려면 gcloud organizations list 명령어를 실행합니다.

다음은 쿼리를 사용하는 GET 요청입니다.

GET "https://cloudidentity.googleapis.com/v1beta1/groups:search?query=parent=='customers/CUSTOMER_ID'%26%26'cloudidentity.googleapis.com/groups.posix'%20in%20labels&view=VIEW"

다음을 바꿉니다.

• CUSTOMER_ID: 조직의 고객 ID입니다. 고객 ID를 찾으려면 gcloud organizations list 명령어를 실행합니다.
• GROUP_ID: POSIX 그룹에 할당할 그룹 ID(GID)입니다.
• VIEW: FULL 또는 BASIC입니다.

Python

다음 예시에서는 Python 클라이언트 라이브러리를 사용하여 POSIX 그룹을 검색하기 위한 도우미 함수를 보여줍니다.

def search_posix_groups(service, customer_id, page_size, view):
  # Set the label to search for all POSIX groups
  searchQuery = ("&query=parent=='customers/{customer_id}' "
         "&& 'cloudidentity.googleapis.com/groups.posix' in labels "
         "?pageSize={page_size}&view={view}".format(
             customer_id=customer_id, page_size=page_size, view=view))
  try:
    searchGroupsRequest = service.groups().search()
    searchGroupsRequest.uri += searchQuery
    response = searchGroupsRequest.execute()
    print response
  except Exception as e:
    print e