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

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

כשמסירים מדיניות PAB מקבוצת חשבונות משתמשים, קורה אחד מהדברים הבאים:

  • אם הישויות המורשות בקבוצת הישויות המורשות לא כפופות למדיניות אחרת לקביעת גבול הגישה לחשבונות משתמשים (PAB), הן יוכלו לגשת לכל המשאבים ב-Google Cloud .
  • אם חשבונות המשתמשים בקבוצה כפופים למדיניות אחרת לקביעת גבול הגישה לחשבונות משתמשים, הם יוכלו לגשת רק למשאבים שמוגדרים במדיניות הזו.

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

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

  • איך נותנים לקבוצת חשבונות גישה לכל המשאבים
  • צמצום מספר המשאבים שחשבונות המשתמשים בקבוצת חשבונות המשתמשים יכולים לגשת אליהם

בקטעים הבאים מוסבר איך לבצע כל אחת מהמשימות האלה.

מתן הרשאת גישה לחשבונות משתמשים לכל המשאבים

כדי לתת לחשבונות המשתמשים בקבוצת חשבונות המשתמשים גישה לכל המשאבים:

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

אם חשבון משתמש לא כפוף לאף מדיניות PAB, הוא יכול לגשת לכל המשאבים ב- Google Cloud .

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

צמצום המשאבים שלחשבונות המשתמשים יש גישה אליהם

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

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

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

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

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

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

אם אתם רוצים לצמצם את מספר המשאבים שחשבון המשתמש יכול לגשת אליהם, אבל לא רוצים להסיר את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), אתם יכולים לשנות את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שחלים על חשבון המשתמש. במאמר עריכת כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (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 ואז על Delete binding.

  6. בתיבת הדו-שיח לאישור, לוחצים על מחיקה.

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.

המסוף

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

    לדף Principal Access Boundary policies

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

  3. מוצאים את המזהה של המדיניות שרוצים למחוק. בשורה של המדיניות, לוחצים על Actions ואז על Delete policy.

  4. בתיבת הדו-שיח לאישור, מאשרים שרוצים למחוק את המדיניות:

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

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