מערכת גישה מאוחדת לכללי מדיניות (UAP) מאפשרת לכם לתת לחשבונות משתמשים גישה למשאבים ב-Google Cloud או לדחות את הגישה שלהם. במאמר הזה מוסבר איך לצפות בכללי מדיניות ה-UAP ובקישורים.
לפני שמתחילים
מגדירים אימות.
צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:
המסוף
כשמשתמשים במסוף 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)
כדי לקבל את ההרשאות שדרושות לצפייה ב-UAP, בקשו מהאדמין להעניק לכם את התפקיד צפייה במדיניות הגישה (roles/iam.accessPolicyViewer) ב-IAM ברמת הפרויקט, התיקייה או הארגון שבבעלותם נמצא ה-UAP שאתם רוצים לראות.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
זהו תפקיד מוגדר מראש שכולל את ההרשאות שנדרשות כדי לצפות במדיניות הגישה המאוחדת. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי לצפות בכללי מדיניות ה-UAP, נדרשות ההרשאות הבאות:
-
iam.accesspolicies.get -
iam.accessPolicies.list
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
התפקידים שנדרשים כדי לצפות בקישורים של מערכת גישה מאוחדת לכללי מדיניות (UAP)
כדי לקבל את ההרשאות שדרושות לצפייה בקישורים, בקשו מהאדמין לתת לכם את התפקידים הבאים ב-IAM במשאב ההורה של הקישורים:
-
הצגת קישורים בפרויקט:
אדמין IAM של פרויקט (
roles/resourcemanager.projectIamAdmin) -
צפייה בקישורים בתיקייה:
אדמין IAM של תיקייה (
roles/resourcemanager.folderIamAdmin) -
הצגת קישורים בארגון: Organization Administrator (
roles/resourcemanager.organizationAdmin)
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות כדי לצפות בקישורים. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי לראות את הקישורים, צריך את ההרשאות הבאות:
-
הצגת קישור יחיד:
iam.policybindings.get -
הצגת רשימה של קישורים שההורה שלהם הוא פרויקט, תיקייה או ארגון:
iam.policybindings.list
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
התפקידים שנדרשים כדי לראות את כל הקישורים של מערכת גישה מאוחדת לכללי מדיניות (UAP)
כדי לקבל את ההרשאה שדרושה לצפייה בכל הקישורים של מדיניות בקרת גישה מאוחדת (UAP), בקשו מהאדמין לתת לכם את התפקיד צפייה במדיניות הגישה (roles/iam.accessPolicyViewer) ב-IAM במשאב שבבעלותו נמצאת מדיניות ה-UAP.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקיד המוגדר מראש הזה כולל את ההרשאה iam.accesspolicies.searchPolicyBindings, שנדרשת כדי לראות את כל הקישורים של UAP.
יכול להיות שתוכלו לקבל את ההרשאה הזו גם בתפקידים בהתאמה אישית או בתפקידים מוגדרים מראש.
תפקידים שמאפשרים לראות את כל הקישורים של משאב מסוים
כדי לקבל את ההרשאות שנדרשות כדי לראות את כל הקישורים שכוללים משאב המטרה ספציפי, בקשו מהאדמין להקצות לכם תפקיד שמאפשר לכם להציג את רשימת הקישורים של אותו משאב. התפקיד חייב לכלול את ההרשאה SERVICE.RESOURCE.searchPolicyBindings, כאשר RESOURCE הוא סוג משאב המטרה ו-SERVICE הוא השירות שהמשאב נמצא בבעלותו.
כדי למצוא תפקיד שכולל את ההרשאה הנדרשת, מחפשים את ההרשאה בחומר העזר בנושא תפקידים והרשאות, לוחצים על שם ההרשאה ובודקים את התפקידים שכוללים את ההרשאה.
אתם צריכים את התפקיד הזה במשאב המטרה או באחד מהאבות הקדמונים שלו.
להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
הצגת רשימה של כללי מדיניות ה-UAP בפרויקט, בתיקייה או בארגון
אפשר להציג את כל מדיניות ה-UAP ששייכת לפרויקט, לתיקייה או לארגון ספציפיים באמצעות מסוף Google Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
המסוף
-
נכנסים לדף Unified Access Policies במסוף Google Cloud .
כניסה לדף Unified Access Policies - בוחרים את הפרויקט, התיקייה או הארגון שבבעלותם נמצאות כללי מדיניות ה-UAP שרוצים לראות.
במסוף Google Cloud מוצגות כללי מדיניות ה-UAP שמשויכים למשאב שבחרתם או מקושרים אליו.
gcloud
הפקודה gcloud iam access-policies list מציגה את כל כללי ה-UAP שהם צאצאים של משאב מסוים.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
UAP_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שבבעלותו נמצאות מדיניות ה-UAP שרוצים להציג. אפשר להשתמש בערךproject,folderאוorganization. -
UAP_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שבבעלותם נמצאות מדיניות ה-UAP שרוצים להציג ברשימה. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
FORMAT: הפורמט של התשובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam access-policies list --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \ --location=global --format=FORMAT
Windows (PowerShell)
gcloud iam access-policies list --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ` --location=global --format=FORMAT
Windows (cmd.exe)
gcloud iam access-policies list --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^ --location=global --format=FORMAT
התשובה מכילה את כללי ה-UAP שהם צאצאים של המשאב בבקשה.
{
"accessPolicies": [
{
"createTime": "2026-08-31T21:43:39.822441Z",
"details": {
"rules": [
{
"conditions": {
"iam.googleapis.com": {
"expression": "resource.matchTag('environment', 'prod')"
}
},
"description": "Grant non-delete compute permissions to compute admins in prod",
"effect": "ALLOW",
"excludedPrincipals": [
"principal://goog/subject/access-restricted@example.com"
],
"operation": {
"excludedPermissions": [
"*/*.delete"
],
"permissions": [
"role:roles/compute.admin"
]
},
"principals": [
"principalSet://goog/group/compute-admins@example.com"
]
}
]
},
"displayName": "Example policy 1",
"etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
"name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
"uid": "puid_0123456789012345678",
"updateTime": "2026-08-31T21:43:39.822441Z"
},
{
"createTime": "2026-05-29T23:25:01.606730Z",
"details": {
"rules": [
{
"description": "Deny group from publishing to message buses",
"effect": "DENY",
"operation": {
"permissions": [
"eventarc.googleapis.com/messageBuses.publish"
]
},
"principals": [
"principalSet://goog/group/example-group@example.com"
]
}
]
},
"displayName": "Example policy 2",
"etag": "d6BJBTsk2+oDCygmr5ANxA==",
"name": "organizations/123456789012/locations/global/accessPolicies/example-policy-2",
"uid": "puid_13064942519001808897",
"updateTime": "2026-05-29T23:25:01.606730Z"
}
]
}
REST
ה-method accessPolicies.list מציגה רשימה של כל כללי ה-UAP שהם צאצאים של משאב מסוים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
UAP_PARENT_RESOURCE_TYPE: סוג המשאב ב-Resource Manager (פרויקט, תיקייה או ארגון) שבבעלותו נמצאות מדיניות ה-UAP שרוצים להציג. אפשר להשתמש בערךprojects,foldersאוorganizations. -
UAP_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שבבעלותם נמצאות מדיניות ה-UAP שרוצים להציג ברשימה. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה את כללי ה-UAP שהם צאצאים של המשאב בבקשה.
{
"accessPolicies": [
{
"name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
"uid": "puid_0123456789012345678",
"etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
"displayName": "Example policy",
"createTime": "2026-08-31T21:43:39.822441Z",
"updateTime": "2026-08-31T21:43:39.822441Z",
"details": {
"rules": [
{
"principals": [
"principalSet://goog/group/compute-admins@example.com"
],
"excludedPrincipals": [
"principal://goog/subject/access-restricted@example.com"
],
"operation": {
"permissions": [
"role:roles/compute.admin"
],
"excludedPermissions": [
"*/*.delete"
]
},
"conditions": {
"iam.googleapis.com": {
"expression": "resource.matchTag('environment', 'prod')"
}
},
"description": "Grant non-delete compute permissions to compute admins in prod",
"effect": "ALLOW"
}
]
}
},
{
"name": "organizations/123456789012/locations/global/accessPolicies/example-policy-2",
"uid": "puid_13064942519001808897",
"etag": "d6BJBTsk2+oDCygmr5ANxA==",
"displayName": "Example policy 2",
"createTime": "2026-05-29T23:25:01.606730Z",
"updateTime": "2026-05-29T23:25:01.606730Z",
"details": {
"rules": [
{
"description": "Deny group from publishing to message buses",
"principals": [
"principalSet://goog/group/example-group@example.com"
],
"operation": {
"permissions": [
"eventarc.googleapis.com/messageBuses.publish"
]
},
"effect": "DENY"
}
]
}
}
]
}
קבלת מערכת גישה מאוחדת לכללי מדיניות (UAP) אחת
אפשר לקבל את הפרטים של מדיניות UAP אחת באמצעות מסוףGoogle Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
המסוף
-
נכנסים לדף Unified Access Policies במסוף Google Cloud .
כניסה לדף Unified Access Policies - בוחרים את הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שאת הפרטים שלה רוצים לראות.
- לוחצים על מזהה המדיניות של ה-UAP שרוצים לראות את הפרטים שלו.
במסוף Google Cloud מופיעים פרטי ה-UAP, כולל המזהה, זמן היצירה, זמן העדכון האחרון ורשימת הכללים.
gcloud
הפקודה gcloud iam access-policies describe מקבלת UAP אחד.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
UAP_ID: המזהה של ה-UAP שרוצים לקבל, לדוגמהexample-policy. -
UAP_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שבבעלותו נמצאת מדיניות ה-UAP שרוצים לקבל. אפשר להשתמש בערךproject,folderאוorganization. -
UAP_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שרוצים לקבל. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
FORMAT: הפורמט של התשובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam access-policies describe UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \ --location=global --format=FORMAT
Windows (PowerShell)
gcloud iam access-policies describe UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ` --location=global --format=FORMAT
Windows (cmd.exe)
gcloud iam access-policies describe UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^ --location=global --format=FORMAT
התשובה מכילה את ה-UAP שצוין בבקשה.
{
"createTime": "2026-08-31T21:43:39.822441Z",
"details": {
"rules": [
{
"conditions": {
"iam.googleapis.com": {
"expression": "resource.matchTag('environment', 'prod')"
}
},
"description": "Grant non-delete compute permissions to compute admins in prod",
"effect": "ALLOW",
"excludedPrincipals": [
"principal://goog/subject/access-restricted@example.com"
],
"operation": {
"excludedPermissions": [
"*/*.delete"
],
"permissions": [
"role:roles/compute.admin"
]
},
"principals": [
"principalSet://goog/group/compute-admins@example.com"
]
}
]
},
"displayName": "Example policy",
"etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
"name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
"uid": "puid_0123456789012345678",
"updateTime": "2026-08-31T21:43:39.822441Z"
}
REST
השיטה accessPolicies.get מקבלת מדיניות UAP אחת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
UAP_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שבבעלותו נמצאת ה-UAP שרוצים לקבל. אפשר להשתמש בערךprojects,foldersאוorganizations. -
UAP_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שרוצים לקבל. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
UAP_ID: המזהה של ה-UAP שרוצים לקבל, לדוגמהexample-policy.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה את ה-UAP שצוין בבקשה.
{
"name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
"uid": "puid_0123456789012345678",
"etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
"displayName": "Example policy",
"createTime": "2026-08-31T21:43:39.822441Z",
"updateTime": "2026-08-31T21:43:39.822441Z",
"details": {
"rules": [
{
"principals": [
"principalSet://goog/group/compute-admins@example.com"
],
"excludedPrincipals": [
"principal://goog/subject/access-restricted@example.com"
],
"operation": {
"permissions": [
"role:roles/compute.admin"
],
"excludedPermissions": [
"*/*.delete"
]
},
"conditions": {
"iam.googleapis.com": {
"expression": "resource.matchTag('environment', 'prod')"
}
},
"description": "Grant non-delete compute permissions to compute admins in prod",
"effect": "ALLOW"
}
]
}
}
הצגת רשימת הקישורים של מערכת גישה מאוחדת לכללי מדיניות (UAP)
יש כמה דרכים להציג את הקישורים של כללי מדיניות הגישה המאוחדת:
- הצגת רשימת הקישורים של UAP: הצגת כל הקישורים שכוללים UAP ספציפי.
- הצגת רשימת הקישורים של משאב: הצגת כל הקישורים שכוללים משאב המטרה ספציפי.
- הצגת רשימה של כל הקישורים בפרויקט, בתיקייה או בארגון: הצגת כל הקישורים שההורה שלהם הוא פרויקט, תיקייה או ארגון ספציפיים.
הצגת רשימת הקישורים של מערכת גישה מאוחדת לכללי מדיניות (UAP)
כדי לראות את כל הקישורים שכוללים מדיניות UAP מסוימת, חפשו את מדיניות ה-UAP בקישורים.
אתם יכולים לראות את כל הקישורים של מדיניות ה-UAP באמצעות מסוףGoogle Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
המסוף
-
נכנסים לדף Unified Access Policies במסוף Google Cloud .
כניסה לדף Unified Access Policies - בוחרים את הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שאת הקישורים שלה רוצים לראות.
- לוחצים על מזהה המדיניות של ה-UAP שרוצים לראות את הקישורים שלו.
- לוחצים על הכרטיסייה Bindings.
במסוף Google Cloud מוצגת רשימה של הקישורים של ה-UAP, יחד עם השם המוצג של כל קישור ומשאב היעד.
gcloud
הפקודה gcloud iam access-policies search-policy-bindings מציגה את כל הקישורים של ה-UAP שצוין.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
UAP_ID: המזהה של ה-UAP שרוצים להציג את הקישורים שלו, לדוגמהexample-policy. -
UAP_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שבבעלותו נמצאת מדיניות ה-UAP שרוצים להציג את הקישורים שלה. אפשר להשתמש בערךproject,folderאוorganization. -
UAP_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שאתם רוצים להציג את הקישורים שלה. מזהי פרויקטים מכילים אותיות וספרות, למשלmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
FORMAT: הפורמט של התשובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam access-policies search-policy-bindings UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \ --location=global --format=FORMAT
Windows (PowerShell)
gcloud iam access-policies search-policy-bindings UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ` --location=global --format=FORMAT
Windows (cmd.exe)
gcloud iam access-policies search-policy-bindings UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^ --location=global --format=FORMAT
התשובה מכילה את הקישורים ל-UAP שצוינה.
{
"policyBindings": [
{
"createTime": "2026-05-06T18:08:24.729843Z",
"displayName": "Example binding 1",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"policyKind": "ACCESS",
"policyUid": "puid_9519202237377675265",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2026-05-06T18:08:24.729843Z"
},
{
"createTime": "2026-05-07T07:05:06.203861Z",
"displayName": "Example binding 2",
"etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"policyKind": "ACCESS",
"policyUid": "puid_9519202237377675265",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/projects/example-project"
},
"uid": "buid_4331055466646863873",
"updateTime": "2026-05-07T07:05:06.203861Z"
}
]
}
REST
ה-method accessPolicies.searchPolicyBindings מציגה את כל הקישורים של ה-UAP שצוינה.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
UAP_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שבבעלותו נמצאת מדיניות ה-UAP שרוצים להציג את הקישורים שלה. אפשר להשתמש בערךprojects,foldersאוorganizations. -
UAP_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שאתם רוצים להציג את הקישורים שלה. מזהי פרויקטים מכילים אותיות וספרות, למשלmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
UAP_ID: המזהה של ה-UAP שרוצים להציג את הקישורים שלו, לדוגמהexample-policy.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID:searchPolicyBindings
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה את הקישורים ל-UAP שצוינה.
{
"policyBindings": [
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 1",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "ACCESS",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"policyUid": "puid_9519202237377675265",
"createTime": "2026-05-06T18:08:24.729843Z",
"updateTime": "2026-05-06T18:08:24.729843Z"
},
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
"uid": "buid_4331055466646863873",
"etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
"displayName": "Example binding 2",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/projects/example-project"
},
"policyKind": "ACCESS",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"policyUid": "puid_9519202237377675265",
"createTime": "2026-05-07T07:05:06.203861Z",
"updateTime": "2026-05-07T07:05:06.203861Z"
}
]
}
הצגת כל הקישורים של משאב
כדי לראות את כל הקישורים שכוללים משאב מטרה ספציפי, חפשו את הקישורים של אותו משאב.
כל קישור מכיל את המזהה של ה-UAP שמקושר למשאב. כדי לראות את פרטי המדיניות, משתמשים במזהה המדיניות כדי לקבל את פרטי המדיניות.
אפשר לראות את כל הקישורים של משאב באמצעות מסוףGoogle Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
המסוף
-
נכנסים לדף Unified Access Policies במסוף Google Cloud .
כניסה לדף Unified Access Policies - בוחרים את הפרויקט, התיקייה או הארגון שאת הקישורים שלהם רוצים לראות.
- בשדה Filter, מזינים את המסנן Enforcement: Enforced.
בטבלה מוצגים כל כללי ה-UAP שקשורים למשאב.
gcloud
הפקודה gcloud iam policy-bindings search-target-policy-bindings מחזירה את כל הקישורים של ה-UAP שכוללים את המשאב.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
BINDING_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שכולל את הקישורים של משאב המטרה. אפשר להשתמש בערךproject,folderאוorganization.במאמר משאבים נתמכים מוסבר אילו משאבים הם ההורים של אילו קישורים.
-
BINDING_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שכוללים את הקישורים של משאב המטרה. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
TARGET_RESOURCE: המשאב שאת הקישורים שלו רוצים להציג. רשימה של משאבים תקינים מופיעה בקטע משאבים נתמכים. -
FORMAT: הפורמט של התשובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam policy-bindings search-target-policy-bindings \ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID \ --target=TARGET_RESOURCE \ --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings search-target-policy-bindings ` --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ` --target=TARGET_RESOURCE ` --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings search-target-policy-bindings ^ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ^ --target=TARGET_RESOURCE ^ --format=FORMAT
התשובה מכילה את כל הקישורים של ה-UAP שכוללים את משאב המטרה.
{
"policyBindings": [
{
"createTime": "2026-05-06T18:08:24.729843Z",
"displayName": "Example binding 1",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-1",
"policyKind": "ACCESS",
"policyUid": "puid_9519202237377675265",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2026-05-06T18:11:16.798841Z"
},
{
"createTime": "2026-05-06T18:08:24.729843Z",
"displayName": "Example binding 2",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-2",
"policyKind": "ACCESS",
"policyUid": "puid_10358560617928851457",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_4331055466646863873",
"updateTime": "2026-05-06T18:11:16.798841Z"
}
]
}
REST
ה-method SearchTargetPolicyBindings.search מחזירה את כל הקישורים של UAP שכוללים את המשאב.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
BINDING_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שכולל את הקישורים של משאב המטרה. אפשר להשתמש בערךprojects,foldersאוorganizations.במאמר משאבים נתמכים מוסבר אילו משאבים הם ההורים של אילו קישורים.
-
BINDING_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שכוללים את הקישורים של משאב המטרה. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
TARGET_RESOURCE: המשאב שאת הקישורים שלו רוצים להציג. רשימה של משאבים תקינים מופיעה בקטע משאבים נתמכים.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings:searchTargetPolicyBindings?target=TARGET_RESOURCE
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה את כל הקישורים של ה-UAP שכוללים את משאב המטרה.
{
"policyBindings": [
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 1",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-1",
"createTime": "2026-05-06T18:08:24.729843Z",
"updateTime": "2026-05-06T18:11:16.798841Z",
"policyKind": "ACCESS",
"policyUid": "puid_9519202237377675265"
},
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
"uid": "buid_4331055466646863873",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 2",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-2",
"createTime": "2026-05-06T18:08:24.729843Z",
"updateTime": "2026-05-06T18:11:16.798841Z",
"policyKind": "ACCESS",
"policyUid": "puid_10358560617928851457"
}
]
}
הצגת רשימה של כל הקישורים בפרויקט, בתיקייה או בארגון
אם אתם משתמשים ב-CLI של gcloud או ב-API בארכיטקטורת REST של IAM כדי לראות את הקישורים, אתם יכולים גם להציג את כל הקישורים שהם צאצאים של פרויקט, תיקייה או ארגון ספציפיים.
הצגת רשימת הקישורים של פרויקט, תיקייה או ארגון דומה לחיפוש הקישורים של אותו משאב. עם זאת, בניגוד לחיפוש קישורים, הצגת רשימת הקישורים של משאב כוללת גם את כל הקישורים שהם צאצאים מיידיים של אותו משאב.
לדוגמה, נניח שיש לכם קישור שמצרף מדיניות לשער של סוכן Network Services API. משאב ההורה של הקישור הזה הוא פרויקט ההורה של Agent Gateway. במילים אחרות, הקישור הוא צאצא ישיר של הפרויקט. כתוצאה מכך, אם תציגו את הקישורים של הפרויקט הזה, התגובה תכלול את הקישור ל-Agent Gateway. עם זאת, אם תציגו את הקישורים של הארגון שמעל לפרויקט בהיררכיה, התשובה לא תכלול את הקישור. הסיבה לכך היא שלמרות שהקישור הוא צאצא של הארגון, הוא לא צאצא מיידי של הארגון.
משאב ההורה של הקישור תלוי במשאב היעד בקישור. למידע נוסף, קראו את המאמר משאבים נתמכים.
כל קישור מכיל את המזהה של ה-UAP שמקושר למשאב. כדי לראות את פרטי המדיניות, משתמשים במזהה המדיניות כדי לקבל את פרטי המדיניות.
אפשר לראות את כל הקישורים שהם צאצאים של פרויקט, תיקייה או ארגון באמצעות ה-CLI של gcloud או ה-API ל-REST של IAM.
gcloud
הפקודה gcloud iam policy-bindings list מציגה את כל הקישורים של UAP שהם צאצאים של משאב מסוים.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
BINDING_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שהקישור הוא צאצא שלו. אפשר להשתמש בערךproject,folderאוorganization.משאב ההורה של הקישור תלוי במשאב היעד בקישור. למידע נוסף, קראו את המאמר משאבים נתמכים.
-
BINDING_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
FORMAT: הפורמט של התשובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam policy-bindings list --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID \ --location=global \ --filter=policyKind:ACCESS \ --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings list --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ` --location=global ` --filter=policyKind:ACCESS ` --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings list --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ^ --location=global ^ --filter=policyKind:ACCESS ^ --format=FORMAT
התשובה מכילה את הקישורים של ה-UAP שהם צאצאים של המשאב בפקודה.
{
"policyBindings": [
{
"createTime": "2026-05-06T18:08:24.729843Z",
"displayName": "Example binding 1",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding-1",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-1",
"policyKind": "ACCESS",
"policyUid": "puid_9519202237377675265",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2026-05-06T18:08:24.729843Z"
},
{
"createTime": "2026-05-07T07:05:06.203861Z",
"displayName": "Example binding 2",
"etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding-2",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-2",
"policyKind": "ACCESS",
"policyUid": "puid_1566408245394800641",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_4331055466646863873",
"updateTime": "2026-05-07T07:05:06.203861Z"
}
]
}
REST
ה-method policyBindings.list מציגה את כל הקישורים של UAP שהם צאצאים של משאב מסוים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
BINDING_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שהקישור הוא צאצא שלו. אפשר להשתמש בערךprojects,foldersאוorganizations.משאב ההורה של הקישור תלוי במשאב היעד בקישור. למידע נוסף, קראו את המאמר משאבים נתמכים.
-
BINDING_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings?filter=policyKind:ACCESS
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה את הקישורים של ה-UAP שהם צאצאים של המשאב בבקשה.
{
"policyBindings": [
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding-1",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 1",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "ACCESS",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-1",
"policyUid": "puid_9519202237377675265",
"createTime": "2026-05-06T18:08:24.729843Z",
"updateTime": "2026-05-06T18:08:24.729843Z"
},
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding-2",
"uid": "buid_4331055466646863873",
"etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
"displayName": "Example binding 2",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "ACCESS",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-2",
"policyUid": "puid_1566408245394800641",
"createTime": "2026-05-07T07:05:06.203861Z",
"updateTime": "2026-05-07T07:05:06.203861Z"
}
]
}
קבלת קישור למערכת גישה מאוחדת לכללי מדיניות (UAP)
אפשר לקבל את פרטי הקישור באמצעות מסוף Google Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
המסוף
-
נכנסים לדף Unified Access Policies במסוף Google Cloud .
כניסה לדף Unified Access Policies - בוחרים את הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שאת הקישורים שלה רוצים לראות.
- לוחצים על מזהה המדיניות של ה-UAP שרוצים לראות את הקישורים שלו.
- לוחצים על הכרטיסייה Bindings.
- מוצאים את הקישור באמצעות מזהה הקישור או שם הקישור.
בטבלה מוצגים פרטי הקישור, כולל מזהה הקישור, שם הקישור ומשאב המטרה בקישור.
gcloud
הפקודה gcloud iam policy-bindings describe מקבלת קישור.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
BINDING_ID: המזהה של הקישור שרוצים לראות, לדוגמהexample-binding. -
BINDING_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שהקישור הוא צאצא שלו. אפשר להשתמש בערךproject,folderאוorganization.משאב ההורה של הקישור תלוי במשאב היעד בקישור. למידע נוסף, קראו את המאמר משאבים נתמכים.
-
BINDING_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
FORMAT: הפורמט של התשובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam policy-bindings describe BINDING_ID \ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID \ --location=global --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings describe BINDING_ID ` --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ` --location=global --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings describe BINDING_ID ^ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ^ --location=global --format=FORMAT
התשובה מכילה את הקישור.
{
"createTime": "2026-05-06T18:08:24.729843Z",
"displayName": "Example binding",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap",
"policyKind": "ACCESS",
"policyUid": "puid_9519202237377675265",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2026-05-06T18:08:24.729843Z"
}
REST
ה-method policyBindings.get מקבלת קישור.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
BINDING_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שהקישור הוא צאצא שלו. אפשר להשתמש בערךprojects,foldersאוorganizations.משאב ההורה של הקישור תלוי במשאב היעד בקישור. למידע נוסף, קראו את המאמר משאבים נתמכים.
-
BINDING_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
BINDING_ID: המזהה של הקישור שרוצים לראות, לדוגמהexample-binding.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings/BINDING_ID
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה את הקישור.
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "ACCESS",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap",
"policyUid": "puid_9519202237377675265",
"createTime": "2026-05-06T18:08:24.729843Z",
"updateTime": "2026-05-06T18:08:24.729843Z"
}
המאמרים הבאים
- יצירה והחלה של כללי מדיניות גישה מאוחדת
- עריכת כללי מדיניות ה-UAP והקישורים
- הסרת כללי מדיניות ה-UAP והקישורים