Method: folders.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=folders/*/settings/*/value}

כתובת ה-URL משתמשת בתחביר gRPC קידוד מחדש.

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

פרמטרים
name

string

השם של ערך ההגדרה שרוצים למחוק. לפרטים על דרישות השם, יש לעיין בקישור SettingValue.

ההרשאה הזו דורשת את הרשאת IAM הבאה למשאב שצוין name:

  • resourcesettings.settingvalues.delete

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

פרמטרים
ignoreReadOnly

boolean

סימון שמאפשר למחוק את הערך של הגדרה readOnly. אזהרה: השימוש הוא באחריותך בלבד. מחיקת הערך של הגדרה לקריאה בלבד היא פעולה בלתי הפיכה (כלומר, לא ניתן ליצור אותה שוב).

גוף הבקשה

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

גוף התשובה

אם התגובה מוצלחת, גוף התגובה יהיה ריק.

היקפי הרשאה

ההגדרה הזו מחייבת את היקפי ההרשאות הבאים של OAuth:

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

מידע נוסף זמין במאמר סקירה כללית על אימות.