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

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

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

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

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

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

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

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

  • הצגת מדיניות אחת לקביעת גבול הגישה לחשבונות משתמשים: iam.principalaccessboundarypolicies.get
  • הצגת רשימה של כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) בארגון: iam.principalaccessboundarypolicies.list

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

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

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

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

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

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

כדי לראות את קישורי המדיניות, נדרשות ההרשאות הבאות:

  • הצגת קישור מדיניות יחיד: 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.

המסוף

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

    לדף Principal Access Boundary policies

  2. בוחרים את הארגון שבו רוצים לראות את כללי המדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (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.

המסוף

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

    לדף Principal Access Boundary policies

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

  3. לוחצים על מזהה המדיניות של המדיניות לקביעת גבול הגישה לחשבונות משתמשים (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 באמצעות מסוףGoogle Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.

המסוף

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

    לדף Principal Access Boundary policies

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

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

  4. לוחצים על הכרטיסייה 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"
}

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