Membuat dan menghapus grup POSIX

Dokumen ini menjelaskan cara membuat dan menghapus grup POSIX.

Sebelum memulai

Lakukan tugas berikut sebelum melanjutkan dengan informasi di halaman ini:

Membuat grup POSIX

Anda dapat membuat grup POSIX dari grup Google yang ada, atau dengan membuat grup Google baru dan menambahkan informasi POSIX.

Membuat grup POSIX dari grup Google yang ada

Contoh berikut menunjukkan cara membuat grup POSIX dari grup Google yang ada:

gcloud

Gunakan perintah gcloud beta identity groups update untuk memperbarui grup Google yang ada ke grup POSIX:

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

Ganti kode berikut:

  • EMAIL: alamat email grup yang akan diperbarui
  • GROUP_ID: ID grup (GID) yang ingin Anda tetapkan ke grup POSIX
  • POSIX_NAME: nama yang ingin Anda tetapkan ke grup POSIX

REST

Untuk memperbarui Google Grup ke grup POSIX, panggil metode groups.patch() dengan kolom grup POSIX yang ditentukan.

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

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

Ganti kode berikut:

  • GROUP_RESOURCE_NAME: nama resource grup Google. Untuk menemukan nama resource grup, jalankan perintah gcloud identity groups describe
  • POSIX_NAME: nama yang ingin Anda tetapkan ke grup POSIX
  • GROUP_ID: ID grup (GID) yang ingin Anda tetapkan ke grup POSIX

Python

Contoh berikut menunjukkan fungsi bantuan untuk mengupdate Google Grup ke grup POSIX menggunakan library klien Python:

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)

Membuat grup POSIX dari grup Google baru

Contoh berikut menunjukkan cara membuat grup POSIX dari grup Google baru:

gcloud

Gunakan perintah gcloud beta identity groups create untuk membuat grup 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

Ganti kode berikut:

  • EMAIL: alamat email grup yang akan dibuat
  • ORGANIZATION_ID: organisasi tempat grup berada. ID ("123456789") atau domain terkait ("example.com").
  • GROUP_ID: ID grup (GID) yang Anda tetapkan untuk grup
  • POSIX_NAME: nama yang Anda tetapkan untuk grup

REST

Untuk membuat grup, panggil metode groups.create() dengan alamat email, ID organisasi, grup POSIX, dan label untuk grup baru.

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,
  }
]
}

Ganti kode berikut:

  • initialGroupConfig=WITH_INITIAL_OWNER: ?initialGroupConfig=WITH_INITIAL_OWNER atau kosong. Setiap grup yang kosong hanya dapat dibuat oleh admin organisasi.
  • CUSTOMER_ID: ID pelanggan untuk organisasi Anda. Untuk menemukan ID pelanggan, jalankan perintah gcloud organizations list
  • EMAIL: alamat email grup yang akan dibuat
  • POSIX_NAME: nama yang ingin Anda tetapkan ke grup POSIX
  • GROUP_ID: ID grup (GID) yang ingin Anda tetapkan ke grup POSIX

Python

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

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

Menghapus grup POSIX

Contoh berikut menunjukkan cara menghapus informasi POSIX dari grup Google.

gcloud

Gunakan perintah gcloud beta identity groups update dan tentukan flag --remove-posix-groups dengan nilai GROUP_ID atau POSIX_NAME:

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

Ganti kode berikut:

  • EMAIL: alamat email grup yang akan dihapus
  • GROUP_ID_or_POSIX_NAME: ID grup atau nama grup POSIX dari grup yang akan dihapus

REST

Untuk memperbarui Google Grup ke grup POSIX, panggil metode groups.patch() dengan kolom grup POSIX yang ditentukan.

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

{
  "posixGroups": []
}

Ganti kode berikut:

Python

Contoh berikut menunjukkan fungsi bantuan untuk mengupdate Google Grup ke grup POSIX menggunakan library klien Python:

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)

Langkah selanjutnya

Setelah grup POSIX ada, Anda dapat mengambilnya dan mencantumkan keanggotaannya. Untuk mengetahui informasi selengkapnya, baca artikel Mengambil dan membuat daftar grup POSIX.