מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) מאפשרת להגביל את המשאבים שקבוצה של חשבונות משתמשים יכולה לגשת אליהם. בדף הזה מוסבר איך לערוך מדיניות קיימת של גבולות גישה של ישויות, ואיך לערוך את קישורי המדיניות של מדיניות גבולות הגישה של ישויות כדי לשנות את הישויות שהמדיניות חלה עליהן.
לפני שמתחילים
מגדירים אימות.
Select the tab for how you plan to use the samples on this page:
gcloud
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
REST
כדי להשתמש בדוגמאות של API בארכיטקטורת REST שבדף הזה בסביבת פיתוח מקומית, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.
התקינו את ה-CLI של Google Cloud. אחר כך, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:
gcloud initאם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .
כדאי לקרוא את הסקירה הכללית של כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB).
תפקידים שנדרשים לעריכת מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
כדי לקבל את ההרשאה שנדרשת לעריכת מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד אדמין של גבול הגישה לחשבונות משתמשים (
roles/iam.principalAccessBoundaryAdmin) בארגון. להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.התפקיד שמוגדר מראש מכיל את ההרשאה
iam.principalaccessboundarypolicies.update, שנדרשת כדי לערוך מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB).יכול להיות שתוכלו לקבל את ההרשאה הזו גם בתפקידים בהתאמה אישית או בתפקידים אחרים שמוגדרים מראש.
תפקידים שנדרשים לעריכת קישורים של מדיניות לקביעת גבול הגישה לחשבונות משתמשים
ההרשאות שנדרשות כדי לערוך את הקישורים למדיניות לקביעת גבול הגישה לחשבונות משתמשים תלויות בקבוצת החשבונות שקשורה למדיניות.
כדי לקבל את ההרשאות שדרושות לעריכת קישורי מדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:
-
גבול הגישה של הגורם המרכזי משתמש (
roles/iam.principalAccessBoundaryUser) בארגון שלכם -
עריכת קשרי מדיניות (policy bindings) של מדיניות גבולות גישה של חשבונות ראשיים שקשורים למאגרי זהויות של כוח עבודה:
IAM Workforce Pool Admin (
roles/iam.workforcePoolAdmin) במאגר הזהויות של כוח העבודה -
עריכת קשרי מדיניות למדיניות של גבולות גישה של חשבונות ראשיים שקשורים למאגרי זהויות של עומסי עבודה:
אדמין של מאגר זהויות של עומסי עבודה ב-IAM (
roles/iam.workloadIdentityPoolAdmin) בפרויקט שבבעלותו מאגר הזהויות של עומסי העבודה -
כדי לקבל את הסטטוס של פעולה ממושכת לעריכת קישור שמפנה למאגר זהויות של עומסי עבודה:
IAM Operation Viewer (
roles/iam.operationViewer) בפרויקט שבבעלותו מאגר הזהויות של עומסי עבודה -
עריכת קשרי מדיניות למדיניות של גבולות גישה של חשבונות משתמשים שקשורים לדומיין ב-Google Workspace:
אדמין IAM של מאגר Workspace (
roles/iam.workspacePoolAdmin) בארגון -
עריכת מדיניות IAM שמקושרת לפרויקט וקובעת את גבול הגישה לחשבונות משתמשים שמשויכים לפרויקט:
אדמין IAM של פרויקט (
roles/resourcemanager.projectIamAdmin) בפרויקט -
כדי לקבל את הסטטוס של פעולה ממושכת לעריכת קישור שמפנה לקבוצת חשבונות משתמש בפרויקט:
IAM Operation Viewer (
roles/iam.operationViewer) on the project -
עריכת קישורי מדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים שקשורים לקבוצת החשבונות של תיקייה:
אדמין IAM של תיקייה (
roles/resourcemanager.folderIamAdmin) בתיקייה -
עריכת קשרי מדיניות למדיניות לקביעת גבול הגישה לחשבונות משתמשים שקשורה לקבוצת חשבונות משתמשים בארגון:
אדמין ארגוני (
roles/resourcemanager.organizationAdmin) בארגון
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים המוגדרים מראש האלה מכילים את ההרשאות שנדרשות לעריכת קישורי מדיניות עבור מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי לערוך את הקישורים למדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), נדרשות ההרשאות הבאות:
-
iam.principalaccessboundarypolicies.bindבארגון -
עריכת קשרי מדיניות למדיניות של גבולות גישה של ישויות שקשורות למאגרי זהויות של כוח עבודה:
iam.workforcePools.updatePolicyBindingבמאגר הזהויות של כוח העבודה -
עריכת קשרי מדיניות למדיניות של גבולות גישה של ישויות שקשורים למאגרי זהויות של עומסי עבודה:
iam.workloadIdentityPools.updatePolicyBindingבפרויקט שבבעלותו מאגר הזהויות של עומסי העבודה -
קבלת הסטטוס של פעולה ממושכת לעריכת קישור שמפנה למאגר זהויות של עומסי עבודה:
iam.operations.getבפרויקט שבבעלותו מאגר הזהויות של עומסי עבודה -
עריכת מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שקשורה לדומיין Google Workspace:
iam.workspacePools.updatePolicyBindingבארגון -
עריכת קישורי מדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים שקשורה לקבוצת החשבונות הראשיים של הפרויקט:
resourcemanager.projects.updatePolicyBindingבפרויקט -
כדי לקבל את הסטטוס של פעולה ממושכת לעריכת קישור שמפנה לקבוצת חשבונות משתמש בפרויקט:
iam.operations.getבפרויקט -
עורכים את הקישורים למדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שקשורה לקבוצת החשבונות הראשיים של התיקייה:
resourcemanager.folders.updatePolicyBindingבתיקייה -
עורכים את הקישורים למדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים שקשורה לקבוצת חשבונות משתמשים של הארגון:
resourcemanager.organizations.updatePolicyBindingבארגון
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
עריכה של מדיניות קיימת לקביעת גבול הגישה לחשבונות משתמשים
כדי להוסיף כללים למדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), להסיר כללים ממדיניות לקביעת גבול הגישה לחשבונות משתמשים או לשנות את המטא-נתונים של מדיניות לקביעת גבול הגישה לחשבונות משתמשים, צריך לערוך את המדיניות לקביעת גבול הגישה לחשבונות משתמשים.
אפשר לערוך מדיניות של גבולות גישה של ישויות באמצעות Google Cloud המסוף, ה-CLI של gcloud או API בארכיטקטורת REST של IAM.
המסוף
נכנסים לדף Principal Access Boundary policies במסוף Google Cloud .
בוחרים את הארגון שבבעלותו מדיניות הגבלת הגישה לחשבון הראשי שרוצים לערוך.
לוחצים על מזהה המדיניות של המדיניות לקביעת גבול הגישה לחשבונות משתמשים שרוצים לערוך.
לוחצים על עריכת המדיניות.
כדי לערוך את הכללים של המדיניות:
- לוחצים על הכלל שרוצים לערוך.
- עורכים את התיאור של הכלל או את המשאבים שנכללים בו.
- לוחצים על סיום.
כדי למחוק כלל מהמדיניות, לוחצים על מחיקה בשורה של הכלל.
כדי לערוך את השם המוצג של המדיניות, עורכים את השדה שם מוצג.
כדי לערוך את גרסת האכיפה של המדיניות, לוחצים על הרשימה גרסת האכיפה ובוחרים ערך חדש.
אם רוצים לבדוק את השינויים במדיניות של גבולות הגישה של חשבון המשתמש באמצעות סימולטור המדיניות, לוחצים על בדיקת שינויים. בודקים את תוצאות הסימולציה ומעדכנים את המדיניות לפי הצורך.
מידע נוסף על בדיקת מדיניות של גבולות גישה של גורמים מרכזיים באמצעות סימולטור המדיניות זמין במאמר סימולטור המדיניות בנושא מדיניות של גבולות גישה של גורמים מרכזיים.
לוחצים על Save.
gcloud
הפקודה
gcloud iam principal-access-boundary-policies updateמעדכנת מדיניות קיימת לקביעת גבול הגישה לחשבונות משתמשים (PAB).לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
PAB_POLICY_ID: המזהה של מדיניות גבולות הגישה של החשבון הראשי שרוצים לעדכן. לדוגמה:example-policy. -
ORG_ID: המזהה של הארגון שבבעלותו מדיניות גבולות הגישה של החשבון הראשי. מזהי ארגונים הם מספרים, למשל123456789012. -
FIELD_TO_UPDATE=UPDATED_VALUE: השדות שרוצים לעדכן והערך המעודכן המתאים.אלה דוגמאות לדגלים שאפשר להשתמש בהם כדי לעדכן את השדות במדיניות:
-
--display-name=DISPLAY_NAME: מחליפים את השם המוצג של המדיניות ב-DISPLAY_NAME. -
--details-enforcement-version=ENFORCEMENT_VERSION: עדכון גרסת האכיפה של המדיניות לערךENFORCEMENT_VERSION. -
--details-rules=RULES_FILE.json: החלפת הכללים במדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) בכללים שב-RULES_FILE.json. הסבר על הפורמט של קובץ הכללים מופיע במאמר יצירת מדיניות של גבולות גישה לחשבונות ראשיים.אם משתמשים בדגל הזה, אי אפשר להשתמש בדגל
--add-details-rules. -
--add-details-rules=RULES_FILE: הוספת הכללים ב-RULES_FILE.jsonלכללים הקיימים במדיניות. הסבר על הפורמט של קובץ הכללים מופיע במאמר יצירת מדיניות של גבולות גישה לחשבונות ראשיים.אם משתמשים בדגל הזה, אי אפשר להשתמש בדגל
--details-rules. -
--remove-details-rules=RULES_FILE: מסירים את הכללים ב-RULES_FILE.jsonמהכללים הקיימים במדיניות. הסבר על הפורמט של קובץ הכללים מופיע במאמר יצירת מדיניות של גבולות גישה לחשבונות ראשיים. רק כללים שתואמים בדיוק לאחד הכללים ב-RULES_FILE.jsonיוסרו.אם משתמשים בדגל הזה, אי אפשר להשתמש בדגל
--clear-rule-details. -
--clear-details-rules: מחיקת כל הכללים ממדיניות גבול הגישה לחשבונות משתמשים.אם משתמשים בדגל הזה, אי אפשר להשתמש בדגל
--remove-rule-details.
רשימה מלאה של הדגלים שאפשר להשתמש בהם כדי לעדכן מדיניות של גבולות גישה של ישויות מופיעה בדף העזרה של הפקודה
gcloud iam principal-access-boundary-policies update. -
FORMAT: הפורמט של התגובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam principal-access-boundary-policies update PAB_POLICY_ID \ --organization=ORG_ID --location=global \ --FIELD_TO_UPDATE=UPDATED_VALUE \ --format=FORMAT
Windows (PowerShell)
gcloud iam principal-access-boundary-policies update PAB_POLICY_ID ` --organization=ORG_ID --location=global ` --FIELD_TO_UPDATE=UPDATED_VALUE ` --format=FORMAT
Windows (cmd.exe)
gcloud iam principal-access-boundary-policies update PAB_POLICY_ID ^ --organization=ORG_ID --location=global ^ --FIELD_TO_UPDATE=UPDATED_VALUE ^ --format=FORMAT
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. אחרי שהפעולה מסתיימת, התגובה מדפיסה את המדיניות המעודכנת לקביעת גבול הגישה לחשבונות משתמשים (PAB).
Request issued for: [example-policy] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374208720-6181fae5e2034-2d8a712b-5c92e5b9] to complete...done. Updated principalAccessBoundaryPolicy [example-policy]. { "name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy", "uid": "puid_13364150419245236225", "etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"", "displayName": "Updated display name", "createTime": "2024-05-07T00:05:48.295209Z", "updateTime": "2024-05-10T20:50:09.200421Z", "details": [ "rules": { [ "description": "Make principals eligible to access example.com" "resources": { "//cloudresourcemanager.googleapis.com/organizations/123456789012" }, "effect": ALLOW ] }, "enforcementVersion": "1" ] }REST
השיטה
principalAccessBoundaryPolicies.patchמעדכנת מדיניות קיימת לקביעת גבול הגישה לחשבונות משתמשים (PAB).לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
ORG_ID: המזהה של הארגון שבבעלותו מדיניות גבולות הגישה של החשבון הראשי. מזהי ארגונים הם מספרים, למשל123456789012. -
PAB_POLICY_ID: המזהה של מדיניות גבולות הגישה של החשבון הראשי שרוצים לעדכן. לדוגמה:example-policy. -
FIELDS_TO_UPDATE: רשימה מופרדת בפסיקים של השדות שרוצים לעדכן. אם לא מציינים את השדות לעדכון, IAM מחליף את המדיניות הקיימת בתוכן של גוף הבקשה.הערכים הקבילים הם
displayName, details,details.rules, details.rules.description,details.rules.resources, details.rules.effectו-details.enforcementVersion. -
DISPLAY_NAME: אופציונלי. תיאור של המדיניות לקביעת גבול הגישה לחשבונות משתמשים שקריא לאנשים – לדוגמה,Example policy. השם המוצג יכול לכלול עד 63 תווים. -
PAB_RULES: רשימה של כללים לקביעת גבול הגישה לחשבונות משתמשים, שמגדירים את המשאבים שחשבונות המשתמשים המושפעים יכולים לגשת אליהם. מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) יכולה לכלול עד 500 כללים. כל כלל הוא בפורמט הבא:{ "description": "DESCRIPTION", "resources": [ RESOURCES ], "effect": ALLOW }
מחליפים את הערכים הבאים:
-
DESCRIPTION: אופציונלי. התיאור של כלל המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). התיאור יכול להכיל עד 256 תווים. -
RESOURCES: רשימה של משאבי מנהל המשאבים (פרויקטים, תיקיות וארגונים) שרוצים שישויות מורשות יוכלו לגשת אליהם. כל חשבון משתמש שחל עליו כלל המדיניות הזה יכול לגשת למשאבים האלה.כל מדיניות לקביעת גבול הגישה לחשבונות משתמשים יכולה להפנות ל-500 משאבים לכל היותר בכל הכללים במדיניות.
-
-
ENFORCEMENT_VERSION: הגרסה של המדיניות לקביעת גבול הגישה לחשבונות משתמשים שבה נעשה שימוש ב-IAM כשמחילים את המדיניות. גרסת האכיפה קובעת אילו הרשאות נאכפות על ידי IAM במסגרת המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB).הערכים הקבילים הם
1,2,3ו-latest.מידע נוסף על גרסאות אכיפה זמין במאמר גרסאות אכיפה של גבולות גישה של חשבונות משתמש.
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID?updateMask=FIELDS_TO_UPDATE
תוכן בקשת JSON:
{ "displayName": DISPLAY_NAME, "details": { "rules": [ PAB_RULES ], "enforcementVersion": "ENFORCEMENT_VERSION", } }כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. הסבר על קבלת הסטטוס של פעולה ממושכת מופיע בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.
{ "name": "organizations/123456789012/locations/global/operations/operation-1715626721931-6185a7953ef76-76f80ee4-19cd1bf7", "metadata": { "@type": "type.googleapis.com/google.iam.v3.OperationMetadata", "createTime": "2024-05-13T18:58:43.721277235Z", "target": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy", "verb": "update", "requestedCancellation": false, "apiVersion": "v3" }, "done": false }שינוי החשבונות שחלה עליהם המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
אחרי שיוצרים קישור מדיניות למדיניות לקביעת גבול הגישה לחשבונות משתמשים, אי אפשר לשנות את מזהה המדיניות או את קבוצת חשבונות המשתמשים בקישור. לכן, אם רוצים לשנות את מי שחלה עליו מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), צריך לבצע אחת מהפעולות הבאות:
- כדי לשנות את קבוצת החשבונות הראשיים שעליהם חלה המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), אפשר לשנות את התנאים בקישור למדיניות. כדי לשנות את התנאים בקישור, עורכים את קישור המדיניות.
- כדי לאכוף את המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) על קבוצה נוספת של חשבונות משתמשים, יוצרים קישור מדיניות חדש שמקשר את המדיניות לקבוצה הזו של חשבונות משתמשים.
- כדי להסיר מדיניות לקביעת גבול הגישה לחשבונות משתמשים מקבוצת חשבונות משתמשים, מוחקים את קישור המדיניות שמקשר את המדיניות לקבוצת החשבונות.
עריכה של קישורי מדיניות קיימים למדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
אחרי שיוצרים קישור למדיניות, אפשר לערוך את הקישור כדי לשנות את התנאים או את השם המוצג שלו.
אפשר לערוך את הקישור למדיניות באמצעות מסוף Google Cloud , ה-CLI של gcloud או IAM API בארכיטקטורת REST.
המסוף
נכנסים לדף Principal Access Boundary policies במסוף Google Cloud .
בוחרים את הארגון שבבעלותו מדיניות הגבלת הגישה לחשבון הראשי שרוצים לערוך.
לוחצים על מזהה המדיניות של המדיניות לקביעת גבול הגישה לחשבונות משתמשים שרוצים לערוך את הקישורים שלה.
לוחצים על הכרטיסייה Bindings (קישורים).
מאתרים את המזהה של הקישור שרוצים לערוך. בשורה של הקישור, לוחצים על פעולות ואז על עריכת הקישור.
כדי לעדכן את השם המוצג של הקישור, עורכים את השדה שם לתצוגה.
כדי להוסיף תנאי לקישור:
- לוחצים על הוספת תנאי.
- בשדה כותרת, מזינים סיכום קצר של מטרת התנאי.
- אופציונלי: בשדה Description, מזינים תיאור ארוך יותר של התנאי.
- בשדה Expression (ביטוי), מזינים ביטוי של תנאי שמשתמש בתחביר של Common Expression Language (CEL). הביטוי צריך להתייחס אל המאפיינים
principal.typeאוprincipal.subject. אין תמיכה במאפיינים אחרים. - לוחצים על Save.
כדי לעדכן תנאי קיים:
- לצד שם התנאי, לוחצים על עריכת התנאי.
- מעדכנים את הכותרת, התיאור או הביטוי של התנאי.
- לוחצים על Save.
אופציונלי: כדי לבדוק את השינויים שביצעתם בהתקשרות של מדיניות הגבלת הגישה של חשבון המשתמש באמצעות סימולטור המדיניות, לוחצים על בדיקת שינויים. בודקים את תוצאות הסימולציה ומעדכנים את שיוך המדיניות לפי הצורך.
מידע נוסף על בדיקת מדיניות של גבולות גישה של גורמים מרכזיים באמצעות סימולטור המדיניות זמין במאמר סימולטור המדיניות בנושא מדיניות של גבולות גישה של גורמים מרכזיים.
כדי לשמור את השינויים, לוחצים על שמירה.
gcloud
הפקודה
gcloud iam policy-bindings updateמעדכנת קישור מדיניות קיים.לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
BINDING_ID: המזהה של מדיניות ה-IAM שרוצים לעדכן. לדוגמה:example-binding. -
RESOURCE_TYPE: סוג המשאב במנהל המשאבים (פרויקט, תיקייה או ארגון) שה-policy binding הוא צאצא שלו. אפשר להשתמש בערךproject,folderאוorganizationסוג המשאב תלוי בישות העיקרית שמוגדרת בקשירת המדיניות. כדי לראות באיזה סוג משאב צריך להשתמש, אפשר לעיין במאמר סוגי חשבונות משתמש נתמכים.
-
RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שהקישור למדיניות הוא צאצא שלהם. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות וארגונים מכילים רק ספרות, למשל123456789012. -
FIELD_TO_UPDATE=UPDATED_VALUE: השדות שרוצים לעדכן והערך המעודכן המתאים.אלה דוגמאות לדגלים שאפשר להשתמש בהם כדי לעדכן את השדות בקישור מדיניות:
-
--display-name=DISPLAY_NAME: מחליפים את השם המוצג של הקישור ב---display-name=DISPLAY_NAME.DISPLAY_NAME -
--condition-description=CONDITION_DESCRIPTION: אם לקישור יש תנאי, מחליפים את תיאור התנאי ב-CONDITION_DESCRIPTION. אחרת, מוסיפים תנאי חדש לקשירה עם התיאור שצוין. אם משתמשים בדגל הזה כדי לעדכן קשר שאין לו תנאי, צריך להגדיר גם את הדגל--condition-expression. -
--condition-expression=CONDITION_EXPRESSION: אם לקישור יש תנאי, מחליפים את ביטוי התנאי ב-CONDITION_EXPRESSION. אחרת, מוסיפים תנאי חדש לקשירה עם הביטוי שצוין. -
--condition-title=CONDITION_TITLE: אם לקישור יש תנאי, מחליפים את שם התנאי ב-CONDITION_TITLE. אחרת, מוסיפים תנאי חדש לקשירה עם הכותרת שצוינה. אם משתמשים בדגל הזה כדי לעדכן קשר שלא מוגדרת לו תנאי, צריך להגדיר גם את הדגל--condition-expression.
רשימה מלאה של השדות שאפשר לעדכן מופיעה בדף העזרה של הפקודה
gcloud iam policy-bindings update. -
FORMAT: הפורמט של התגובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam policy-bindings update BINDING_ID \ --RESOURCE_TYPE=RESOURCE_ID --location=global \ --FIELD_TO_UPDATE=UPDATED_VALUE \ --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings update BINDING_ID ` --RESOURCE_TYPE=RESOURCE_ID --location=global ` --FIELD_TO_UPDATE=UPDATED_VALUE ` --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings update BINDING_ID ^ --RESOURCE_TYPE=RESOURCE_ID --location=global ^ --FIELD_TO_UPDATE=UPDATED_VALUE ^ --format=FORMAT
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. הסבר על קבלת הסטטוס של פעולה ממושכת מופיע בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.
Update request issued for: [my-binding] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374545618-6181fc272c6f9-55ff07f4-97d0ac76] to complete...done. Updated policyBinding [my-binding]. { "createTime": "2024-05-06T18:08:24.729843Z", "displayName": "Updated display name", "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:11:16.798841Z" }REST
השיטה
policyBindings.patchמעדכנת קישור מדיניות קיים.לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
RESOURCE_TYPE: סוג המשאב במנהל המשאבים (פרויקט, תיקייה או ארגון) שה-policy binding הוא צאצא שלו. אפשר להשתמש בערךprojects,foldersאוorganizationsסוג המשאב תלוי בישות העיקרית שמוגדרת בקשירת המדיניות. כדי לראות באיזה סוג משאב צריך להשתמש, אפשר לעיין במאמר סוגי חשבונות משתמש נתמכים.
-
RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שהקישור למדיניות הוא צאצא שלהם. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות וארגונים מכילים רק ספרות, למשל123456789012. -
BINDING_ID: המזהה של מדיניות ה-IAM שרוצים לעדכן. לדוגמה:example-binding. -
FIELDS_TO_UPDATE: רשימה מופרדת בפסיקים של השדות שרוצים לעדכן. אם לא מציינים את השדות לעדכון, IAM מחליף את הקישור הקיים בתוכן של גוף הבקשה.הערכים הקבילים הם
displayName,condition,condition.expression,condition.titleו-condition.description. -
DISPLAY_NAME: אופציונלי. תיאור קריא של הקישור – לדוגמה,Example binding. השם המוצג יכול לכלול עד 63 תווים. -
CONDITION_DETAILS: אופציונלי. ביטוי תנאי שמציין לאילו חשבונות משתמשים מתוך קבוצת חשבונות המשתמשים נאכפת המדיניות לקביעת גבול הגישה לחשבונות משתמשים. הוא מכיל את השדות הבאים:-
expression: ביטוי תנאי שמשתמש בתחביר של Common Expression Language (CEL). הביטוי צריך להתייחס למאפייניםprincipal.typeאוprincipal.subject. אין תמיכה במאפיינים אחרים.הביטוי יכול להכיל עד 10 אופרטורים לוגיים (
&&,||,!) ואורכו יכול להיות עד 250 תווים. -
title: אופציונלי. סיכום קצר של מטרת התנאי. -
description: אופציונלי. תיאור ארוך יותר של התנאי.
-
ה-method של ה-HTTP וכתובת ה-URL:
POST https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID?updateMask=FIELDS_TO_UPDATE
תוכן בקשת JSON:
{ "displayName": DISPLAY_NAME, "condition": { CONDITION_DETAILS } }כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. הסבר על קבלת הסטטוס של פעולה ממושכת מופיע בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.
{ "name": "organizations/123456789012/locations/global/operations/operation-1715373159010-6181f6fcccfa7-dcd0055c-00c22cad", "metadata": { "@type": "type.googleapis.com/google.iam.v3.OperationMetadata", "createTime": "2024-05-10T20:32:39.254910121Z", "target": "organizations/123456789012/locations/global/policyBindings/example-binding", "verb": "update", "requestedCancellation": false, "apiVersion": "v3" }, "done": false }בדיקת הסטטוס של פעולה ממושכת
כשמשתמשים ב-API בארכיטקטורת REST או בספריות הלקוח, כל שיטה שמשנה מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) או קשירה מחזירה פעולה ממושכת (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/principalAccessBoundaryPolicies/example-policy", "verb": "create", "requestedCancellation": false, "apiVersion": "v3" }, "done": true, "response": { PAB_POLICY } }אם השדה
doneשל הפעולה לא מופיע, אפשר לבצע את הפעולה שוב ושוב כדי להמשיך לעקוב אחר הסטטוס שלה. צריך להשתמש בהשהיה מעריכית קטועה לפני ניסיון חוזר כדי ליצור עיכוב בין כל בקשה. כשהערך של השדהdoneמוגדר בתורtrue, הפעולה הושלמה ואפשר להפסיק לבצע אותה.המאמרים הבאים
- יצירה של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) והחלתה
- איך צופים במדיניות לקביעת גבול הגישה לחשבונות משתמשים
- הסרת מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2026-03-05 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["התוכן קשה להבנה","hardToUnderstand","thumb-down"],["שגיאות בקוד לדוגמה או במידע","incorrectInformationOrSampleCode","thumb-down"],["חסרים לי פרטים או דוגמאות","missingTheInformationSamplesINeed","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2026-03-05 (שעון UTC)."],[],[]]