יצירה ומחיקה של קבוצות POSIX

במאמר הזה נסביר איך ליצור ולמחוק קבוצת POSIX.

לפני שמתחילים

לפני שממשיכים לקרוא את המידע בדף הזה, צריך לבצע את המשימות הבאות:

יצירת קבוצת POSIX

אפשר ליצור קבוצת POSIX מקבוצת Google קיימת, או ליצור קבוצת Google חדשה ולהוסיף לה פרטי POSIX.

יצירת קבוצת POSIX מקבוצת Google קיימת

בדוגמאות הבאות מוסבר איך ליצור קבוצת POSIX מקבוצת Google קיימת:

gcloud

כדי לעדכן קבוצת Google קיימת לקבוצת POSIX, משתמשים בפקודה gcloud beta identity groups update:

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

מחליפים את מה שכתוב בשדות הבאים:

  • EMAIL: כתובת האימייל של הקבוצה שרוצים לעדכן
  • ‫GROUP_ID: מזהה הקבוצה (GID) שרוצים להקצות לקבוצת POSIX
  • ‫POSIX_NAME: השם שרוצים להקצות לקבוצת POSIX

REST

כדי לעדכן קבוצה בקבוצות Google לקבוצת POSIX, צריך לבצע קריאה לשיטה groups.patch() עם שדה קבוצות POSIX מוגדר.

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: מזהה הקבוצה (GID) שרוצים להקצות לקבוצת POSIX

Python

בדוגמה הבאה מוצגת פונקציית עזר לעדכון קבוצת Google לקבוצת POSIX באמצעות ספריית הלקוח של 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)

יצירת קבוצת POSIX מקבוצת Google חדשה

בדוגמאות הבאות מוסבר איך ליצור קבוצת POSIX מקבוצת Google חדשה:

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: הארגון שאליו הקבוצה משתייכת. מזהה ("123456789") או הדומיין המשויך ("example.com").
  • ‫GROUP_ID: מזהה הקבוצה (GID) שהגדרתם לקבוצה
  • ‫POSIX_NAME: השם שהגדרתם לקבוצה

REST

כדי ליצור קבוצה, קוראים לשיטה groups.create() עם כתובת האימייל, מזהה הארגון, קבוצות POSIX והתוויות של הקבוצה החדשה.

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: מזהה הלקוח של הארגון. כדי למצוא את מספר הלקוח, מריצים את הפקודה gcloud organizations list.
  • EMAIL: כתובת האימייל של הקבוצה שרוצים ליצור
  • ‫POSIX_NAME: השם שרוצים להקצות לקבוצת POSIX
  • ‫GROUP_ID: מזהה הקבוצה (GID) שרוצים להקצות לקבוצת POSIX

Python

בדוגמה הבאה מוצגת פונקציית עזר ליצירת קבוצת POSIX באמצעות ספריית הלקוח של 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

מחיקה של קבוצת POSIX

בדוגמאות הבאות מוסבר איך להסיר מידע POSIX מקבוצת Google.

gcloud

משתמשים בפקודה gcloud beta identity groups update ומציינים את הדגל --remove-posix-groups עם הערך GROUP_ID או POSIX_NAME:

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

מחליפים את מה שכתוב בשדות הבאים:

  • EMAIL: כתובת האימייל של הקבוצה שרוצים למחוק
  • ‫GROUP_ID_or_POSIX_NAME: מזהה הקבוצה או שם הקבוצה ב-POSIX שרוצים למחוק

REST

כדי לעדכן קבוצה בקבוצות Google לקבוצת POSIX, צריך לבצע קריאה לשיטה groups.patch() עם שדה קבוצות POSIX מוגדר.

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

{
  "posixGroups": []
}

מחליפים את מה שכתוב בשדות הבאים:

Python

בדוגמה הבאה מוצגת פונקציית עזר לעדכון קבוצת Google לקבוצת POSIX באמצעות ספריית הלקוח של 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)

המאמרים הבאים

אחרי שקבוצת ה-POSIX קיימת, אפשר לאחזר אותה ולראות את החברים בה. מידע נוסף זמין במאמר בנושא אחזור ורישום של קבוצות POSIX.