Mengambil dan membuat daftar grup POSIX

Dokumen ini menjelaskan cara mengambil dan mencantumkan grup POSIX.

Pratinjau

Produk ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Catatan: Anda harus menggunakan versi beta Cloud Identity Groups API untuk mengambil dan mencantumkan grup POSIX.

Mengambil anggota grup POSIX

Anda dapat mengambil informasi grup menggunakan nama grup Google, nama grup POSIX, ID grup POSIX, atau email.

Mengambil grup POSIX berdasarkan nama grup

Contoh berikut menunjukkan cara mengambil grup POSIX menggunakan nama grup:

REST

Untuk mengambil grup POSIX berdasarkan nama, panggil metode groups.get() dengan nama resource grup.

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

Ganti kode berikut:

• GROUP_RESOURCE_NAME: nama resource grup Google. Untuk menemukan nama resource grup, jalankan perintah gcloud identity groups describe

Python

Contoh berikut menunjukkan cara mengambil grup POSIX berdasarkan nama menggunakan library klien Python:

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

Mengambil grup POSIX berdasarkan nama grup POSIX

Contoh berikut menunjukkan cara mengambil informasi grup dari nama grup POSIX:

REST

Untuk menelusuri grup POSIX berdasarkan nama grup POSIX, panggil metode groups.search() dengan string kueri berikut:

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

Ganti POSIX_NAME dengan nama yang ingin Anda tetapkan ke grup POSIX.

Berikut adalah permintaan GET yang menggunakan kueri:

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"

Ganti kode berikut:

• CUSTOMER_ID: ID pelanggan untuk organisasi Anda. Untuk menemukan ID pelanggan, jalankan perintah gcloud organizations list
• POSIX_NAME: nama yang ingin Anda tetapkan ke grup POSIX
• VIEW: FULL atau BASIC

Python

Contoh berikut menunjukkan cara mengambil grup POSIX berdasarkan nama grup POSIX menggunakan library klien Python:

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

Mengambil grup POSIX dengan ID grup POSIX

Contoh berikut menunjukkan cara mengambil informasi grup menggunakan ID grup:

REST

Untuk menelusuri grup POSIX berdasarkan ID, panggil metode groups.search() dengan string kueri berikut:

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

Ganti kode berikut:

• CUSTOMER_ID: ID pelanggan untuk organisasi Anda. Untuk menemukan ID pelanggan, jalankan perintah gcloud organizations list
• GROUP_ID: ID grup (GID) yang ingin Anda tetapkan ke grup POSIX

Berikut adalah permintaan GET yang menggunakan kueri:

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"

Ganti kode berikut:

• CUSTOMER_ID: ID pelanggan untuk organisasi Anda. Untuk menemukan ID pelanggan, jalankan perintah gcloud organizations list
• GROUP_ID: ID grup (GID) yang ingin Anda tetapkan ke grup POSIX
• VIEW: FULL atau BASIC

Python

Contoh berikut menunjukkan cara mengambil grup POSIX berdasarkan ID grup menggunakan library klien Python:

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

Mengambil grup POSIX melalui email

Contoh berikut menunjukkan cara mengambil informasi grup menggunakan email grup:

gcloud

Gunakan perintah gcloud beta identity groups describe untuk mencantumkan semua grup POSIX dalam organisasi:

gcloud beta identity groups describe EMAIL_ADDRESS

Ganti EMAIL_ADDRESS dengan alamat email grup yang sedang ditelusuri.

REST

Untuk mengambil grup POSIX melalui email, lakukan hal berikut:

1. Panggil metode groups.lookup() dengan alamat email grup:

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

   Perhatikan nama resource grup yang ditampilkan.

2. Panggil metode groups.get() dengan nama resource grup:

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

Python

Contoh berikut menunjukkan cara mengambil grup POSIX melalui email menggunakan library klien Python:

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

Mencantumkan grup POSIX

Contoh berikut menunjukkan cara menampilkan semua grup POSIX di organisasi Anda:

gcloud

Gunakan perintah gcloud identity groups search untuk mencantumkan semua grup POSIX dalam organisasi:

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

Ganti ORGANIZATION dengan ID organisasi untuk grup yang sedang ditelusuri.

REST

Untuk menelusuri semua grup POSIX, panggil metode groups.search() dengan string kueri berikut:

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

Ganti CUSTOMER_ID dengan ID pelanggan untuk organisasi Anda. Untuk menemukan ID pelanggan, jalankan perintah gcloud organizations list.

Berikut adalah permintaan GET yang menggunakan kueri:

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

Ganti kode berikut:

• CUSTOMER_ID: ID pelanggan untuk organisasi Anda. Untuk menemukan ID pelanggan, jalankan perintah gcloud organizations list
• GROUP_ID: ID grup (GID) yang ingin Anda tetapkan ke grup POSIX
• VIEW: FULL atau BASIC

Python

Contoh berikut menunjukkan fungsi bantuan untuk menelusuri grup POSIX menggunakan library klien Python:

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