מערכת גישה מאוחדת לכללי מדיניות (UAP) מאפשרת לכם לתת לחשבונות משתמשים גישה למשאבים ב-Google Cloud או לדחות את הגישה שלהם. אם אתם לא רוצים יותר להחיל מדיניות UAP על משאב, אתם יכולים למחוק את קישור המדיניות שמקשר את המדיניות למשאב. אם רוצים להסיר מדיניות מכל המשאבים שהיא מקושרת אליהם, אפשר למחוק אותה.
לפני שמתחילים
מגדירים אימות.
צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:
המסוף
כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים ולממשקי ה-API של Google Cloud , לא צריך להגדיר אימות.
gcloud
מפעילים את Cloud Shell במסוף Google Cloud .
בחלק התחתון של מסוף Google Cloud יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.
REST
כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.
התקינו את ה-CLI של Google Cloud.
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.
מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .
אופציונלי: קוראים את הסקירה הכללית של מדיניות הגישה המאוחדת.
התפקידים שנדרשים כדי למחוק קישורים של מערכת גישה מאוחדת לכללי מדיניות (UAP)
כדי לקבל את ההרשאות שדרושות למחיקת קישור של UAP, צריך לבקש מהאדמין להקצות את תפקידי ה-IAM הבאים:
- משתמש במדיניות גישה (
roles/iam.accessPolicyUser) במשאב שבבעלות ה-UAP. התפקיד הזה כולל את ההרשאהiam.accesspolicies.unbind, שנדרשת כדי למחוק קישורים. תפקיד שכולל את ההרשאה
SERVICE.RESOURCE.deletePolicyBinding, כאשרRESOURCEהוא סוג המשאב שאליו מקושרת ה-UAP, ו-SERVICEהוא השירות שהמשאב נמצא בבעלותו.כדי למצוא תפקיד שכולל את ההרשאה הנדרשת, מחפשים את ההרשאה בחומר העזר בנושא תפקידים והרשאות, לוחצים על שם ההרשאה ובודקים את התפקידים שכוללים את ההרשאה.
אתם צריכים את התפקיד הזה במשאב או באחד מהאבות הקדמונים שלו.
להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים שנדרשים כדי למחוק את מערכת הגישה המאוחדת לכללי מדיניות (UAP)
כדי לקבל את ההרשאות שדרושות למחיקת מדיניות ה-UAP, בקשו מהאדמין לתת לכם את התפקיד אדמין של מדיניות גישה (roles/iam.accessPolicyAdmin) ב-IAM ברמת הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שאתם רוצים למחוק.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
זהו תפקיד שמוגדר מראש וכולל את ההרשאות שנדרשות למחיקת כללי מדיניות גישה מאוחדת. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי למחוק כללי מדיניות UAP, נדרשות ההרשאות הבאות:
-
iam.accesspolicies.delete -
מחיקת כללי מדיניות ה-UAP במסוף Google Cloud :
-
iam.accesspolicies.get -
iam.accessPolicies.list
-
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
הסרת מדיניות גישה מאוחדת ממשאב
כדי להסיר UAP ממשאב, צריך למחוק את הקישור שמקשר את ה-UAP למשאב. אחרי שמוחקים את הקישור, ה-UAP לא חלה יותר על המשאב או על הצאצאים של המשאב. עם זאת, ה-UAP לא נמחק ואף אחד מהקישורים האחרים שלו לא מושפע.
אפשר למחוק קישורים לפרויקטים, לתיקיות ולארגונים באמצעות מסוףGoogle Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM. כדי למחוק קישורים למשאבים אחרים, צריך להשתמש ב-CLI של gcloud או ב-API בארכיטקטורת REST של IAM.
המסוף
-
נכנסים לדף Unified Access Policies במסוף Google Cloud .
כניסה לדף Unified Access Policies - בוחרים את הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שרוצים להסיר.
- לוחצים על מזהה המדיניות של ה-UAP שרוצים להסיר.
- לוחצים על הכרטיסייה Bindings.
- בטבלה Bindings, מאתרים את השורה שמכילה את הקישור שרוצים להסיר.
- בשורה הזו, לוחצים על התפריט Actions ואז על Delete binding.
- בתיבת הדו-שיח Delete binding, לוחצים על Delete.
gcloud
הפקודה
gcloud iam policy-bindings delete
מוחקת קישור.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
BINDING_ID: המזהה של הקישור שרוצים למחוק, לדוגמהexample-binding. -
BINDING_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שהקישור הוא צאצא שלו. אפשר להשתמש בערךproject,folderאוorganization.משאב ההורה של הקישור תלוי במשאב היעד בקישור. למידע נוסף, קראו את המאמר משאבים נתמכים.
-
BINDING_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam policy-bindings delete BINDING_ID \ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
Windows (PowerShell)
gcloud iam policy-bindings delete BINDING_ID ` --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
Windows (cmd.exe)
gcloud iam policy-bindings delete BINDING_ID ^ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. כדי ללמוד איך לקבל את הסטטוס של פעולה ממושכת, אפשר לעיין בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.
Delete request issued for: [example-binding] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374724030-6181fcd1520c5-d21b0a12-b704e1ce] to complete...done. Deleted policyBinding [example-binding].
REST
ה-method policyBindings.delete מוחקת קישור.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
BINDING_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שהקישור הוא צאצא שלו. אפשר להשתמש בערךprojects,foldersאוorganizations.משאב ההורה של הקישור תלוי במשאב היעד בקישור. למידע נוסף, קראו את המאמר משאבים נתמכים.
-
BINDING_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
BINDING_ID: המזהה של הקישור שרוצים למחוק, לדוגמהexample-binding.
ה-method של ה-HTTP וכתובת ה-URL:
DELETE https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings/BINDING_ID
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. כדי ללמוד איך לקבל את הסטטוס של פעולה ממושכת, אפשר לעיין בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-binding",
"verb": "delete",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
מחיקת מדיניות גישה מאוחדת (UAP)
לפני שמוחקים UAP, צריך לזהות ולמחוק את כל הקישורים הקיימים שמפנים ל-UAP. אם תנסו למחוק UAP בלי למחוק את הקישורים הקיימים, תופיע הודעת שגיאה.
אם רוצים למחוק את ה-UAP בלי למחוק את הקישורים הקיימים, אפשר למחוק את ה-UAP באופן ידני. מחיקה כפויה של UAP מסירה אותו מכל המשאבים שהוא מקושר אליהם. כל הקישורים שמפנים ל-UAP יימחקו בסופו של דבר. עם זאת, עד שהם נמחקים, הקישורים עדיין נכללים במגבלה על מספר הקישורים שיכולים להתייחס למשאב יחיד.
אפשר למחוק את כללי ה-UAP באמצעות מסוף Google Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
המסוף
-
נכנסים לדף Unified Access Policies במסוף Google Cloud .
כניסה לדף Unified Access Policies - בוחרים את הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שרוצים למחוק.
- לוחצים על מזהה המדיניות של ה-UAP שרוצים למחוק.
- לוחצים על מחיקת המדיניות.
- אם ל-UAP יש קישורים קיימים, בוחרים באפשרות Delete this policy and all of its bindings. אם תנסו למחוק מדיניות UAP עם קישורים קיימים בלי לבחור באפשרות הזו, הבקשה תיכשל.
- בתיבת הדו-שיח Delete policy, לוחצים על Delete.
gcloud
הפקודה gcloud iam access-policies delete מוחקת את ה-UAP ואת כל הקישורים המשויכים.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
UAP_ID: המזהה של ה-UAP שרוצים למחוק, לדוגמהexample-policy. -
UAP_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שבבעלותו נמצאת מדיניות ה-UAP שרוצים למחוק. אפשר להשתמש בערךproject,folderאוorganization. -
UAP_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שרוצים למחוק. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
FORCE_FLAG: אופציונלי. כדי לאלץ את הפקודה למחוק מדיניות, גם אם יש הפניות למדיניות הזו בקישורים קיימים, משתמשים בדגל--force. אם הדגל הזה לא מוגדר והמדיניות מקושרת בקישורים קיימים, הפקודה נכשלת.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam access-policies delete UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global \ FORCE_FLAG
Windows (PowerShell)
gcloud iam access-policies delete UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global ` FORCE_FLAG
Windows (cmd.exe)
gcloud iam access-policies delete UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global ^ FORCE_FLAG
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. כדי ללמוד איך לקבל את הסטטוס של פעולה ממושכת, אפשר לעיין בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.
Delete request issued for: [example-policy] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete...done. Deleted accessPolicy [example-policy].
REST
השיטה
accessPolicies.delete
מוחקת את ה-UAP ואת כל הקישורים שמשויכים אליו.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
UAP_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שבבעלותו נמצאת מדיניות ה-UAP שרוצים למחוק. אפשר להשתמש בערךprojects,foldersאוorganizations. -
UAP_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שרוצים למחוק. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
UAP_ID: המזהה של ה-UAP שרוצים למחוק, לדוגמהexample-policy. -
FORCE_DELETE: אופציונלי. כדי לאלץ את הבקשה למחוק את המדיניות, גם אם יש הפניות למדיניות בקישורים קיימים, מוסיפים את הפרמטר של השאילתהforce=true. אם הפרמטר הזה של השאילתה לא מוגדר, והמדיניות מקושרת לקישורים קיימים, הבקשה תיכשל.
ה-method של ה-HTTP וכתובת ה-URL:
DELETE https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID?FORCE_DELETE
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. כדי ללמוד איך לקבל את הסטטוס של פעולה ממושכת, אפשר לעיין בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"verb": "delete",
"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, הפעולה הושלמה ואפשר להפסיק לבצע אותה.
המאמרים הבאים
- יצירה והחלה של כללי מדיניות גישה מאוחדת
- הצגת כללי ה-UAP והקישורים
- עריכת כללי מדיניות ה-UAP והקישורים