כללי מדיניות של בקרת גישה לישויות מורשות (PAB) מאפשרים להגביל את המשאבים שקבוצה של חשבונות משתמשים יכולה לגשת אליהם. בדף הזה מוסבר איך לצפות בכללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) ובקישורי המדיניות של כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB).
לפני שמתחילים
מגדירים אימות.
צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:
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 .
סקירה כללית של כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
התפקידים שנדרשים כדי לצפות בכללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
כדי לקבל את ההרשאות שדרושות לצפייה במדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), בקשו מהאדמין להקצות לכם את התפקיד צפייה בגבולות הגישה לחשבונות משתמשים (roles/iam.principalAccessBoundaryViewer) ב-IAM ברמת הארגון.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
זהו תפקיד מוגדר מראש שכולל את ההרשאות שנדרשות כדי לצפות בכללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי לראות את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), צריך את ההרשאות הבאות:
-
הצגת מדיניות אחת לקביעת גבול הגישה לחשבונות משתמשים:
iam.principalaccessboundarypolicies.get -
הצגת רשימה של כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) בארגון:
iam.principalaccessboundarypolicies.list
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
התפקידים שנדרשים כדי לראות את הקישורים של המדיניות
כדי לקבל את ההרשאות שדרושות לצפייה בקישורי מדיניות, בקשו מהאדמין לתת לכם את התפקידים הבאים ב-IAM במשאב ההורה של קישורי המדיניות:
-
צפייה בקישורי מדיניות בפרויקט: אדמין IAM של פרויקט (
roles/resourcemanager.projectIamAdmin) -
הצגת קישורי מדיניות בתיקייה:
אדמין IAM בתיקייה (
roles/resourcemanager.folderIamAdmin) -
הצגת קישורי מדיניות בארגון: אדמין ארגוני (
roles/resourcemanager.organizationAdmin)
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות כדי לראות את קישורי המדיניות. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי לראות את קישורי המדיניות, נדרשות ההרשאות הבאות:
-
הצגת קישור מדיניות יחיד:
iam.policybindings.get -
הצגת רשימה של קישורי המדיניות בפרויקט, בתיקייה או בארגון:
iam.policybindings.list
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
התפקידים שנדרשים כדי לראות את כל קישורי המדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
כדי לקבל את ההרשאה שדרושה לצפייה בכל הקישורים של מדיניות PAB, בקשו מהאדמין להקצות לכם את התפקיד צפייה במדיניות לקביעת גבול הגישה לחשבונות משתמשים (roles/iam.principalAccessBoundaryViewer) ב-IAM ברמת הארגון.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקיד המוגדר מראש הזה כולל את ההרשאה iam.principalaccessboundarypolicies.searchIamPolicyBindings, שנדרשת כדי לראות את כל קישורי המדיניות של מדיניות PAB.
יכול להיות שתוכלו לקבל את ההרשאה הזו גם בתפקידים בהתאמה אישית או בתפקידים מוגדרים מראש.
התפקידים שנדרשים כדי לראות את הקישורים של מדיניות ההרשאות לקבוצת חשבונות משתמשים
ההרשאות שאתם צריכים כדי לראות את כל קישורי המדיניות של קבוצת חשבונות משתמשים תלויות בקבוצת חשבונות המשתמשים שאתם רוצים לראות את כללי המדיניות שלה.
כדי לקבל את ההרשאות שדרושות לצפייה בקישורי מדיניות, בקשו מהאדמין לתת לכם את התפקידים הבאים ב-IAM:
-
הצגת קישורי מדיניות למאגרים של איחוד שירותי אימות הזהות של כוח עבודה:
אדמין של מאגר זהויות של כוח עבודה ב-IAM (
roles/iam.workforcePoolAdmin) במאגר היעד של איחוד שירותי אימות הזהות של כוח עבודה -
הצגת קישורי מדיניות למאגרי איחוד זהויות של עומסי עבודה:
אדמין של מאגר זהויות של עומסי עבודה ב-IAM (
roles/iam.workloadIdentityPoolAdmin) בפרויקט שבבעלותו מאגר איחוד הזהויות של עומסי העבודה של היעד -
לצפות בקישורי מדיניות של דומיין ב-Google Workspace:
אדמין של מאגר IAM ב-Workspace (
roles/iam.workspacePoolAdmin) בארגון -
צפייה בקישורי המדיניות של קבוצת חשבונות המשתמשים בפרויקט: אדמין IAM של פרויקט (
roles/resourcemanager.projectIamAdmin) בפרויקט -
לצפות בקישורי המדיניות של קבוצת חשבונות המשתמשים בתיקייה: אדמין IAM של תיקיות (
roles/resourcemanager.folderIamAdmin) בתיקייה -
הצגת קישורי המדיניות של קבוצת חשבונות המשתמשים בארגון: אדמין ארגוני (
roles/resourcemanager.organizationAdmin) בארגון
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות כדי לראות את קישורי המדיניות. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי לראות את קישורי המדיניות, נדרשות ההרשאות הבאות:
-
הצגת קישורי מדיניות למאגרי איחוד שירותי אימות הזהות של כוח עבודה:
iam.workforcePools.searchPolicyBindingsבמאגר היעד של איחוד שירותי אימות הזהות של כוח עבודה -
הצגת קישורי מדיניות למאגרים של איחוד שירותי אימות הזהות של עומסי עבודה:
iam.workloadIdentityPools.searchPolicyBindingsבפרויקט שבבעלותו מאגר היעד של איחוד שירותי אימות הזהות של עומסי עבודה -
הצגת קישורי מדיניות לדומיין ב-Google Workspace:
iam.workspacePools.searchPolicyBindingsבארגון -
הצגת קישורי המדיניות של קבוצת חשבונות המשתמשים בפרויקט:
resourcemanager.projects.searchPolicyBindingsבפרויקט -
הצגת קישורי המדיניות של קבוצת חשבונות המשתמשים בתיקייה:
resourcemanager.folders.searchPolicyBindingsבתיקייה -
הצגת קישורי המדיניות של קבוצת חשבונות המשתמשים של הארגון:
resourcemanager.organizations.searchPolicyBindingsבארגון
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
הצגת רשימה של כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) בארגון
כדי לראות את כל כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים שנוצרו בארגון, צריך להציג את רשימת כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים בארגון.
אפשר להציג רשימה של כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים בארגון באמצעות מסוףGoogle Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
המסוף
נכנסים לדף Principal Access Boundary policies במסוף Google Cloud .
בוחרים את הארגון שבו רוצים לראות את כללי המדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB).
במסוף Google Cloud מופיעות כל כללי המדיניות בארגון שבחרתם.
gcloud
הפקודה gcloud iam principal-access-boundary-policies list מציגה רשימה של כל כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים בארגון.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
ORG_ID: המזהה של הארגון ב- Google Cloud שרוצים להציג את מדיניות ה-PAB שלו. מזהי ארגונים הם מספרים, למשל123456789012. -
FORMAT: הפורמט של התשובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam principal-access-boundary-policies list --organization=ORG_ID \ --location=global --format=FORMAT
Windows (PowerShell)
gcloud iam principal-access-boundary-policies list --organization=ORG_ID ` --location=global --format=FORMAT
Windows (cmd.exe)
gcloud iam principal-access-boundary-policies list --organization=ORG_ID ^ --location=global --format=FORMAT
התשובה מכילה את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) בארגון שצוין.
{
"principalAccessBoundaryPolicies": [
{
"createTime": "2026-07-07T00:05:48.295209Z",
"details": {
"enforcementVersion": "4",
"rules": [
{
"description": "Make principals eligible to manage but not delete Compute resources in example.com",
"effect": "ALLOW",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/123456789012"
]
}
]
},
"displayName": "Example policy 1",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy-1",
"uid": "puid_13364150419245236225",
"updateTime": "2026-07-07T00:05:48.295209Z"
},
{
"createTime": "2026-05-29T23:25:01.606730Z",
"details": {
"enforcementVersion": "4",
"rules": [
{
"description": "Make principals eligible to access resources in example-project",
"effect": "ALLOW",
"resources": [
"//cloudresourcemanager.googleapis.com/projects/example-project"
]
}
]
},
"displayName": "Example policy 2",
"etag": "d6BJBTsk2+oDCygmr5ANxA==",
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy-2",
"uid": "puid_13064942519001808897",
"updateTime": "2026-05-29T23:25:01.606730Z"
}
]
}
REST
באמצעות ה-method principalAccessBoundaryPolicies.list אפשר להציג רשימה של כל כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) בארגון.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
ORG_ID: המזהה של הארגון ב- Google Cloud שרוצים להציג את מדיניות ה-PAB שלו. מזהי ארגונים הם מספרים, למשל123456789012.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) בארגון שצוין.
{
"principalAccessBoundaryPolicies": [
{
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy-1",
"uid": "puid_13364150419245236225",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"displayName": "Example policy 1",
"createTime": "2026-07-07T00:05:48.295209Z",
"updateTime": "2026-07-07T00:05:48.295209Z",
"details": {
"rules": [
{
"description": "Make principals eligible to access resources in example.com",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/123456789012"
],
"effect": "ALLOW"
}
],
"enforcementVersion": "4"
}
},
{
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/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": "Make principals eligible to access resources in example-project",
"resources": [
"//cloudresourcemanager.googleapis.com/projects/example-project"
],
"effect": "ALLOW"
}
],
"enforcementVersion": "4"
}
}
]
}
קבלת מדיניות אחת לקביעת גבול הגישה לחשבונות משתמשים (PAB)
כדי לראות את הפרטים של מדיניות PAB אחת, משתמשים במזהה המדיניות כדי לקבל את המדיניות.
אפשר לקבל מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) באמצעות המסוף Google Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
המסוף
נכנסים לדף Principal Access Boundary policies במסוף Google Cloud .
בוחרים את הארגון שבו רוצים לראות את כללי המדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB).
לוחצים על מזהה המדיניות של המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שרוצים לראות.
במסוף Google Cloud מוצגים הפרטים של המדיניות לקביעת גבול הגישה לחשבונות משתמשים שבחרתם.
gcloud
הפקודה
gcloud iam principal-access-boundary-policies describe
מקבלת מדיניות אחת לקביעת גבול הגישה לחשבונות משתמשים (PAB).
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
PAB_POLICY_ID: המזהה של מדיניות גבול הגישה לחשבונות משתמשים שרוצים לקבל, לדוגמהexample-policy. -
ORG_ID: המזהה של הארגון שבבעלותו המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). מזהי ארגונים הם מספרים, למשל123456789012. -
FORMAT: הפורמט של התשובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam principal-access-boundary-policies describe PAB_POLICY_ID \ --organization=ORG_ID --location=global \ --format=FORMAT
Windows (PowerShell)
gcloud iam principal-access-boundary-policies describe PAB_POLICY_ID ` --organization=ORG_ID --location=global ` --format=FORMAT
Windows (cmd.exe)
gcloud iam principal-access-boundary-policies describe PAB_POLICY_ID ^ --organization=ORG_ID --location=global ^ --format=FORMAT
התשובה מכילה את המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שצוינה בבקשה.
{
"createTime": "2026-07-07T00:05:48.295209Z",
"details": {
"enforcementVersion": "4",
"rules": [
{
"description": "Make principals eligible to access resources in example.com",
"effect": "ALLOW",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/123456789012"
]
}
]
},
"displayName": "Example policy",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"uid": "puid_13364150419245236225",
"updateTime": "2026-07-07T00:05:48.295209Z"
}
REST
השיטה principalAccessBoundaryPolicies.get מאחזרת מדיניות PAB אחת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
ORG_ID: המזהה של הארגון שבבעלותו המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). מזהי ארגונים הם מספרים, למשל123456789012. -
PAB_POLICY_ID: המזהה של מדיניות גבול הגישה לחשבונות משתמשים שרוצים לקבל, לדוגמהexample-policy.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה את המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שצוינה בבקשה.
{
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"uid": "puid_13364150419245236225",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"displayName": "Example policy",
"createTime": "2026-07-07T00:05:48.295209Z",
"updateTime": "2026-07-07T00:05:48.295209Z",
"details": {
"rules": [
{
"description": "Make principals eligible to access resources in example.com",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/123456789012"
],
"effect": "ALLOW"
}
],
"enforcementVersion": "4"
}
}
הצגת רשימה של קישורי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
יש כמה דרכים להציג את רשימת הקישורים של כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB):
- הצגת רשימה של קישורי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
- הצגת רשימה של קישורי מדיניות לקבוצת חשבונות משתמשים
- הצגת רשימה של קישורי מדיניות לפרויקט, לתיקייה או לארגון
הצגת רשימה של קישורי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
כדי לראות את כל הקישורים למדיניות שכוללים מדיניות מסוימת לקביעת גבול הגישה לחשבונות משתמשים, חפשו את המדיניות לקביעת גבול הגישה לחשבונות משתמשים בקישורים.
אפשר לראות את כל קישורי המדיניות של מדיניות PAB באמצעות מסוףGoogle Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
המסוף
נכנסים לדף Principal Access Boundary policies במסוף Google Cloud .
בוחרים את הארגון שבבעלותו נמצאת מדיניות ה-PAB שרוצים לראות את הקישורים שלה.
לוחצים על מזהה המדיניות של המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שרוצים לראות את הקישורים שלה.
לוחצים על הכרטיסייה Bindings.
בכרטיסייה Bindings מופיעים כל הקישורים של מדיניות PAB שכוללים את מדיניות PAB.
gcloud
הפקודה gcloud iam principal-access-boundary-policies search-policy-bindings מציגה את כל קישורי המדיניות של המדיניות שצוינה לקביעת גבול הגישה לחשבונות משתמשים (PAB).
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
PAB_POLICY_ID: המזהה של מדיניות ה-PAB שאתם רוצים להציג את הקישורים שלה, לדוגמהexample-policy. -
ORG_ID: המזהה של הארגון שבבעלותו המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). מזהי ארגונים הם מספרים, למשל123456789012. -
FORMAT: הפורמט של התשובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam principal-access-boundary-policies search-policy-bindings PAB_POLICY_ID \ --organization=ORG_ID --location=global \ --format=FORMAT
Windows (PowerShell)
gcloud iam principal-access-boundary-policies search-policy-bindings PAB_POLICY_ID ` --organization=ORG_ID --location=global ` --format=FORMAT
Windows (cmd.exe)
gcloud iam principal-access-boundary-policies search-policy-bindings PAB_POLICY_ID ^ --organization=ORG_ID --location=global ^ --format=FORMAT
התשובה מכילה את קישורי המדיניות של המדיניות שצוינה לקביעת גבול הגישה לחשבונות משתמשים (PAB).
{
"policyBindings": [
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2024-05-06T18:08:24.729843Z"
},
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/projects/example-project"
},
"uid": "buid_4331055466646863873",
"updateTime": "2024-05-07T07:05:06.203861Z"
}
]
}
REST
ה-method principalAccessBoundaryPolicies.searchPolicyBindings מציגה את כל קישורי המדיניות של מדיניות ה-PAB שצוינה.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
ORG_ID: המזהה של הארגון שבבעלותו המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). מזהי ארגונים הם מספרים, למשל123456789012. -
PAB_POLICY_ID: המזהה של מדיניות ה-PAB שאתם רוצים להציג את הקישורים שלה, לדוגמהexample-policy.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID:searchPolicyBindings
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה את קישורי המדיניות של המדיניות שצוינה לקביעת גבול הגישה לחשבונות משתמשים.
{
"policyBindings": [
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 1",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
"policyUid": "puid_9519202237377675265",
"createTime": "2024-05-06T18:08:24.729843Z",
"updateTime": "2024-05-06T18:08:24.729843Z"
},
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
"uid": "buid_4331055466646863873",
"etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
"displayName": "Example binding 2",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/projects/example-project"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
"policyUid": "puid_9519202237377675265",
"createTime": "2024-05-07T07:05:06.203861Z",
"updateTime": "2024-05-07T07:05:06.203861Z"
}
]
}
הצגת רשימה של קישורי מדיניות לקבוצת חשבונות משתמשים
כדי לראות את כל הקישורים של כללי המדיניות שכוללים קבוצת חשבונות משתמשים מסוימת, חפשו את קבוצת חשבונות המשתמשים בקישורים.
הקישורים האלה מכילים את המזהים של כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמשויכים לקבוצת החשבונות הראשיים. כדי לראות את הפרטים של כללי המדיניות האלה, משתמשים במזהה המדיניות כדי לקבל את מדיניות גבול הגישה לחשבונות משתמשים.
אפשר לראות את כל קישורי המדיניות של קבוצת חשבונות משתמשים באמצעות ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
gcloud
הפקודה gcloud iam policy-bindings search-target-policy-bindings מקבלת את כל הקישורים של מדיניות PAB לקבוצת חשבונות משתמשים.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שקבוצת חשבונות המשתמשים היא צאצא שלו. אפשר להשתמש בערךproject,folderאוorganization.סוג המשאב תלוי בסוג של קבוצת חשבונות המשתמשים שאתם רוצים להציג את קישורי המדיניות שלהם. כדי לראות באיזה סוג משאב להשתמש, קראו את המאמר קבוצות של חשבונות משתמשים נתמכים.
-
RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקבוצת חשבונות המשתמשים היא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
PRINCIPAL_SET: קבוצת חשבונות המשתמשים שרוצים לראות את הקישורים שלהם למדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). לרשימה של סוגי חשבונות המשתמשים החוקיים, ראו קבוצות נתמכות של חשבונות משתמשים. -
FORMAT: הפורמט של התשובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam policy-bindings search-target-policy-bindings \ --RESOURCE_TYPE=RESOURCE_ID \ --target=PRINCIPAL_SET \ --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings search-target-policy-bindings ` --RESOURCE_TYPE=RESOURCE_ID ` --target=PRINCIPAL_SET ` --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings search-target-policy-bindings ^ --RESOURCE_TYPE=RESOURCE_ID ^ --target=PRINCIPAL_SET ^ --format=FORMAT
התשובה מכילה את כל קישורי המדיניות שכוללים את קבוצת חשבונות המשתמשים המטורגטים.
{
"policyBindings": [
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy1",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2024-05-06T18:11:16.798841Z"
},
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy2",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_10358560617928851457",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_4331055466646863873",
"updateTime": "2024-05-06T18:11:16.798841Z"
}
]
}
REST
השיטה
SearchTargetPolicyBindings.search
מקבלת את כל הקישורים של המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) לקבוצת חשבונות משתמשים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שקבוצת חשבונות המשתמשים היא צאצא שלו. אפשר להשתמש בערךprojects,foldersאוorganizations.סוג המשאב תלוי בסוג של קבוצת חשבונות המשתמשים שאתם רוצים להציג את קישורי המדיניות שלהם. כדי לראות באיזה סוג משאב להשתמש, קראו את המאמר קבוצות נתמכות של חשבונות משתמשים.
-
RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקבוצת חשבונות המשתמשים היא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
PRINCIPAL_SET: קבוצת חשבונות המשתמשים שרוצים לראות את הקישורים שלהם למדיניות PAB. לרשימה של סוגי חשבונות המשתמשים החוקיים, ראו קבוצות נתמכות של חשבונות משתמשים.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings:searchTargetPolicyBindings?target=PRINCIPAL_SET
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה את כל קישורי המדיניות שכוללים את קבוצת חשבונות המשתמשים המטורגטים.
{
"policyBindings": [
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 1",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy1",
"createTime": "2024-05-06T18:08:24.729843Z",
"updateTime": "2024-05-06T18:11:16.798841Z",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265"
},
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
"uid": "buid_4331055466646863873",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 2",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy2",
"createTime": "2024-05-06T18:08:24.729843Z",
"updateTime": "2024-05-06T18:11:16.798841Z",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_10358560617928851457"
}
]
}
הצגת רשימה של קישורי מדיניות לפרויקט, לתיקייה או לארגון
כדי לראות את כל קישורי המדיניות שהם צאצאים של פרויקט, תיקייה או ארגון ספציפיים, צריך להציג את רשימת קישורי המדיניות של אותו פרויקט, תיקייה או ארגון.
משאב ההורה של קישור המדיניות תלוי בחשבון המשתמש שמוגדר בקישור המדיניות. מידע נוסף זמין במאמר סוגי חשבונות משתמשים נתמכים.
אפשר לראות את כל קישורי המדיניות של פרויקט, תיקייה או ארגון באמצעות ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
gcloud
הפקודה gcloud iam policy-bindings list מציגה רשימה של כל קישורי המדיניות שהם צאצאים של משאב מסוים.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שקישור המדיניות הוא צאצא שלו. אפשר להשתמש בערךproject,folderאוorganization.סוג המשאב תלוי בחשבון המשתמש שמוגדר בקישור המדיניות. כדי לראות באיזה סוג משאב להשתמש, עיינו במאמר סוגי חשבונות משתמשים נתמכים.
-
RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
FORMAT: הפורמט של התשובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam policy-bindings list --RESOURCE_TYPE=RESOURCE_ID \ --location=global \ --filter=policyKind:PRINCIPAL_ACCESS_BOUNDARY \ --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings list --RESOURCE_TYPE=RESOURCE_ID ` --location=global ` --filter=policyKind:PRINCIPAL_ACCESS_BOUNDARY ` --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings list --RESOURCE_TYPE=RESOURCE_ID ^ --location=global ^ --filter=policyKind:PRINCIPAL_ACCESS_BOUNDARY ^ --format=FORMAT
התשובה מכילה את קישורי המדיניות שהם צאצאים של המשאב בפקודה.
{
"policyBindings": [
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy-1",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2024-05-06T18:08:24.729843Z"
},
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy-2",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_1566408245394800641",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_4331055466646863873",
"updateTime": "2024-05-07T07:05:06.203861Z"
}
]
}
REST
השיטה
policyBindings.list
מציגה את כל קישורי המדיניות שהם צאצאים של משאב מסוים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שקישור המדיניות הוא צאצא שלו. אפשר להשתמש בערךprojects,foldersאוorganizations.סוג המשאב תלוי בחשבון המשתמש שמוגדר בקישור המדיניות. כדי לראות באיזה סוג משאב להשתמש, עיינו במאמר סוגי חשבונות משתמשים נתמכים.
-
RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings?filter=policyKind:PRINCIPAL_ACCESS_BOUNDARY
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה את קישורי המדיניות שהם צאצאים של המשאב בבקשה.
{
"policyBindings": [
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding-1",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 1",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy-1",
"policyUid": "puid_9519202237377675265",
"createTime": "2024-05-06T18:08:24.729843Z",
"updateTime": "2024-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": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy-2",
"policyUid": "puid_1566408245394800641",
"createTime": "2024-05-07T07:05:06.203861Z",
"updateTime": "2024-05-07T07:05:06.203861Z"
}
]
}
קבלת קישור למדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
כדי לראות את הפרטים של קישור מדיניות יחיד, משתמשים במזהה של קישור המדיניות כדי לקבל את קישור המדיניות.
אפשר לקבל קישור למדיניות באמצעות ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
gcloud
הפקודה
gcloud iam policy-bindings describe
מקבלת קישור מדיניות.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
BINDING_ID: המזהה של קישור המדיניות שרוצים לקבל, לדוגמהexample-binding. -
RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שקישור המדיניות הוא צאצא שלו. אפשר להשתמש בערךproject,folderאוorganization.סוג המשאב תלוי בחשבון המשתמש שמוגדר בקישור המדיניות. כדי לראות באיזה סוג משאב להשתמש, עיינו במאמר סוגי חשבונות משתמשים נתמכים.
-
RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
FORMAT: הפורמט של התשובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam policy-bindings describe BINDING_ID \ --RESOURCE_TYPE=RESOURCE_ID --location=global \ --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings describe BINDING_ID ` --RESOURCE_TYPE=RESOURCE_ID --location=global ` --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings describe BINDING_ID ^ --RESOURCE_TYPE=RESOURCE_ID --location=global ^ --format=FORMAT
התשובה מכילה את קישור המדיניות.
{
"createTime": "2024-05-06T18:08:24.729843Z",
"displayName": "Example binding",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2024-05-06T18:08:24.729843Z"
}
REST
השיטה policyBindings.get מקבלת קישור מדיניות.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שקישור המדיניות הוא צאצא שלו. אפשר להשתמש בערךprojects,foldersאוorganizations.סוג המשאב תלוי בחשבון המשתמש שמוגדר בקישור המדיניות. כדי לראות באיזה סוג משאב להשתמש, עיינו במאמר סוגי חשבונות משתמשים נתמכים.
-
RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
BINDING_ID: המזהה של קישור המדיניות שרוצים לקבל, לדוגמהexample-binding.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://iam.googleapis.com/v3/RESOURCE_TYPE/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": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
"policyUid": "puid_9519202237377675265",
"createTime": "2024-05-06T18:08:24.729843Z",
"updateTime": "2024-05-06T18:08:24.729843Z"
}
המאמרים הבאים
- יצירה והחלה של כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
- עריכת כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
- הסרת כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)