Method: organizations.settings.deleteValue
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מוחק ערך של הגדרה. אם ערך ההגדרה לא קיים, הפעולה לא מתבצעת.
הפונקציה מחזירה את הערך 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=organizations/*/settings/*/value}
כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים |
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 ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון 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"]],["עדכון אחרון: 2025-07-26 (שעון 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."],["Requires the `resourcesettings.settingvalues.delete` permission and `https://www.googleapis.com/auth/cloud-platform` scope."],["Uses DELETE HTTP request method with the provided URL structure."],["Request body should be empty, and a successful response will also have an empty body."]]],["This document details the process of deleting a setting value via a `DELETE` HTTP request to the specified URL. The `name` parameter in the URL path identifies the target setting value. The operation returns a `NOT_FOUND` status if the setting or value is missing, or `FAILED_PRECONDITION` if the setting is read-only. The `ignoreReadOnly` query parameter enables the deletion of read-only settings. The request body must be empty, and a successful operation yields an empty response. Deletion requires the `resourcesettings.settingvalues.delete` IAM permission and the `cloud-platform` OAuth scope.\n"]]
