Method: projects.settings.deleteValue
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
删除设置值。如果设置值不存在,则该操作为空操作。
如果设置或设置值不存在,则返回具有 google.rpc.Code.NOT_FOUND
的 google.rpc.Status
。如果之前对设置值调用 DeleteSetting
并返回成功代码,则表示此设置值不存在。如果相应设置被标记为只读,则返回具有 google.rpc.Code.FAILED_PRECONDITION
的 google.rpc.Status
。
HTTP 请求
DELETE https://resourcesettings.googleapis.com/v1alpha1/{name=projects/*/settings/*/value}
网址采用 gRPC 转码语法。
路径参数
参数 |
name |
string
要删除的设置值的名称。如需了解命名要求,请参阅 SettingValue 。
必须对指定的资源 name 具有以下 IAM 权限才能进行授权:
resourcesettings.settingvalues.delete
|
查询参数
参数 |
ignoreReadOnly |
boolean
允许删除 readOnly 设置值的标志。警告:使用时应自行承担风险。删除只读设置的值是不可逆转的操作(即无法再重新创建)。
|
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/cloud-platform
如需了解详情,请参阅身份验证概览。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2023-05-25。
[[["易于理解","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"]],["最后更新时间 (UTC):2023-05-25。"],[[["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."],["The request body must be empty for this DELETE request."],["Requires `resourcesettings.settingvalues.delete` IAM permission and `https://www.googleapis.com/auth/cloud-platform` OAuth scope."]]],["This document details the process of deleting a setting value via a `DELETE` HTTP request to the specified URL. The `name` path parameter identifies the setting value to delete, requiring `resourcesettings.settingvalues.delete` IAM permission. The `ignoreReadOnly` query parameter allows deletion of read-only settings, but is irreversible. The request body must be empty and a successful response will have an empty body, otherwise the status `google.rpc.Status` returns the code of error, `google.rpc.Code.NOT_FOUND` or `google.rpc.Code.FAILED_PRECONDITION`. The operation requires OAuth scope `https://www.googleapis.com/auth/cloud-platform`.\n"]]