Method: organizations.settings.value.create

  • Creates a new setting value for a specified Cloud resource (project, folder, or organization).

  • Returns errors if the setting does not exist, the value already exists, or the setting is read-only.

  • Requires the cloud-platform OAuth scope for authorization.

  • Uses the SettingValue resource for both request and response bodies, providing details on the setting value being created.

  • Employs gRPC Transcoding for HTTP requests and utilizes specific path parameters to target resources.

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=organizations/*/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.