עריכה של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)

כללי מדיניות של בקרת גישה לישויות מורשות (PAB) מאפשרים להגביל את המשאבים שקבוצה של חשבונות משתמשים יכולה לגשת אליהם. בדף הזה מוסבר איך לערוך כללי מדיניות קיימים לקביעת גבול הגישה לחשבונות משתמשים (PAB), ואיך לערוך את קישורי המדיניות של כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) כדי לשנות את המשתמשים שהמדיניות חלה עליהם.

לפני שמתחילים

התפקידים שנדרשים כדי לערוך את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)

כדי לקבל את ההרשאה שנדרשת לעריכת מדיניות PAB, צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (roles/iam.principalAccessBoundaryAdmin) ב-IAM בארגון. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה כולל את ההרשאה iam.principalaccessboundarypolicies.update, שנדרשת כדי לערוך את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB).

יכול להיות שתוכלו לקבל את ההרשאה הזו גם בתפקידים בהתאמה אישית או בתפקידים מוגדרים מראש.

התפקידים שנדרשים כדי לערוך את הקישורים של מדיניות PAB

ההרשאות שנדרשות כדי לערוך את קישורי המדיניות של כללי מדיניות PAB תלויות בקבוצת החשבונות שמשויכת למדיניות.

כדי לקבל את ההרשאות שדרושות לעריכת קישורי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), צריך לבקש מהאדמין את התפקידים הבאים ב-IAM:

  • משתמש בבקרת גישה לישויות מורשות (PAB) (roles/iam.principalAccessBoundaryUser) בארגון
  • עריכת קישורי מדיניות של מדיניות PAB שמקושרת למאגרי זהויות של כוח עבודה: אדמין של מאגר כוח עבודה ב-IAM (roles/iam.workforcePoolAdmin) במאגר הזהויות של כוח העבודה הרלוונטי
  • עריכת קישורי מדיניות של מדיניות PAB שמקושרת למאגרי זהויות של עומסי עבודה: אדמין של מאגר זהויות של עומסי עבודה ב-IAM (roles/iam.workloadIdentityPoolAdmin) בפרויקט שבבעלותו מאגר הזהויות של עומסי העבודה.
  • כדי לקבל את הסטטוס של פעולה ארוכת-טווח לעריכת קישור שמפנה למאגר זהויות של עומסי עבודה: צפייה בפעולות IAM (roles/iam.operationViewer) בפרויקט שבבעלותו מאגר הזהויות של עומסי העבודה המטורגט
  • עריכת קישורי מדיניות של מדיניות PAB שמקושרת לדומיין ב-Google Workspace: אדמין IAM של מאגר Workspace (roles/iam.workspacePoolAdmin) בארגון
  • עריכת קישורי המדיניות של מדיניות PAB שמקושרת לקבוצת חשבונות המשתמשים של הפרויקט: אדמין IAM של פרויקט (roles/resourcemanager.projectIamAdmin) בפרויקט
  • כדי לקבל את הסטטוס של פעולה ממושכת לעריכת קישור שמפנה לקבוצת חשבונות המשתמשים של הפרויקט: צפייה בפעולות IAM (roles/iam.operationViewer) בפרויקט
  • עריכת קישורי מדיניות של מדיניות PAB שמקושרת לקבוצת חשבונות המשתמשים של התיקייה: אדמין IAM של תיקיות (roles/resourcemanager.folderIamAdmin) בתיקייה
  • כדי לערוך את קישורי המדיניות של מדיניות PAB שמקושרת לקבוצת חשבונות המשתמשים של הארגון: אדמין ארגוני (roles/resourcemanager.organizationAdmin) בארגון

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות כדי לערוך את קישורי המדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:

ההרשאות הנדרשות

