כללי מדיניות של בקרת גישה לישויות מורשות (PAB) מאפשרים להגביל את המשאבים שקבוצה של חשבונות משתמשים יכולה לגשת אליהם. אם אתם לא רוצים יותר לאכוף מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) על קבוצת חשבונות משתמשים, אתם יכולים למחוק את הקישור של המדיניות לקבוצת חשבונות המשתמשים. אם רוצים להסיר מדיניות PAB מכל קבוצות חשבונות המשתמשים שהיא מקושרת אליהן, אפשר למחוק את המדיניות.
כשמסירים מדיניות PAB מקבוצת חשבונות משתמשים, קורה אחד מהדברים הבאים:
- אם הישויות המורשות בקבוצת הישויות המורשות לא כפופות למדיניות אחרת לקביעת גבול הגישה לחשבונות משתמשים (PAB), הן יוכלו לגשת לכל המשאבים ב-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 .
סקירה כללית של כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
התפקידים שנדרשים כדי למחוק כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
כדי לקבל את ההרשאה שנדרשת למחיקת כללי מדיניות בקרת גישה לישויות מורשות (PAB), צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין של בקרת גישה לישויות מורשות (roles/iam.principalAccessBoundaryAdmin) ב-IAM ברמת הארגון.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקיד המוגדר מראש הזה כולל את ההרשאה iam.principalaccessboundarypolicies.delete, שנדרשת כדי למחוק כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (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.unbindבארגון -
מחיקת קישורי מדיניות של כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמקושרים למאגרי זהויות של כוח עבודה:
iam.workforcePools.deletePolicyBindingבמאגר הזהויות של כוח העבודה הרלוונטי -
מחיקת קישורי מדיניות של כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמקושרים למאגרי זהויות של עומסי עבודה:
iam.workloadIdentityPools.deletePolicyBindingבפרויקט שבבעלותו מאגר הזהויות של עומסי העבודה המטורגט -
בודקים את הסטטוס של פעולה ממושכת למחיקת קישור שמתייחס למאגר זהויות של עומסי עבודה:
iam.operations.getבפרויקט שבבעלותו מאגר הזהויות של עומסי העבודה. -
מחיקת קישורי מדיניות של כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמקושרים לדומיין ב-Google Workspace:
iam.workspacePools.deletePolicyBindingבארגון -
מחיקת קישורי מדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמקושרת לקבוצת חשבונות המשתמשים של הפרויקט:
resourcemanager.projects.deletePolicyBindingבפרויקט -
כדי לקבל את הסטטוס של פעולה ממושכת למחיקת קישור שמפנה לקבוצת ישויות מורשות של הפרויקט:
iam.operations.getבפרויקט -
מחיקת קישורי מדיניות של כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמקושרים לקבוצת חשבונות המשתמשים של התיקייה:
resourcemanager.folders.deletePolicyBindingבתיקייה -
מחיקת קישורי מדיניות של כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמקושרים לקבוצת חשבונות המשתמשים של הארגון:
resourcemanager.organizations.deletePolicyBindingבארגון
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
הכנות להסרת מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
לפני שאתם מסירים מדיניות PAB, אתם צריכים להחליט מה אתם רוצים לעשות:
- איך נותנים לקבוצת חשבונות גישה לכל המשאבים
- צמצום מספר המשאבים שחשבונות המשתמשים בקבוצת חשבונות המשתמשים יכולים לגשת אליהם
בקטעים הבאים מוסבר איך לבצע כל אחת מהמשימות האלה.
מתן הרשאת גישה לחשבונות משתמשים לכל המשאבים
כדי לתת לחשבונות המשתמשים בקבוצת חשבונות המשתמשים גישה לכל המשאבים:
- מזהים את כל כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שקשורים לקבוצת חשבונות המשתמשים.
- מוחקים את קישורי המדיניות הרלוונטיים כדי להסיר את כל כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שקשורים לקבוצת חשבונות המשתמשים.
אם חשבון משתמש לא כפוף לאף מדיניות PAB, הוא יכול לגשת לכל המשאבים ב- Google Cloud .
העובדה שלמשתמש יש זכאות לגשת למשאב לא בהכרח אומרת שהוא יכול לגשת אליו. למידע נוסף, קראו את המאמר הערכת מדיניות.
צמצום המשאבים שלחשבונות המשתמשים יש גישה אליהם
אם קבוצת חשבונות המשתמשים כפופה לכמה כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים, אתם יכולים להסיר אחד או יותר מכללי המדיניות האלה כדי לצמצם את מספר המשאבים שחשבונות המשתמשים יכולים לגשת אליהם. עם זאת, אל תסירו את כל כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שחלים על חשבונות המשתמשים. אם תעשו את זה, חשבונות המשתמשים יוכלו לגשת לכל המשאבים ב- Google Cloud .
כדי להסיר מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) ולוודא שחשבונות המשתמשים בקבוצת חשבונות משתמשים תמיד כפופים לפחות למדיניות אחת לקביעת גבול הגישה לחשבונות משתמשים (PAB):
- מזהים את כל כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שקשורים לקבוצת חשבונות המשתמשים.
מזהים את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמכילים רק משאבים שאתם רוצים שחשבונות המשתמשים בקבוצת החשבונות יוכלו לגשת אליהם. אלה כללי המדיניות שלא תסירו מקבוצת חשבונות המשתמשים.
אם אין לכם כללי מדיניות כאלה, צרו מדיניות חדשה לקביעת גבול הגישה לחשבונות משתמשים, שכוללת רק את המשאבים שאתם רוצים שלחשבונות המשתמשים תהיה גישה אליהם. לאחר מכן, מצרפים את המדיניות לקבוצת חשבונות המשתמשים.
מזהים את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמכילים משאבים שאתם לא רוצים שחשבונות המשתמשים בקבוצת החשבונות יוכלו לגשת אליהם. אחר כך, מסירים את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) האלה על ידי מחיקת קישור המדיניות הרלוונטי.
אם אתם רוצים לצמצם את הגישה של חשבונות משתמשים ספציפיים, הוסיפו תנאי לקישור המדיניות במקום למחוק אותו.
אם אתם רוצים לצמצם את מספר המשאבים שחשבון המשתמש יכול לגשת אליהם, אבל לא רוצים להסיר את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), אתם יכולים לשנות את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שחלים על חשבון המשתמש. במאמר עריכת כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) מוסבר איך משנים את כללי המדיניות.
בדיקת המחיקה של מדיניות או קישור של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
לפני שמוחקים מדיניות או קישור של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), מומלץ לבדוק איך השינוי יכול להשפיע על הגישה של חשבונות המשתמשים. אתם יכולים להשתמש בסימולטור המדיניות כדי לדמות מחיקה ולהבין את ההשפעה הפוטנציאלית שלה.
כדי לבדוק מחיקה, אפשר לעיין בהליכים הבאים במסמכי התיעוד של כלים לבקרת מדיניות:
- סימולציה של מחיקת כללים של גבולות גישה לחשבונות משתמשים
- סימולציה של מחיקת מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
- הדמיה של מחיקת קישור למדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
מידע נוסף על בדיקת כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) באמצעות סימולטור המדיניות מופיע במאמר סימולטור המדיניות לכללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB).
הסרת מדיניות PAB מקבוצת חשבונות משתמשים
לפני שאתם מסירים מדיניות PAB מקבוצת חשבונות משתמשים, אתם צריכים להתכונן להסרת המדיניות. לאחר מכן, מסירים את המדיניות על ידי מחיקת קישור המדיניות שמקשר את המדיניות לקבוצת חשבונות המשתמשים.
אפשר למחוק קישור מדיניות באמצעות מסוף Google Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
המסוף
נכנסים לדף Principal Access Boundary policies במסוף Google Cloud .
בוחרים את הארגון שבבעלותו נמצאת מדיניות ה-PAB שרוצים למחוק את הקישור שלה.
לוחצים על מזהה המדיניות של המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שרוצים למחוק את הקישורים שלה.
לוחצים על הכרטיסייה Bindings.
מאתרים את המזהה של הקישור שרוצים למחוק. בשורה של הקישור, לוחצים על Actions ואז על Delete binding.
בתיבת הדו-שיח לאישור, לוחצים על מחיקה.
gcloud
הפקודה
gcloud iam policy-bindings delete
מוחקת קישור מדיניות.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
BINDING_ID: המזהה של קישור המדיניות שרוצים למחוק, לדוגמהexample-binding. -
RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שקישור המדיניות הוא צאצא שלו. אפשר להשתמש בערךproject,folderאוorganization.סוג המשאב תלוי בחשבון המשתמש שמוגדר בקישור המדיניות. כדי לראות באיזה סוג משאב להשתמש, עיינו במאמר סוגי חשבונות משתמשים נתמכים.
-
RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam policy-bindings delete BINDING_ID \ --RESOURCE_TYPE=RESOURCE_ID --location=global
Windows (PowerShell)
gcloud iam policy-bindings delete BINDING_ID ` --RESOURCE_TYPE=RESOURCE_ID --location=global
Windows (cmd.exe)
gcloud iam policy-bindings delete BINDING_ID ^ --RESOURCE_TYPE=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 מוחקת קישור מדיניות.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שקישור המדיניות הוא צאצא שלו. אפשר להשתמש בערךprojects,foldersאוorganizations.סוג המשאב תלוי בחשבון המשתמש שמוגדר בקישור המדיניות. כדי לראות באיזה סוג משאב להשתמש, עיינו במאמר סוגי חשבונות משתמשים נתמכים.
-
RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
BINDING_ID: המזהה של קישור המדיניות שרוצים למחוק, לדוגמהexample-binding.
ה-method של ה-HTTP וכתובת ה-URL:
DELETE https://iam.googleapis.com/v3/RESOURCE_TYPE/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": "2024-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-binding",
"verb": "delete",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
מחיקת מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
לפני שמוחקים מדיניות PAB, מומלץ לזהות ולמחוק את כל הקישורים של מדיניות PAB שמפנים למדיניות PAB.
אם תמחקו מדיניות PAB עם קישורי מדיניות קיימים, הקישורים האלה יימחקו בסופו של דבר. עם זאת, עד שהם נמחקים, הקישורים למדיניות עדיין נספרים במגבלה של 10 קישורים שיכולים להתייחס לקבוצת חשבונות משתמשים אחת.
אפשר למחוק מדיניות PAB באמצעות מסוף Google Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
המסוף
נכנסים לדף Principal Access Boundary policies במסוף Google Cloud .
בוחרים את הארגון שבבעלותו נמצאת מדיניות ה-PAB שרוצים למחוק.
מוצאים את המזהה של המדיניות שרוצים למחוק. בשורה של המדיניות, לוחצים על Actions ואז על Delete policy.
בתיבת הדו-שיח לאישור, מאשרים שרוצים למחוק את המדיניות:
- כדי למחוק את המדיניות רק אם אין לה קישורים משויכים, לוחצים על Delete.
- כדי למחוק את המדיניות ואת כל הקישורים המשויכים, מסמנים את התיבה Forcefully delete policy ולוחצים על Delete.
gcloud
הפקודה gcloud iam gcloud iam principal-access-boundary-policies delete מוחקת את המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) ואת כל הקישורים המשויכים.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
PAB_POLICY_ID: המזהה של מדיניות ה-PAB שרוצים למחוק, לדוגמהexample-policy. -
ORG_ID: המזהה של הארגון שבבעלותו המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). מזהי ארגונים הם מספרים, למשל123456789012. -
FORCE_FLAG: אופציונלי. כדי לאלץ את הפקודה למחוק מדיניות, גם אם יש הפניה למדיניות הזו בקישורי מדיניות קיימים, משתמשים בדגל--force. אם הדגל הזה לא מוגדר והמדיניות מקושרת לקישורי מדיניות קיימים, הפקודה נכשלת.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam principal-access-boundary-policies delete PAB_POLICY_ID \ --organization=ORG_ID --location=global FORCE_FLAG
Windows (PowerShell)
gcloud iam principal-access-boundary-policies delete PAB_POLICY_ID ` --organization=ORG_ID --location=global FORCE_FLAG
Windows (cmd.exe)
gcloud iam principal-access-boundary-policies delete PAB_POLICY_ID ^ --organization=ORG_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... Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete...done. Deleted principalAccessBoundaryPolicy [example-policy].
REST
השיטה principalAccessBoundaryPolicies.delete מוחקת את המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) ואת כל הקישורים המשויכים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
ORG_ID: המזהה של הארגון שבבעלותו המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). מזהי ארגונים הם מספרים, למשל123456789012. -
PAB_POLICY_ID: המזהה של מדיניות ה-PAB שרוצים למחוק, לדוגמהexample-policy. -
FORCE_DELETE: אופציונלי. כדי לאלץ את הבקשה למחוק את המדיניות, גם אם יש הפניות למדיניות בקישורי מדיניות קיימים, מוסיפים את הפרמטר של השאילתהforce=true. אם לא מגדירים את הפרמטר הזה של השאילתה, והמדיניות מקושרת למדיניות קיימת, הבקשה נכשלת.
ה-method של ה-HTTP וכתובת ה-URL:
DELETE https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID?FORCE_DELETE
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. כדי ללמוד איך לקבל את הסטטוס של פעולה ממושכת, אפשר לעיין בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/policyBindings/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, הפעולה הושלמה ואפשר להפסיק לבצע אותה.
המאמרים הבאים
- יצירה והחלה של כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
- הצגת כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
- עריכת כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)