אחזור ורישום של קבוצות POSIX
במאמר הזה מוסבר איך לאחזר ולפרט קבוצות POSIX.
אחזור חברים בקבוצות POSIX
אפשר לאחזר את פרטי הקבוצה באמצעות שם הקבוצה ב-Google, שם הקבוצה ב-POSIX, מזהה הקבוצה ב-POSIX או כתובת האימייל.
אחזור קבוצת 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
בדוגמה הבאה מוצג איך לאחזר קבוצת 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 לפי אימייל:
מבצעים קריאה ל-
groups.lookup()עם כתובת אימייל קבוצתית:GET "https://cloudidentity.googleapis.com/v1beta1/groups:lookup?groupKey.id=EMAIL_ADDRESS"
שימו לב לשם המשאב של הקבוצה שמוחזר.
מבצעים קריאה ל-
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