Method: organizations.settings.deleteValue

删除设置值。如果设置值不存在,则该操作为空操作。

如果设置或设置值不存在,则返回具有 google.rpc.Code.NOT_FOUNDgoogle.rpc.Status。如果之前对设置值调用 DeleteSetting 并返回成功代码,则表示此设置值不存在。如果相应设置被标记为只读,则返回具有 google.rpc.Code.FAILED_PRECONDITIONgoogle.rpc.Status

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
name

string

要删除的设置值的名称。如需了解命名要求,请参阅 SettingValue

必须对指定的资源 name 具有以下 IAM 权限才能进行授权:

  • resourcesettings.settingvalues.delete

查询参数

参数
ignoreReadOnly

boolean

允许删除 readOnly 设置值的标志。警告:使用时应自行承担风险。删除只读设置的值是不可逆转的操作(即无法再重新创建)。

请求正文

请求正文必须为空。

响应正文

如果成功,则响应正文将为空。

授权范围

需要以下 OAuth 范围:

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

如需了解详情,请参阅身份验证概览