כדי לערוך את קישורי המדיניות של כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), נדרשות ההרשאות הבאות:

  • ‫iam.principalaccessboundarypolicies.bind בארגון
  • עריכת קישורי המדיניות של מדיניות PAB שמקושרת למאגרי זהויות של כוח עבודה: iam.workforcePools.updatePolicyBinding במאגר הזהויות של כוח העבודה הרלוונטי
  • עריכת קישורי המדיניות של כללי מדיניות PAB שמקושרים למאגרי זהויות של עומסי עבודה: iam.workloadIdentityPools.updatePolicyBinding בפרויקט שבבעלותו מאגר הזהויות של עומסי העבודה הרלוונטי
  • קבלת הסטטוס של פעולה ממושכת לעריכת קישור שמפנה למאגר זהויות של עומסי עבודה: iam.operations.get בפרויקט שבבעלותו מאגר הזהויות של עומסי העבודה המטורגט
  • עריכת קישורי מדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמקושרת לדומיין ב-Google Workspace: iam.workspacePools.updatePolicyBinding בארגון
  • עריכת קישורי המדיניות של כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמקושרים לקבוצת חשבונות המשתמשים של הפרויקט: resourcemanager.projects.updatePolicyBinding בפרויקט
  • איך מקבלים את הסטטוס של פעולה ממושכת לעריכת קישור שמפנה לקבוצת חשבונות המשתמשים של הפרויקט: ‫iam.operations.get בפרויקט
  • עריכת קישורי מדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמקושרת לקבוצת חשבונות המשתמשים של התיקייה: resourcemanager.folders.updatePolicyBinding בתיקייה
  • עריכת קישורי מדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שקשורה לקבוצת חשבונות המשתמשים של הארגון: resourcemanager.organizations.updatePolicyBinding בארגון

יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

עריכת מדיניות קיימת לקביעת גבול הגישה לחשבונות משתמשים (PAB)

כדי להוסיף כללים למדיניות PAB, להסיר כללים ממדיניות PAB או לשנות את המטא-נתונים של מדיניות PAB, צריך לערוך את מדיניות ה-PAB.

אפשר לערוך מדיניות PAB באמצעות מסוף Google Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.

המסוף

  1. נכנסים לדף Principal Access Boundary policies במסוף Google Cloud .

    לדף Principal Access Boundary policies

  2. בוחרים את הארגון שבבעלותו נמצאת מדיניות ה-PAB שרוצים לערוך.

  3. לוחצים על מזהה המדיניות של המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שרוצים לערוך.

  4. לוחצים על עריכת המדיניות.

  5. כדי לערוך את הכללים של המדיניות, מבצעים את הפעולות הבאות:

    1. לוחצים על הכלל שרוצים לערוך.
    2. עורכים את התיאור של הכלל או את המשאבים שכלולים בו.
    3. לוחצים על סיום.
  6. כדי למחוק כלל מהמדיניות, לוחצים על Delete בשורה של הכלל.

  7. כדי לערוך את השם המוצג של המדיניות, עורכים את השדה Display name.

  8. כדי לערוך את גרסת האכיפה של המדיניות, לוחצים על הרשימה Enforcement version ובוחרים ערך חדש.

  9. אופציונלי: כדי לבדוק את השינויים במדיניות לקביעת גבול הגישה לחשבונות משתמשים באמצעות סימולטור המדיניות, לוחצים על Test changes. בודקים את תוצאות הסימולציה ומעדכנים את המדיניות לפי הצורך.

    למידע נוסף על בדיקת כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים באמצעות סימולטור המדיניות, קראו את המאמר סימולטור המדיניות לכללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים.

  10. לוחצים על Save.

gcloud

