REST Resource: folders.settings

Resource: Setting

The schema for setting values. At a given Cloud resource, a setting can parent at most one setting value.

JSON representation
{
  "name": string,
  "displayName": string,
  "description": string,
  "readOnly": boolean,
  "dataType": enum (DataType),
  "defaultValue": {
    object (Value)
  }
}
Fields
name

string

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

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

For example, "/projects/123/settings/gcp-enableMyFeature"

displayName

string

The human readable name for this setting.

description

string

A detailed description of what this setting does.

readOnly

boolean

A flag indicating that values of this setting cannot be modified (see documentation of the specific setting for updates and reasons); however, it may be deleted using settings.deleteValue if DeleteSettingValueRequest.ignore_read_only is set to true. Using this flag is considered an acknowledgement that the setting value cannot be recreated. See DeleteSettingValueRequest.ignore_read_only for more details.

dataType

enum (DataType)

The data type for this setting.

defaultValue

object (Value)

The value received by settings.lookupEffectiveValue if no setting value is explicitly set.

Note: not all settings have a default value.

DataType

The data type for setting values of this setting. See Value for more details on the available data types.

Enums
DATA_TYPE_UNSPECIFIED Unspecified data type.
BOOLEAN A boolean setting.
STRING A string setting.
STRING_SET A string set setting.

Methods

deleteValue

Deletes a setting value.

getValue

Gets a setting value.

list

Lists all the settings that are available on the Cloud resource parent.

lookupEffectiveValue

Computes the effective setting value of a setting at the Cloud resource parent.
Searches for all setting values that exist on the resource parent.

updateValue

Updates a setting value.