מוחק ערך של הגדרה. אם ערך ההגדרה לא קיים, הפעולה לא מתבצעת.
הפונקציה מחזירה את הערך 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 Transcoding.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
name |
השם של ערך ההגדרה שרוצים למחוק. כדי להשתמש בהרשאה, צריך את הרשאת IAM הבאה במשאב שצוין
|
פרמטרים של שאילתה
| פרמטרים | |
|---|---|
ignoreReadOnly |
דגל שמאפשר למחוק את הערך של הגדרה |
גוף הבקשה
גוף הבקשה צריך להיות ריק.
גוף התשובה
אם הביצוע יהיה תקין, גוף התגובה יהיה ריק.
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/cloud-platform
מידע נוסף זמין במאמר סקירה כללית על אימות.