יצירה והחלה של מערכת גישה מאוחדת לכללי מדיניות (UAP)

מערכת גישה מאוחדת לכללי מדיניות (UAP) מאפשרת לכם לתת לחשבונות משתמשים גישה למשאבים ב-Google Cloud או לדחות את הגישה שלהם. במאמר הזה מוסבר איך ליצור ולהחיל כללי מדיניות גישה מאוחדת.

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

  1. מגדירים אימות.

    צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:

    המסוף

    כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים ולממשקי ה-API של Google Cloud , לא צריך להגדיר אימות.

    gcloud

    מפעילים את Cloud Shell במסוף Google Cloud .

    הפעלת Cloud Shell

    בחלק התחתון של מסוף Google Cloud יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

    REST

    כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.

      התקינו את ה-CLI של Google Cloud.

      אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.

    מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .

  2. מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud .

  3. אופציונלי: קוראים את הסקירה הכללית של מדיניות הגישה המאוחדת.

התפקידים שנדרשים כדי ליצור כללי מדיניות של UAP

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

זהו תפקיד שמוגדר מראש וכולל את ההרשאות שנדרשות ליצירת כללי מדיניות גישה מאוחדת. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:

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

כדי ליצור כללי UAP, צריך את ההרשאות הבאות:

  • iam.accesspolicies.create
  • יוצרים כללי UAP במסוף Google Cloud : iam.accesspolicies.list

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

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

כדי לקבל את ההרשאות שדרושות לקישור של UAP למשאב, בקשו מהאדמין להקצות לכם את התפקידים הבאים ב-IAM:

  • אדמין של מדיניות גישה (roles/iam.accessPolicyAdmin) במשאב שבבעלות ה-UAP. התפקיד הזה כולל את ההרשאה iam.accesspolicies.bind, שנדרשת כדי ליצור קישורים.
  • תפקיד שכולל את ההרשאה SERVICE.RESOURCE.createPolicyBinding, כאשר RESOURCE הוא סוג המשאב שאליו רוצים לקשר את המדיניות ו-SERVICE הוא השירות שהמשאב נמצא בבעלותו.

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

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

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

יצירת מדיניות גישה מאוחדת (UAP)

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

המסוף

  1. נכנסים לדף Unified Access Policies במסוף Google Cloud .

    כניסה לדף Unified Access Policies
  2. בוחרים את הפרויקט, התיקייה או הארגון שבהם רוצים ליצור את ה-UAP. איפה יוצרים מדיניות UAP?
  3. לוחצים על יצירת מדיניות.
  4. בשדה Policy name, מזינים שם ל-UAP, לדוגמה Example policy. השם יכול להכיל עד 63 תווים.
  5. אופציונלי: בשדה Policy ID, מתאימים אישית את המזהה של ה-UAP.
  6. מוסיפים כללים למדיניות. לכל כלל, מבצעים את הפעולות הבאות:

    1. אופציונלי: בשדה Description, מזינים תיאור לכלל.
    2. בשדה Principals, מזינים את חשבונות המשתמשים שרוצים לכלול בכלל.
    3. אופציונלי: בשדה Excluded principals, מזינים את חשבונות המשתמשים שלא רוצים לכלול בכלל. חשבונות המשתמשים האלה לא ייכללו, גם אם הם חלק מקבוצה בשדה Principals.
    4. בוחרים את ההשפעה הרצויה של הכלל:

      • כדי לתת את ההרשאות שצוינו לחשבונות המשתמשים שצוינו, בוחרים באפקט Allow.
      • כדי למנוע מהחשבונות הראשיים שצוינו להשתמש בהרשאות שצוינו, בוחרים באפקט Deny.
    5. בוחרים את ההרשאות שרוצים לכלול בכלל:

      • בכללים עם ההשפעה Allow, אפשר לציין תפקידים והרשאות שייכללו בכלל או יוחרגו ממנו. מידע נוסף על התפקידים וההרשאות שאפשר לכלול מופיע במאמר תפקידים והרשאות בכללי UAP.
      • בכללים עם האפקט Deny, מציינים את ההרשאות שרוצים לכלול בכלל או להחריג ממנו. במאמר תפקידים והרשאות בכללי UAP מוסבר אילו הרשאות אפשר לכלול.
    6. אופציונלי: מוסיפים תנאים שבהם הכלל יחול. מידע נוסף על מאפייני התנאים הנתמכים מופיע במאמר תנאים ב-UAP.

    7. כשמסיימים לערוך את הכלל, לוחצים על סיום.
  7. כדי להוסיף עוד כלל, לוחצים על הוספת כלל ומוסיפים את פרטי הכלל.
  8. כשמסיימים להוסיף כללים, לוחצים על יצירת מדיניות.

