Method: projects.locations.azureClusters.delete

מחיקה של משאב AzureCluster ספציפי.

הפעולה תיכשל אם לאשכול משויך משאב AzureNodePool אחד או יותר.

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

בקשת HTTP

DELETE https://{endpoint}/v1/{name=projects/*/locations/*/azureClusters/*}

כאשר {endpoint} היא אחת מנקודות הקצה הנתמכות של השירות.

כתובות ה-URL כתובות בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
name

string

חובה. שם המשאב AzureCluster שרוצים למחוק.

השמות של AzureCluster מפורמטים כ-projects/<project-id>/locations/<region>/azureClusters/<cluster-id>.

פרטים נוספים על שמות משאבים ב-Google Cloud Platform מופיעים במאמר שמות משאבים.

פרמטרים של שאילתה

פרמטרים
allowMissing

boolean

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

היא שימושית למחיקה אידמפוטנטית.

validateOnly

boolean

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

etag

string

ה-etag הנוכחי של AzureCluster.

מאפשר ללקוחות לבצע מחיקות באמצעות בקרת בו-זמניות אופטימית.

אם ה-etag שצוין לא תואם ל-etag הנוכחי של האשכול, הבקשה תיכשל ותוחזר שגיאת ABORTED.

ignoreErrors

boolean

זה שינוי אופציונלי. אם המדיניות מוגדרת כ-True, המחיקה של משאב AzureCluster תצליח גם אם יתרחשו שגיאות במהלך המחיקה במשאבי האשכול. השימוש בפרמטר הזה עלול לגרום ליצירת משאבים יתומים באשכול.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Operation.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform

ניתן למצוא מידע נוסף כאן: Authentication Overview.

הרשאות IAM

נדרשת הרשאת IAM הבאה במשאב name:

  • gkemulticloud.azureClusters.delete

מידע נוסף מופיע במאמרי העזרה בנושא IAM.