Method: projects.settings.value.create

  • 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

string

The resource name of the setting value. Must be in one of the following forms:

  • projects/{project_number}/settings/{setting_name}/value
  • folders/{folder_id}/settings/{setting_name}/value
  • organizations/{organization_id}/settings/{setting_name}/value

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.