Method: folders.settings.deleteValue

刪除設定值。如果設定值不存在,這項作業就不會執行任何動作。

如果設定或設定值不存在,則傳回 google.rpc.Status (含 google.rpc.Code.NOT_FOUND)。如果先前對設定值的 DeleteSetting 呼叫已傳回成功代碼,則設定值不存在。如果設定標示為唯讀,則傳回含有 google.rpc.Code.FAILED_PRECONDITIONgoogle.rpc.Status

HTTP 要求

DELETE https://resourcesettings.googleapis.com/v1alpha1/{name=folders/*/settings/*/value}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

要刪除的設定值名稱。請參閱SettingValue瞭解命名規定。

授權需要指定資源 name 的下列 IAM 權限:

  • resourcesettings.settingvalues.delete

查詢參數

參數
ignoreReadOnly

boolean

這個旗標可刪除 readOnly 設定的值。警告:請自行承擔使用風險。刪除唯讀設定的值是無法復原的操作 (即無法再次建立)。

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體會留白。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱驗證總覽一文。