אחזור ורישום של קבוצות POSIX

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

אחזור חברים בקבוצות POSIX

אפשר לאחזר את פרטי הקבוצה באמצעות שם הקבוצה ב-Google, שם הקבוצה ב-POSIX, מזהה הקבוצה ב-POSIX או כתובת האימייל.

אחזור קבוצת POSIX לפי שם הקבוצה

בדוגמה הבאה אפשר לראות איך מאחזרים קבוצת POSIX באמצעות שם הקבוצה:

REST

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

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

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

Python

בדוגמה הבאה מוצג איך לאחזר קבוצת POSIX לפי שם באמצעות ספריית הלקוח של Python:

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

Python

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

אחזור קבוצת POSIX לפי מזהה קבוצת POSIX

בדוגמה הבאה אפשר לראות איך מאחזרים מידע על קבוצה באמצעות מזהה הקבוצה:

REST

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

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

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

  • CUSTOMER_ID: מזהה הלקוח של הארגון. כדי למצוא את מספר הלקוח, מריצים את הפקודה gcloud organizations list.
  • GROUP_ID: מזהה הקבוצה (GID) שרוצים להקצות לקבוצת 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.gid==GROUP_IDu)&view=VIEW"

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

  • CUSTOMER_ID: מזהה הלקוח של הארגון. כדי למצוא את מספר הלקוח, מריצים את הפקודה gcloud organizations list.
  • GROUP_ID: מזהה הקבוצה (GID) שרוצים להקצות לקבוצת POSIX
  • VIEW: FULL או BASIC

Python

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

אחזור קבוצת POSIX לפי כתובת אימייל

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

gcloud

כדי להציג את כל קבוצות ה-POSIX בארגון, משתמשים בפקודה gcloud beta identity groups describe:

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

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

הצגת קבוצות POSIX

בדוגמאות הבאות מוסבר איך מציגים רשימה של כל קבוצות POSIX בארגון:

gcloud

כדי להציג את כל קבוצות ה-POSIX בארגון, משתמשים בפקודה gcloud identity groups search:

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

מחליפים את ORGANIZATION במזהה הארגון של הקבוצה שמחפשים.

REST

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

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

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

Python

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