הפקודה gcloud iam principal-access-boundary-policies update מעדכנת מדיניות קיימת לקביעת גבול הגישה לחשבונות משתמשים (PAB).

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

  • ‫PAB_POLICY_ID: המזהה של מדיניות גבול הגישה לחשבונות משתמשים שרוצים לעדכן, לדוגמה example-policy.
  • ‫ORG_ID: המזהה של הארגון שבבעלותו המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). מזהי ארגונים הם מספרים, למשל 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. במאמר יצירת מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) מוסבר איך ליצור את קובץ הכללים בפורמט הנכון.

      אם משתמשים בדגל הזה, אי אפשר להשתמש בדגל --add-details-rules.

    • ‫--add-details-rules=RULES_FILE: הוספת הכללים ב-RULES_FILE.json לכללים הקיימים של המדיניות. במאמר יצירת מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) מוסבר איך ליצור את קובץ הכללים בפורמט הנכון.

      אם משתמשים בדגל הזה, אי אפשר להשתמש בדגל --details-rules.

    • ‫--remove-details-rules=RULES_FILE: הסרת הכללים ב-RULES_FILE.json מהכללים הקיימים של המדיניות. במאמר יצירת מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) מוסבר איך ליצור את קובץ הכללים בפורמט הנכון. יוסרו רק כללים שתואמים בדיוק לאחד מהכללים ב-RULES_FILE.json.

      אם משתמשים בדגל הזה, אי אפשר להשתמש בדגל --clear-rule-details.

    • ‫--clear-details-rules: מחיקת כל הכללים ממדיניות ה-PAB.

      אם משתמשים בדגל הזה, אי אפשר להשתמש בדגל --remove-rule-details.

    רשימה מלאה של הדגלים שבהם אפשר להשתמש כדי לעדכן מדיניות PAB מופיעה בדף העזרה של הפקודה 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: המזהה של הארגון שבבעלותו המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). מזהי ארגונים הם מספרים, למשל 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: אופציונלי. תיאור קריא לאנשים של המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), לדוגמה Example policy. השם המוצג יכול להכיל עד 63 תווים.
  • ‫PAB_RULES: רשימה של כללי בקרת גישה לישויות מורשות, שמגדירים את המשאבים שהישויות המושפעות יכולות לגשת אליהם. מדיניות PAB יכולה לכלול עד 500 כללים. כל כלל הוא בפורמט הבא:

    {
      "description": "DESCRIPTION",
      "resources": [
        RESOURCES
      ],
      "effect": "ALLOW"
    }

    מחליפים את הערכים הבאים:

    • ‫DESCRIPTION: אופציונלי. תיאור כלל המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). התיאור יכול להכיל עד 256 תווים.
    • ‫RESOURCES: רשימה של משאבים ב-Resource Manager (פרויקטים, תיקיות וארגונים) שאתם רוצים שלחשבונות המשתמשים תהיה גישה אליהם. כל חשבון משתמש שכפוף למדיניות הזו יכול לגשת למשאבים האלה.

      כל מדיניות PAB יכולה להפנות ל-500 משאבים לכל היותר בכל הכללים שבמדיניות.

  • ‫ENFORCEMENT_VERSION: גרסת המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שבה IAM משתמש כשהוא אוכף את המדיניות. גרסת האכיפה קובעת על אילו הרשאות IAM אוכף את המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB).

    הערכים הקבילים הם 1,‏ 2,‏ 3,‏ 4 ו-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 על קבוצת חשבונות משתמשים נוספת, יוצרים קישור מדיניות חדש שמקשר את המדיניות לקבוצת חשבונות המשתמשים הזו.
  • כדי להסיר מדיניות PAB מקבוצת חשבונות משתמשים, מוחקים את קישור המדיניות שמקשר את המדיניות לקבוצת חשבונות המשתמשים.

עריכת קישורי מדיניות קיימים למדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)

אחרי שיוצרים קישור מדיניות, אפשר לערוך את הקישור כדי לשנות את התנאים או את השם המוצג שלו.

אפשר לערוך קישור מדיניות באמצעות מסוף Google Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.

המסוף

  1. נכנסים לדף Principal Access Boundary policies במסוף Google Cloud .

    לדף Principal Access Boundary policies

  2. בוחרים את הארגון שבבעלותו נמצאת מדיניות ה-PAB שרוצים לערוך.

  3. לוחצים על מזהה המדיניות של המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שרוצים לערוך את הקישורים שלה.

  4. לוחצים על הכרטיסייה Bindings.

  5. מוצאים את המזהה של הקישור שרוצים לערוך. בשורה של הקישור, לוחצים על Actions ואז על Edit binding.

  6. כדי לעדכן את השם המוצג של הקישור, עורכים את השדה Display name.

  7. כדי להוסיף תנאי לקישור:

    1. לוחצים על הוספת תנאי.
    2. בשדה Title, מזינים סיכום קצר של מטרת התנאי.
    3. אופציונלי: בשדה Description, מזינים תיאור ארוך יותר של התנאי.
    4. בשדה Expression, מזינים ביטוי תנאי שמשתמש בתחביר של Common Expression Language ‏(CEL). הביטוי חייב להפנות למאפיינים principal.type או principal.subject. אין תמיכה במאפיינים אחרים.
    5. לוחצים על Save.
  8. כדי לעדכן תנאי קיים:

    1. לוחצים על Edit condition ליד שם התנאי.
    2. מעדכנים את הכותרת, התיאור או הביטוי של התנאי.
    3. לוחצים על Save.
  9. אופציונלי: כדי לבדוק את השינויים בקישור של מדיניות PAB באמצעות סימולטור המדיניות, לוחצים על Test changes. בודקים את תוצאות הסימולציה ומעדכנים את קישור המדיניות לפי הצורך.

    למידע נוסף על בדיקת כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים באמצעות סימולטור המדיניות, קראו את המאמר סימולטור המדיניות לכללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים.

  10. כדי לשמור את השינויים לוחצים על שמירה.