gcloud

הפקודה gcloud iam access-policies create יוצרת UAP.

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

  • ‫UAP_ID: מזהה ייחודי של ה-UAP, לדוגמה example-policy.
  • ‫UAP_PARENT_RESOURCE_TYPE: סוג המשאב ב-Resource Manager (פרויקט, תיקייה או ארגון) שבו רוצים ליצור את ה-UAP. אפשר להשתמש בערך project, folder או organization.
  • ‫UAP_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שבהם רוצים ליצור את ה-UAP. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמו my-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל 123456789012.
  • ‫DISPLAY_NAME: אופציונלי. תיאור קריא לאנשים של ה-UAP, לדוגמה Example policy. השם המוצג יכול להכיל עד 63 תווים.
  • ‫FILE_PATH: הנתיב לקובץ JSON שמכיל את פרטי הכלל של ה-UAP. כל כלל צריך להיות בפורמט הבא:

    {
      "description": "DESCRIPTION",
      "effect": "EFFECT",
      "principals": [
        INCLUDED_PRINCIPALS
      ],
      "excludedPrincipals": [
        EXCLUDED_PRINCIPALS
      ],
      "operation": {
        "permissions": [
          INCLUDED_PERMISSIONS
        ],
        "excludedPermissions": [
          EXCLUDED_PERMISSIONS
        ]
      },
      CONDITIONS
    }

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

    • ‫DESCRIPTION: תיאור קריא לאנשים של הכלל.
    • ‫EFFECT: איך הכלל משפיע על הגישה. הערכים הנתמכים הם ALLOW ו-DENY:

      • ‫ALLOW: הענקת ההרשאות שצוינו לחשבונות המשתמשים שצוינו.
      • DENY: מניעה מחשבונות המשתמשים שצוינו להשתמש בהרשאות שצוינו.
    • מחליפים את הערכים הבאים כדי לציין את חשבונות המשתמשים שכלולים בכלל:

      • ‫INCLUDED_PRINCIPALS: חשבונות המשתמשים שייכללו בכלל.
      • ‫EXCLUDED_PRINCIPALS: אופציונלי. חשבונות המשתמשים שיוחרגו מהכלל, גם אם הם מופיעים ברשימת חשבונות המשתמשים שנכללים. לדוגמה, אפשר להוסיף קבוצה ב-Google לרשימת חשבונות המשתמשים שנכללים, ואז להחריג משתמשים ספציפיים ששייכים לקבוצה הזו.

      רשימת המזהים הנתמכים של חשבונות משתמשים מופיעה במאמר סוגי חשבונות משתמשים ל-UAP.

    • מחליפים את הערכים הבאים כדי לציין את ההרשאות שרוצים לכלול בכלל:

      • ‫INCLUDED_PERMISSIONS: ההרשאות שיהיו בכלל.
      • ‫EXCLUDED_PERMISSIONS: אופציונלי. ההרשאות שרוצים להחריג מהכלל, גם אם הן מופיעות ברשימת ההרשאות שנכללות. לדוגמה, אפשר להוסיף תפקיד לרשימת ההרשאות הכלולות, ואז להחריג הרשאות ספציפיות בתפקיד הזה.

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

    • ‫CONDITIONS: אופציונלי. התנאים שבהם הכלל חל. צריך להשתמש בפורמט הבא:

      "conditions": {
        "SERVICE": {
          "title": "CONDITION_TITLE",
          "description": "CONDITION_DESCRIPTION",
          "expression": "CONDITION_EXPRESSION"
        }
      }
          

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

      • ‫SERVICE: השירות שמספק את המאפיינים שבהם משתמשים בביטוי התנאי.
      • ‫CONDITION_TITLE: אופציונלי. סיכום קצר של מטרת התנאי.
      • ‫CONDITION_DESCRIPTION: אופציונלי. תיאור ארוך יותר של התנאי.
      • ‫CONDITION_EXPRESSION: ביטוי בוליאני שמפנה למאפיינים של ניסיון הגישה, כמו התגים שמצורפים למשאב בניסיון הגישה. אם הביטוי מקבל את הערך true, הכלל חל על ניסיון הגישה. אם תוצאת הבדיקה של התנאי היא false, הכלל לא חל על ניסיון הגישה.

      במאמר מאפייני תנאים נתמכים תוכלו למצוא רשימה של המאפיינים הנתמכים והשירותים שלהם.

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

