Method: projects.settings.updateValue
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
更新设置值。
如果设置或设置值不存在,则返回具有 google.rpc.Code.NOT_FOUND
的 google.rpc.Status
。如果相应设置被标记为只读,则返回具有 google.rpc.Code.FAILED_PRECONDITION
的 google.rpc.Status
。如果请求中提供的 etag 与设置值的保留 etag 不匹配,则返回带有 google.rpc.Code.ABORTED
的 google.rpc.Status
。
注意:所提供的设置值将执行所有字段的完全覆盖。
HTTP 请求
PATCH https://resourcesettings.googleapis.com/v1alpha1/{settingValue.name=projects/*/settings/*/value}
网址采用 gRPC 转码语法。
路径参数
参数 |
settingValue.name |
string
设置值的资源名称。必须采用以下任一形式:
projects/{project_number}/settings/{setting_name}/value
folders/{folder_id}/settings/{setting_name}/value
organizations/{organization_id}/settings/{setting_name}/value
例如“/projects/123/settings/gcp-enableMyFeature/value”
|
请求正文
请求正文包含一个 SettingValue
实例。
响应正文
如果成功,响应正文将包含一个 SettingValue
实例。
授权范围
需要以下 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。"],[[["Updates a setting value, performing a full overwrite of all fields."],["Returns errors if the setting or value doesn't exist, is read-only, or the etag doesn't match."],["Requires the `https://www.googleapis.com/auth/cloud-platform` OAuth scope for authorization."],["Uses the PATCH HTTP method and provides details on the request and response body structures."],["Identifies the required path parameter `settingValue.name` with format and example."]]],["This describes how to update a setting value via a `PATCH` HTTP request to a specific URL using gRPC Transcoding. The request requires a setting value name in the URL path, formatted as a project, folder, or organization identifier followed by the setting name and \"value\". The request body should contain a `SettingValue` instance, overwriting existing fields. A successful response returns a `SettingValue`, otherwise, status codes like `NOT_FOUND`, `FAILED_PRECONDITION`, or `ABORTED` may be returned. OAuth scope `https://www.googleapis.com/auth/cloud-platform` is necessary.\n"]]