מערכת גישה מאוחדת לכללי מדיניות (UAP) מאפשרת לכם לתת לחשבונות משתמשים גישה למשאבים ב-Google Cloud או לדחות את הגישה שלהם. במאמר הזה מוסבר איך ליצור ולהחיל כללי מדיניות גישה מאוחדת.
לפני שמתחילים
מגדירים אימות.
צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:
המסוף
כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים ולממשקי ה-API של Google Cloud , לא צריך להגדיר אימות.
gcloud
מפעילים את Cloud Shell במסוף Google Cloud .
בחלק התחתון של מסוף Google Cloud יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.
REST
כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.
התקינו את ה-CLI של Google Cloud.
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.
מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .
אופציונלי: קוראים את הסקירה הכללית של מדיניות הגישה המאוחדת.
התפקידים שנדרשים כדי ליצור כללי מדיניות של UAP
כדי לקבל את ההרשאות שנדרשות ליצירת מדיניות גישה מאוחדת, צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין של מדיניות גישה (roles/iam.accessPolicyAdmin) ב-IAM ברמת הפרויקט, התיקייה או הארגון שבהם רוצים ליצור את המדיניות.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
זהו תפקיד שמוגדר מראש וכולל את ההרשאות שנדרשות ליצירת כללי מדיניות גישה מאוחדת. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי ליצור כללי UAP, צריך את ההרשאות הבאות:
-
iam.accesspolicies.create -
יוצרים כללי UAP במסוף Google Cloud :
iam.accesspolicies.list
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
התפקידים שנדרשים כדי להחיל את מערכת הגישה המאוחדת לכללי מדיניות (UAP)
כדי לקבל את ההרשאות שדרושות לקישור של UAP למשאב, בקשו מהאדמין להקצות לכם את התפקידים הבאים ב-IAM:
- אדמין של מדיניות גישה (
roles/iam.accessPolicyAdmin) במשאב שבבעלות ה-UAP. התפקיד הזה כולל את ההרשאהiam.accesspolicies.bind, שנדרשת כדי ליצור קישורים. תפקיד שכולל את ההרשאה
SERVICE.RESOURCE.createPolicyBinding, כאשרRESOURCEהוא סוג המשאב שאליו רוצים לקשר את המדיניות ו-SERVICEהוא השירות שהמשאב נמצא בבעלותו.כדי למצוא תפקיד שכולל את ההרשאה הנדרשת, מחפשים את ההרשאה בחומר העזר בנושא תפקידים והרשאות, לוחצים על שם ההרשאה ובודקים את התפקידים שכוללים את ההרשאה.
אתם צריכים את התפקיד הזה במשאב או באחד מהאבות הקדמונים שלו.
להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יצירת מדיניות גישה מאוחדת (UAP)
אפשר ליצור UAP באמצעות Google Cloud המסוף, ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
המסוף
-
נכנסים לדף Unified Access Policies במסוף Google Cloud .
כניסה לדף Unified Access Policies - בוחרים את הפרויקט, התיקייה או הארגון שבהם רוצים ליצור את ה-UAP. איפה יוצרים מדיניות UAP?
- לוחצים על יצירת מדיניות.
-
בשדה Policy name, מזינים שם ל-UAP, לדוגמה
Example policy. השם יכול להכיל עד 63 תווים. - אופציונלי: בשדה Policy ID, מתאימים אישית את המזהה של ה-UAP.
-
מוסיפים כללים למדיניות. לכל כלל, מבצעים את הפעולות הבאות:
- אופציונלי: בשדה Description, מזינים תיאור לכלל.
- בשדה Principals, מזינים את חשבונות המשתמשים שרוצים לכלול בכלל.
- אופציונלי: בשדה Excluded principals, מזינים את חשבונות המשתמשים שלא רוצים לכלול בכלל. חשבונות המשתמשים האלה לא ייכללו, גם אם הם חלק מקבוצה בשדה Principals.
-
בוחרים את ההשפעה הרצויה של הכלל:
- כדי לתת את ההרשאות שצוינו לחשבונות המשתמשים שצוינו, בוחרים באפקט Allow.
- כדי למנוע מהחשבונות הראשיים שצוינו להשתמש בהרשאות שצוינו, בוחרים באפקט Deny.
-
בוחרים את ההרשאות שרוצים לכלול בכלל:
- בכללים עם ההשפעה Allow, אפשר לציין תפקידים והרשאות שייכללו בכלל או יוחרגו ממנו. מידע נוסף על התפקידים וההרשאות שאפשר לכלול מופיע במאמר תפקידים והרשאות בכללי UAP.
- בכללים עם האפקט Deny, מציינים את ההרשאות שרוצים לכלול בכלל או להחריג ממנו. במאמר תפקידים והרשאות בכללי UAP מוסבר אילו הרשאות אפשר לכלול.
-
אופציונלי: מוסיפים תנאים שבהם הכלל יחול. מידע נוסף על מאפייני התנאים הנתמכים מופיע במאמר תנאים ב-UAP.
- כשמסיימים לערוך את הכלל, לוחצים על סיום.
- כדי להוסיף עוד כלל, לוחצים על הוספת כלל ומוסיפים את פרטי הכלל.
- כשמסיימים להוסיף כללים, לוחצים על יצירת מדיניות.
gcloud
הפקודה
gcloud iam access-policies create
יוצרת UAP.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
UAP_ID: מזהה ייחודי של ה-UAP, לדוגמהexample-policy. -
UAP_PARENT_RESOURCE_TYPE: סוג המשאב ב-Resource Manager (פרויקט, תיקייה או ארגון) שבו רוצים ליצור את ה-UAP. אפשר להשתמש בערךproject,folderאוorganization. -
UAP_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שבהם רוצים ליצור את ה-UAP. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
DISPLAY_NAME: אופציונלי. תיאור קריא לאנשים של ה-UAP, לדוגמהExample policy. השם המוצג יכול להכיל עד 63 תווים. -
FILE_PATH: הנתיב לקובץ JSON שמכיל את פרטי הכלל של ה-UAP. כל כלל צריך להיות בפורמט הבא:{ "description": "DESCRIPTION", "effect": "EFFECT", "principals": [ INCLUDED_PRINCIPALS ], "excludedPrincipals": [ EXCLUDED_PRINCIPALS ], "operation": { "permissions": [ INCLUDED_PERMISSIONS ], "excludedPermissions": [ EXCLUDED_PERMISSIONS ] }, CONDITIONS }
מחליפים את הערכים הבאים:
-
DESCRIPTION: תיאור קריא לאנשים של הכלל. -
EFFECT: איך הכלל משפיע על הגישה. הערכים הנתמכים הםALLOWו-DENY:-
ALLOW: הענקת ההרשאות שצוינו לחשבונות המשתמשים שצוינו. -
DENY: מניעה מחשבונות המשתמשים שצוינו להשתמש בהרשאות שצוינו.
-
-
מחליפים את הערכים הבאים כדי לציין את חשבונות המשתמשים שכלולים בכלל:
-
INCLUDED_PRINCIPALS: חשבונות המשתמשים שייכללו בכלל. -
EXCLUDED_PRINCIPALS: אופציונלי. חשבונות המשתמשים שיוחרגו מהכלל, גם אם הם מופיעים ברשימת חשבונות המשתמשים שנכללים. לדוגמה, אפשר להוסיף קבוצה ב-Google לרשימת חשבונות המשתמשים שנכללים, ואז להחריג משתמשים ספציפיים ששייכים לקבוצה הזו.
רשימת המזהים הנתמכים של חשבונות משתמשים מופיעה במאמר סוגי חשבונות משתמשים ל-UAP.
-
-
מחליפים את הערכים הבאים כדי לציין את ההרשאות שרוצים לכלול בכלל:
-
INCLUDED_PERMISSIONS: ההרשאות שיהיו בכלל. -
EXCLUDED_PERMISSIONS: אופציונלי. ההרשאות שרוצים להחריג מהכלל, גם אם הן מופיעות ברשימת ההרשאות שנכללות. לדוגמה, אפשר להוסיף תפקיד לרשימת ההרשאות הכלולות, ואז להחריג הרשאות ספציפיות בתפקיד הזה.
כשיוצרים את רשימות ההרשאות האלה, אפשר להפנות לשמות של הרשאות, לשמות של תפקידים ולקבוצות של הרשאות. מידע נוסף על תפקידים והרשאות בכללי UAP
-
-
CONDITIONS: אופציונלי. התנאים שבהם הכלל חל. צריך להשתמש בפורמט הבא:"conditions": { "SERVICE": { "title": "CONDITION_TITLE", "description": "CONDITION_DESCRIPTION", "expression": "CONDITION_EXPRESSION" } }
מחליפים את הערכים הבאים:
-
SERVICE: השירות שמספק את המאפיינים שבהם משתמשים בביטוי התנאי. -
CONDITION_TITLE: אופציונלי. סיכום קצר של מטרת התנאי. -
CONDITION_DESCRIPTION: אופציונלי. תיאור ארוך יותר של התנאי. -
CONDITION_EXPRESSION: ביטוי בוליאני שמפנה למאפיינים של ניסיון הגישה, כמו התגים שמצורפים למשאב בניסיון הגישה. אם הביטוי מקבל את הערךtrue, הכלל חל על ניסיון הגישה. אם תוצאת הבדיקה של התנאי היאfalse, הכלל לא חל על ניסיון הגישה.
במאמר מאפייני תנאים נתמכים תוכלו למצוא רשימה של המאפיינים הנתמכים והשירותים שלהם.
-
-
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam access-policies create UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \ --location=global --display-name=DISPLAY_NAME \ --details-rules=FILE_PATH
Windows (PowerShell)
gcloud iam access-policies create UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ` --location=global --display-name=DISPLAY_NAME ` --details-rules=FILE_PATH
Windows (cmd.exe)
gcloud iam access-policies create UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^ --location=global --display-name=DISPLAY_NAME ^ --details-rules=FILE_PATH
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. כדי ללמוד איך לקבל את הסטטוס של פעולה ממושכת, אפשר לעיין בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.
Create request issued for: [example-policy] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715373988044-6181fa136df85-3b06a30a-4816d25b] to complete...done. Created accessPolicy [example-policy].
REST
השיטה accessPolicies.create יוצרת מדיניות UAP.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
UAP_PARENT_RESOURCE_TYPE: סוג המשאב ב-Resource Manager (פרויקט, תיקייה או ארגון) שבו רוצים ליצור את ה-UAP. אפשר להשתמש בערךprojects,foldersאוorganizations. -
UAP_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שבהם רוצים ליצור את ה-UAP. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
UAP_ID: מזהה ייחודי של ה-UAP, לדוגמהexample-policy. -
DISPLAY_NAME: אופציונלי. תיאור קריא לאנשים של ה-UAP, לדוגמהExample policy. השם המוצג יכול להכיל עד 63 תווים. -
UAP_RULES: רשימה של כללי UAP שמגדירים את הגישה שצריך לתת או לדחות, ואת חשבונות המשתמשים שצריך לתת להם גישה או לדחות את הגישה שלהם. בכל UAP יכולים להיות עד 100 כללים. כל כלל הוא בפורמט הבא:{ "description": "DESCRIPTION", "effect": "EFFECT", "principals": [ INCLUDED_PRINCIPALS ], "excludedPrincipals": [ EXCLUDED_PRINCIPALS ], "operation": { "permissions": [ INCLUDED_PERMISSIONS ], "excludedPermissions": [ EXCLUDED_PERMISSIONS ] }, CONDITIONS }
מחליפים את הערכים הבאים:
-
DESCRIPTION: תיאור קריא לאנשים של הכלל. -
EFFECT: איך הכלל משפיע על הגישה. הערכים הנתמכים הםALLOWו-DENY:-
ALLOW: הענקת ההרשאות שצוינו לחשבונות המשתמשים שצוינו. -
DENY: מניעה מחשבונות המשתמשים שצוינו להשתמש בהרשאות שצוינו.
-
-
מחליפים את הערכים הבאים כדי לציין את חשבונות המשתמשים שכלולים בכלל:
-
INCLUDED_PRINCIPALS: חשבונות המשתמשים שייכללו בכלל. -
EXCLUDED_PRINCIPALS: אופציונלי. חשבונות המשתמשים שיוחרגו מהכלל, גם אם הם מופיעים ברשימת חשבונות המשתמשים שנכללים. לדוגמה, אפשר להוסיף קבוצה ב-Google לרשימת חשבונות המשתמשים שנכללים, ואז להחריג משתמשים ספציפיים ששייכים לקבוצה הזו.
רשימת המזהים הנתמכים של חשבונות משתמשים מופיעה במאמר סוגי חשבונות משתמשים ל-UAP.
-
-
מחליפים את הערכים הבאים כדי לציין את ההרשאות שרוצים לכלול בכלל:
-
INCLUDED_PERMISSIONS: ההרשאות שיהיו בכלל. -
EXCLUDED_PERMISSIONS: אופציונלי. ההרשאות שרוצים להחריג מהכלל, גם אם הן מופיעות ברשימת ההרשאות שנכללות. לדוגמה, אפשר להוסיף תפקיד לרשימת ההרשאות הכלולות, ואז להחריג הרשאות ספציפיות בתפקיד הזה.
כשיוצרים את רשימות ההרשאות האלה, אפשר להפנות לשמות של הרשאות, לשמות של תפקידים ולקבוצות של הרשאות. מידע נוסף זמין במאמר תפקידים והרשאות בכללי UAP.
-
-
CONDITIONS: אופציונלי. התנאים שבהם הכלל חל. צריך להשתמש בפורמט הבא:"conditions": { "SERVICE": { "title": "CONDITION_TITLE", "description": "CONDITION_DESCRIPTION", "expression": "CONDITION_EXPRESSION" } }
מחליפים את הערכים הבאים:
-
SERVICE: השירות שמספק את המאפיינים שבהם משתמשים בביטוי התנאי. -
CONDITION_TITLE: אופציונלי. סיכום קצר של מטרת התנאי. -
CONDITION_DESCRIPTION: אופציונלי. תיאור ארוך יותר של התנאי. -
CONDITION_EXPRESSION: ביטוי בוליאני שמפנה למאפיינים של ניסיון הגישה, כמו התגים שמצורפים למשאב בניסיון הגישה. אם הערך של הביטוי הואtrue, הכלל חל על ניסיון הגישה. אם תוצאת הבדיקה של התנאי היאfalse, הכלל לא חל על ניסיון הגישה.
במאמר מאפייני תנאים נתמכים תוכלו למצוא רשימה של המאפיינים הנתמכים והשירותים שלהם.
-
-
ה-method של ה-HTTP וכתובת ה-URL:
POST https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies?accessPolicyId=UAP_ID
תוכן בקשת JSON:
{
"displayName": "DISPLAY_NAME",
"details": {
"rules": [
UAP_RULES
]
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. כדי ללמוד איך לקבל את הסטטוס של פעולה ממושכת, אפשר לעיין בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:32:00.898809495Z",
"target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
החלת מערכת גישה מאוחדת לכללי מדיניות (UAP) על משאב
כדי להחיל מדיניות UAP על משאב, צריך ליצור קישור. אחרי שיוצרים קישור למדיניות, הכללים במדיניות הזו חלים על המשאב שצוין ועל כל הצאצאים של המשאב הזה.
לפני שיוצרים קישור, צריך לוודא שאילוץ מדיניות הארגון iam.managed.disableAccessPolicyBinding מושבת. במאמר שימוש באילוצים מנוהלים במדיניות הארגון מוסבר איך להפעיל או להשבית את האילוץ הזה.
אפשר להחיל את מדיניות ה-UAP על פרויקטים, תיקיות וארגונים באמצעות מסוף Google Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM. כדי להחיל את מדיניות ה-UAP על משאבים אחרים, צריך להשתמש ב-CLI של gcloud או ב-API בארכיטקטורת REST של IAM.
המסוף
-
נכנסים לדף Unified Access Policies במסוף Google Cloud .
כניסה לדף Unified Access Policies - בוחרים את הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שרוצים להחיל.
- לוחצים על המזהה של ה-UAP שרוצים להחיל.
- בוחרים בכרטיסייה Bindings ולוחצים על Add binding.
-
בחלונית Add binding, עורכים את פרטי הקישור:
- בתפריט Binding location, בוחרים את המשאב שעליו רוצים להחיל את ה-UAP.
-
אופציונלי: בשדה Binding display name, מזינים תיאור קריא לאנשים של הקישור, לדוגמה
Example binding. השם המוצג יכול להכיל עד 63 תווים. -
בשדה Binding ID, מזינים שם ייחודי לקישור, לדוגמה
example-binding.
- לוחצים על Add binding.
gcloud
הפקודה
gcloud iam policy-bindings create
יוצרת קישור.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
BINDING_ID: שם ייחודי לקישור, לדוגמהexample-binding. -
BINDING_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שהקישור הוא צאצא שלו. אפשר להשתמש בערךproject,folderאוorganization.משאב ההורה של הקישור תלוי במשאב היעד בקישור. למידע נוסף, קראו את המאמר משאבים נתמכים.
-
BINDING_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
POLICY_PARENT_RESOURCE: המשאב שבו נוצרה ה-UAP, בפורמטRESOURCE_TYPE/RESOURCE_ID. לדוגמה:organizations/0123456789012. אפשר ליצור כללי UAP בפרויקטים, בתיקיות או בארגונים. מזהי תיקיות ומזהי ארגונים חייבים להיות מספריים. מזהי פרויקטים יכולים להיות מספריים או אלפאנומריים. -
UAP_ID: המזהה של ה-UAP שרוצים לקשר למשאב, לדוגמהexample-uap. אי אפשר לשנות את הערך הזה אחרי שיוצרים את הקישור. -
TARGET_RESOURCE: המשאב שאליו רוצים לקשר את ה-UAP. רשימה של משאבים תקינים מופיעה בקטע משאבים נתמכים. אי אפשר לשנות את הערך הזה אחרי שיוצרים את הקישור. -
DISPLAY_NAME: אופציונלי. תיאור קריא לאנשים של הקישור, למשלExample binding. השם המוצג יכול להכיל עד 63 תווים.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam policy-bindings create BINDING_ID \ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global \ --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" \ --target-resource=TARGET_RESOURCE \ --display-name=DISPLAY_NAME
Windows (PowerShell)
gcloud iam policy-bindings create BINDING_ID ` --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global ` --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" ` --target-resource=TARGET_RESOURCE ` --display-name=DISPLAY_NAME
Windows (cmd.exe)
gcloud iam policy-bindings create BINDING_ID ^ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global ^ --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" ^ --target-resource=TARGET_RESOURCE ^ --display-name=DISPLAY_NAME
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. כדי ללמוד איך לקבל את הסטטוס של פעולה ממושכת, אפשר לעיין בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.
Create request issued for: [example-binding] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374545618-6181fc272c6f9-55ff07f4-97d0ac76] to complete...done. Created policyBinding [example-binding].
REST
ה-method policyBindings.create יוצרת קישור.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
BINDING_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שהקישור הוא צאצא שלו. אפשר להשתמש בערךprojects,foldersאוorganizations.משאב ההורה של הקישור תלוי במשאב היעד בקישור. למידע נוסף, קראו את המאמר משאבים נתמכים.
-
BINDING_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
BINDING_ID: שם ייחודי לקישור, לדוגמהexample-binding. -
DISPLAY_NAME: אופציונלי. תיאור קריא לאנשים של הקישור, למשלExample binding. השם המוצג יכול להכיל עד 63 תווים. -
TARGET_RESOURCE: המשאב שאליו רוצים לקשר את ה-UAP. רשימה של משאבים תקינים מופיעה בקטע משאבים נתמכים. אי אפשר לשנות את הערך הזה אחרי שיוצרים את הקישור. -
POLICY_PARENT_RESOURCE: המשאב שבו נוצרה ה-UAP, בפורמטRESOURCE_TYPE/RESOURCE_ID. לדוגמה:organizations/0123456789012. אפשר ליצור כללי UAP בפרויקטים, בתיקיות או בארגונים. מזהי תיקיות ומזהי ארגונים חייבים להיות מספריים. מזהי פרויקטים יכולים להיות מספריים או אלפאנומריים. -
UAP_ID: המזהה של ה-UAP שרוצים לקשר למשאב, לדוגמהexample-uap. אי אפשר לשנות את הערך הזה אחרי שיוצרים את הקישור.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings?policyBindingId=BINDING_ID
תוכן בקשת JSON:
{
"displayName": "DISPLAY_NAME",
"target": {
"resource": "TARGET_RESOURCE"
},
"policyKind": "ACCESS",
"policy": "POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID"
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. כדי ללמוד איך לקבל את הסטטוס של פעולה ממושכת, אפשר לעיין בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:32:00.898809495Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-binding",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
בדיקת הסטטוס של פעולה ממושכת
כשמשתמשים ב-API בארכיטקטורת REST או בספריות הלקוח, כל שיטה שמשנה מדיניות או קישור מחזירה פעולה ממושכת (LRO). הפעולה הממושכת עוקבת אחרי הסטטוס של הבקשה ומציינת אם השינוי במדיניות או בקישור הושלם.
REST
השיטה
operations.get
מחזירה את הסטטוס של פעולה ממושכת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
OPERATION_NAME: השם המלא של הפעולה. השם הזה מופיע בתגובה לבקשה המקורית.הפורמט של שם הפעולה הוא:
RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
ה-method של ה-HTTP וכתובת ה-URL:
GET https://iam.googleapis.com/v3/OPERATION_NAME
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-11-28T00:05:12.006289686Z",
"endTime": "2024-11-28T00:05:12.192141801Z",
"target": "organizations/314340013352/locations/global/POLICY_TYPE/POLICY_ID",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": true,
"response": {
POLICY
}
}
אם השדה done של הפעולה לא מופיע, אפשר לבצע את הפעולה שוב ושוב כדי להמשיך לעקוב אחר הסטטוס שלה. צריך להשתמש בהשהיה מעריכית (exponential backoff) קטועה לפני ניסיון חוזר כדי ליצור עיכוב בין כל בקשה. כשהערך של השדה done מוגדר בתור true, הפעולה הושלמה ואפשר להפסיק לבצע אותה.