gcloud iam access-policies create UAP_ID \
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \
    --location=global --display-name=DISPLAY_NAME \
    --details-rules=FILE_PATH

‏Windows (PowerShell)

gcloud iam access-policies create UAP_ID `
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID `
    --location=global --display-name=DISPLAY_NAME `
    --details-rules=FILE_PATH

Windows‏ (cmd.exe)

gcloud iam access-policies create UAP_ID ^
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^
    --location=global --display-name=DISPLAY_NAME ^
    --details-rules=FILE_PATH

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

Create request issued for: [example-policy]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715373988044-6181fa136df85-3b06a30a-4816d25b] to complete...done.
Created accessPolicy [example-policy].

REST

השיטה accessPolicies.create יוצרת מדיניות UAP.

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

  • ‫UAP_PARENT_RESOURCE_TYPE: סוג המשאב ב-Resource Manager (פרויקט, תיקייה או ארגון) שבו רוצים ליצור את ה-UAP. אפשר להשתמש בערך projects, folders או organizations.
  • ‫UAP_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שבהם רוצים ליצור את ה-UAP. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמו my-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל 123456789012.
  • ‫UAP_ID: מזהה ייחודי של ה-UAP, לדוגמה example-policy.
  • ‫DISPLAY_NAME: אופציונלי. תיאור קריא לאנשים של ה-UAP, לדוגמה Example policy. השם המוצג יכול להכיל עד 63 תווים.
  • UAP_RULES: רשימה של כללי UAP שמגדירים את הגישה שצריך לתת או לדחות, ואת חשבונות המשתמשים שצריך לתת להם גישה או לדחות את הגישה שלהם. בכל UAP יכולים להיות עד 100 כללים. כל כלל הוא בפורמט הבא:

    {
      "description": "DESCRIPTION",
      "effect": "EFFECT",
      "principals": [
        INCLUDED_PRINCIPALS
      ],
      "excludedPrincipals": [
        EXCLUDED_PRINCIPALS
      ],
      "operation": {
        "permissions": [
          INCLUDED_PERMISSIONS
        ],
        "excludedPermissions": [
          EXCLUDED_PERMISSIONS
        ]
      },
      CONDITIONS
    }

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

    • ‫DESCRIPTION: תיאור קריא לאנשים של הכלל.
    • ‫EFFECT: איך הכלל משפיע על הגישה. הערכים הנתמכים הם ALLOW ו-DENY:

      • ‫ALLOW: הענקת ההרשאות שצוינו לחשבונות המשתמשים שצוינו.
      • DENY: מניעה מחשבונות המשתמשים שצוינו להשתמש בהרשאות שצוינו.
    • מחליפים את הערכים הבאים כדי לציין את חשבונות המשתמשים שכלולים בכלל:

      • ‫INCLUDED_PRINCIPALS: חשבונות המשתמשים שייכללו בכלל.
      • ‫EXCLUDED_PRINCIPALS: אופציונלי. חשבונות המשתמשים שיוחרגו מהכלל, גם אם הם מופיעים ברשימת חשבונות המשתמשים שנכללים. לדוגמה, אפשר להוסיף קבוצה ב-Google לרשימת חשבונות המשתמשים שנכללים, ואז להחריג משתמשים ספציפיים ששייכים לקבוצה הזו.

      רשימת המזהים הנתמכים של חשבונות משתמשים מופיעה במאמר סוגי חשבונות משתמשים ל-UAP.

    • מחליפים את הערכים הבאים כדי לציין את ההרשאות שרוצים לכלול בכלל:

      • ‫INCLUDED_PERMISSIONS: ההרשאות שיהיו בכלל.
      • ‫EXCLUDED_PERMISSIONS: אופציונלי. ההרשאות שרוצים להחריג מהכלל, גם אם הן מופיעות ברשימת ההרשאות שנכללות. לדוגמה, אפשר להוסיף תפקיד לרשימת ההרשאות הכלולות, ואז להחריג הרשאות ספציפיות בתפקיד הזה.

      כשיוצרים את רשימות ההרשאות האלה, אפשר להפנות לשמות של הרשאות, לשמות של תפקידים ולקבוצות של הרשאות. מידע נוסף זמין במאמר תפקידים והרשאות בכללי UAP.

    • ‫CONDITIONS: אופציונלי. התנאים שבהם הכלל חל. צריך להשתמש בפורמט הבא:

      "conditions": {
        "SERVICE": {
          "title": "CONDITION_TITLE",
          "description": "CONDITION_DESCRIPTION",
          "expression": "CONDITION_EXPRESSION"
        }
      }
          

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

      • ‫SERVICE: השירות שמספק את המאפיינים שבהם משתמשים בביטוי התנאי.
      • ‫CONDITION_TITLE: אופציונלי. סיכום קצר של מטרת התנאי.
      • ‫CONDITION_DESCRIPTION: אופציונלי. תיאור ארוך יותר של התנאי.
      • ‫CONDITION_EXPRESSION: ביטוי בוליאני שמפנה למאפיינים של ניסיון הגישה, כמו התגים שמצורפים למשאב בניסיון הגישה. אם הערך של הביטוי הוא true, הכלל חל על ניסיון הגישה. אם תוצאת הבדיקה של התנאי היא false, הכלל לא חל על ניסיון הגישה.

      במאמר מאפייני תנאים נתמכים תוכלו למצוא רשימה של המאפיינים הנתמכים והשירותים שלהם.

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

POST https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies?accessPolicyId=UAP_ID

תוכן בקשת JSON:

{
  "displayName": "DISPLAY_NAME",
  "details": {
    "rules": [
      UAP_RULES
    ]
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

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

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2026-05-10T20:32:00.898809495Z",
    "target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

החלת מערכת גישה מאוחדת לכללי מדיניות (UAP) על משאב

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

לפני שיוצרים קישור, צריך לוודא שאילוץ מדיניות הארגון iam.managed.disableAccessPolicyBinding מושבת. במאמר שימוש באילוצים מנוהלים במדיניות הארגון מוסבר איך להפעיל או להשבית את האילוץ הזה.

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

המסוף

  1. נכנסים לדף Unified Access Policies במסוף Google Cloud .

    כניסה לדף Unified Access Policies
  2. בוחרים את הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שרוצים להחיל.
  3. לוחצים על המזהה של ה-UAP שרוצים להחיל.
  4. בוחרים בכרטיסייה Bindings ולוחצים על Add binding.
  5. בחלונית Add binding, עורכים את פרטי הקישור:

    1. בתפריט Binding location, בוחרים את המשאב שעליו רוצים להחיל את ה-UAP.
    2. אופציונלי: בשדה Binding display name, מזינים תיאור קריא לאנשים של הקישור, לדוגמה Example binding. השם המוצג יכול להכיל עד 63 תווים.
    3. בשדה Binding ID, מזינים שם ייחודי לקישור, לדוגמה example-binding.
  6. לוחצים על Add binding.

gcloud

הפקודה gcloud iam policy-bindings create יוצרת קישור.

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

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

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

  • ‫BINDING_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמו my-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל 123456789012.
  • ‫POLICY_PARENT_RESOURCE: המשאב שבו נוצרה ה-UAP, בפורמט RESOURCE_TYPE/RESOURCE_ID. לדוגמה: organizations/0123456789012. אפשר ליצור כללי UAP בפרויקטים, בתיקיות או בארגונים. מזהי תיקיות ומזהי ארגונים חייבים להיות מספריים. מזהי פרויקטים יכולים להיות מספריים או אלפאנומריים.
  • ‫UAP_ID: המזהה של ה-UAP שרוצים לקשר למשאב, לדוגמה example-uap. אי אפשר לשנות את הערך הזה אחרי שיוצרים את הקישור.
  • ‫TARGET_RESOURCE: המשאב שאליו רוצים לקשר את ה-UAP. רשימה של משאבים תקינים מופיעה בקטע משאבים נתמכים. אי אפשר לשנות את הערך הזה אחרי שיוצרים את הקישור.
  • ‫DISPLAY_NAME: אופציונלי. תיאור קריא לאנשים של הקישור, למשל Example binding. השם המוצג יכול להכיל עד 63 תווים.

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

gcloud iam policy-bindings create BINDING_ID \
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global \
    --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" \
    --target-resource=TARGET_RESOURCE \
    --display-name=DISPLAY_NAME

‏Windows (PowerShell)

gcloud iam policy-bindings create BINDING_ID `
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global `
    --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" `
    --target-resource=TARGET_RESOURCE `
    --display-name=DISPLAY_NAME

Windows‏ (cmd.exe)

gcloud iam policy-bindings create BINDING_ID ^
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global ^
    --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" ^
    --target-resource=TARGET_RESOURCE ^
    --display-name=DISPLAY_NAME

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

Create request issued for: [example-binding]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374545618-6181fc272c6f9-55ff07f4-97d0ac76] to complete...done.
Created policyBinding [example-binding].

REST

ה-method‏ policyBindings.create יוצרת קישור.

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

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

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

  • ‫BINDING_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמו my-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל 123456789012.
  • ‫BINDING_ID: שם ייחודי לקישור, לדוגמה example-binding.
  • ‫DISPLAY_NAME: אופציונלי. תיאור קריא לאנשים של הקישור, למשל Example binding. השם המוצג יכול להכיל עד 63 תווים.
  • ‫TARGET_RESOURCE: המשאב שאליו רוצים לקשר את ה-UAP. רשימה של משאבים תקינים מופיעה בקטע משאבים נתמכים. אי אפשר לשנות את הערך הזה אחרי שיוצרים את הקישור.
  • ‫POLICY_PARENT_RESOURCE: המשאב שבו נוצרה ה-UAP, בפורמט RESOURCE_TYPE/RESOURCE_ID. לדוגמה: organizations/0123456789012. אפשר ליצור כללי UAP בפרויקטים, בתיקיות או בארגונים. מזהי תיקיות ומזהי ארגונים חייבים להיות מספריים. מזהי פרויקטים יכולים להיות מספריים או אלפאנומריים.
  • ‫UAP_ID: המזהה של ה-UAP שרוצים לקשר למשאב, לדוגמה example-uap. אי אפשר לשנות את הערך הזה אחרי שיוצרים את הקישור.

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

POST https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings?policyBindingId=BINDING_ID

תוכן בקשת JSON:

{
  "displayName": "DISPLAY_NAME",
  "target": {
    "resource": "TARGET_RESOURCE"
  },
  "policyKind": "ACCESS",
  "policy": "POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID"
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

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

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2026-05-10T20:32:00.898809495Z",
    "target": "organizations/123456789012/locations/global/policyBindings/example-binding",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

בדיקת הסטטוס של פעולה ממושכת

כשמשתמשים ב-API בארכיטקטורת REST או בספריות הלקוח, כל שיטה שמשנה מדיניות או קישור מחזירה פעולה ממושכת (LRO). הפעולה הממושכת עוקבת אחרי הסטטוס של הבקשה ומציינת אם השינוי במדיניות או בקישור הושלם.

REST

השיטה operations.get מחזירה את הסטטוס של פעולה ממושכת.

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

  • ‫OPERATION_NAME: השם המלא של הפעולה. השם הזה מופיע בתגובה לבקשה המקורית.

    הפורמט של שם הפעולה הוא:

    RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
        

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

GET https://iam.googleapis.com/v3/OPERATION_NAME

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-11-28T00:05:12.006289686Z",
    "endTime": "2024-11-28T00:05:12.192141801Z",
    "target": "organizations/314340013352/locations/global/POLICY_TYPE/POLICY_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": true,
  "response": {
    POLICY
  }
}

אם השדה done של הפעולה לא מופיע, אפשר לבצע את הפעולה שוב ושוב כדי להמשיך לעקוב אחר הסטטוס שלה. צריך להשתמש בהשהיה מעריכית (exponential backoff) קטועה לפני ניסיון חוזר כדי ליצור עיכוב בין כל בקשה. כשהערך של השדה done מוגדר בתור true, הפעולה הושלמה ואפשר להפסיק לבצע אותה.

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