gcloud

הפקודה gcloud iam policy-bindings update מעדכנת קישור מדיניות קיים.

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

  • ‫BINDING_ID: המזהה של קישור המדיניות שרוצים לעדכן, לדוגמה example-binding.
  • ‫RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שקישור המדיניות הוא צאצא שלו. אפשר להשתמש בערך project, folder או organization.

    סוג המשאב תלוי בחשבון המשתמש שמוגדר בקישור המדיניות. כדי לראות באיזה סוג משאב להשתמש, עיינו במאמר סוגי חשבונות משתמשים נתמכים.

  • ‫RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמו my-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל 123456789012.
  • ‫FIELD_TO_UPDATE=UPDATED_VALUE: השדות שרוצים לעדכן והערך המעודכן המתאים.

    הדוגמאות הבאות הן דגלים שאפשר להשתמש בהם כדי לעדכן את השדות בקישור מדיניות:

    • ‫--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: [example-binding]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374545618-6181fc272c6f9-55ff07f4-97d0ac76] to complete...done.
Updated policyBinding [example-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

ה-method policyBindings.patch מעדכנת קישור מדיניות קיים.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שקישור המדיניות הוא צאצא שלו. אפשר להשתמש בערך projects, folders או organizations.

    סוג המשאב תלוי בחשבון המשתמש שמוגדר בקישור המדיניות. כדי לראות באיזה סוג משאב להשתמש, עיינו במאמר סוגי חשבונות משתמשים נתמכים.

  • ‫RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמו my-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל 123456789012.
  • ‫BINDING_ID: המזהה של קישור המדיניות שרוצים לעדכן, לדוגמה example-binding.
  • ‫FIELDS_TO_UPDATE: רשימה מופרדת בפסיקים של השדות שרוצים לעדכן. אם לא מציינים את השדות שרוצים לעדכן, IAM מחליף את הקישור הקיים בתוכן של גוף הבקשה.

    הערכים הקבילים הם displayName,‏ condition,‏ condition.expression,‏ condition.title ו-condition.description.

  • ‫DISPLAY_NAME: אופציונלי. תיאור קריא לאנשים של הקישור, למשל Example binding. השם המוצג יכול להכיל עד 63 תווים.
  • ‫CONDITION_DETAILS: אופציונלי. ביטוי תנאי שמציין על אילו חשבונות משתמשים בקבוצת החשבונות נאכפת המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). מכיל את השדות הבאים:

    • ‫expression: ביטוי תנאי שמשתמש בתחביר של Common Expression Language ‏(CEL). הביטוי חייב להתייחס למאפיינים principal.type או principal.subject. אין תמיכה במאפיינים אחרים.

      הביטוי יכול להכיל עד 10 אופרטורים לוגיים (&&, ||, !), והאורך שלו יכול להיות עד 250 תווים.

    • ‫title: אופציונלי. סיכום קצר של מטרת התנאי.
    • description: אופציונלי. תיאור ארוך יותר של התנאי.

ה-method של ה-HTTP וכתובת ה-URL:

PATCH 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 או בספריות הלקוח, כל שיטה שמשנה מדיניות או קישור מחזירה פעולה ממושכת (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, הפעולה הושלמה ואפשר להפסיק לבצע אותה.

המאמרים הבאים