Method: projects.settings.deleteValue
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מתבצעת מחיקה של ערך הגדרה. אם ערך ההגדרה לא קיים, הפעולה היא "no-op".
הפונקציה מחזירה google.rpc.Status עם google.rpc.Code.NOT_FOUND אם ההגדרה או ערך ההגדרה לא קיימים. ערך ההגדרה לא יהיה קיים אם קריאה קודמת ל-DeleteSetting עבור ערך ההגדרה כבר החזירה קוד הצלחה. מחזירה google.rpc.Status עם google.rpc.Code.FAILED_PRECONDITION אם ההגדרה מסומנת כ'לקריאה בלבד'.
בקשת HTTP
DELETE https://resourcesettings.googleapis.com/v1alpha1/{name=projects/*/settings/*/value}
כתובת ה-URL משתמשת בתחביר gRPC קידוד מחדש.
פרמטרים של נתיב
| פרמטרים |
name |
string
השם של ערך ההגדרה שרוצים למחוק. לפרטים על דרישות השם, יש לעיין בקישור SettingValue.
ההרשאה הזו דורשת את הרשאת IAM הבאה למשאב שצוין name:
resourcesettings.settingvalues.delete
|
פרמטרים של שאילתה
| פרמטרים |
ignoreReadOnly |
boolean
סימון שמאפשר למחוק את הערך של הגדרה readOnly. אזהרה: השימוש הוא באחריותך בלבד. מחיקת הערך של הגדרה לקריאה בלבד היא פעולה בלתי הפיכה (כלומר, לא ניתן ליצור אותה שוב).
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם התגובה מוצלחת, גוף התגובה יהיה ריק.
היקפי הרשאה
ההגדרה הזו מחייבת את היקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/cloud-platform
מידע נוסף זמין במאמר סקירה כללית על אימות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2023-05-25 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2023-05-25 (שעון UTC)."],[[["Deletes a setting value; if the setting value is already deleted or does not exist, it's considered successful."],["Returns an error if the setting is read-only or the setting/setting value is not found."],["The request body must be empty for this DELETE request."],["Requires `resourcesettings.settingvalues.delete` IAM permission and `https://www.googleapis.com/auth/cloud-platform` OAuth scope."]]],["This document details the process of deleting a setting value via a `DELETE` HTTP request to the specified URL. The `name` path parameter identifies the setting value to delete, requiring `resourcesettings.settingvalues.delete` IAM permission. The `ignoreReadOnly` query parameter allows deletion of read-only settings, but is irreversible. The request body must be empty and a successful response will have an empty body, otherwise the status `google.rpc.Status` returns the code of error, `google.rpc.Code.NOT_FOUND` or `google.rpc.Code.FAILED_PRECONDITION`. The operation requires OAuth scope `https://www.googleapis.com/auth/cloud-platform`.\n"]]
