AI-generated Key Takeaways
-
Creates a new setting value for a specific Cloud resource, identified by its name.
-
Returns errors if the setting doesn't exist, the value already exists, or the setting is read-only.
-
Requires providing the
SettingValue
object in the request body, specifying the desired value. -
Uses the
cloud-platform
OAuth scope for authorization. -
Provides links for gRPC Transcoding, SettingValue definition, and Authentication Overview for additional context.
Creates a setting value.
Returns a google.rpc.Status
with google.rpc.Code.NOT_FOUND
if the setting does not exist. Returns a google.rpc.Status
with google.rpc.Code.ALREADY_EXISTS
if the setting value already exists on the given Cloud resource. Returns a google.rpc.Status
with google.rpc.Code.FAILED_PRECONDITION
if the setting is flagged as read only.
HTTP request
POST https://resourcesettings.googleapis.com/v1alpha1/{settingValue.name=projects/*/settings/*/value}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
settingValue.name |
The resource name of the setting value. Must be in one of the following forms:
For example, "/projects/123/settings/gcp-enableMyFeature/value" |
Request body
The request body contains an instance of SettingValue
.
Response body
If successful, the response body contains a newly created instance of SettingValue
.
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.