Method: folders.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=folders/*/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):2025-07-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):2025-07-25。"],[],["This document details the process of deleting a setting value via a `DELETE` HTTP request to the specified URL, including path and query parameters. The operation is a no-op if the value doesn't exist. Success returns an empty response, while non-existence or read-only status yields specific `google.rpc.Status` codes. The request body must be empty. Authorization requires specific IAM permissions and OAuth scope. A query parameter allows deleting read-only values with a warning.\n"]]