# REST Resource: projects.settings

- [Resource: Setting](https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/projects.settings#Setting)
  - [JSON representation](https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/projects.settings#Setting.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/projects.settings#METHODS_SUMMARY)

## 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 (`https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/folders.settings#Setting.DataType`), "defaultValue": { object (`https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/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 `https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/organizations.settings/deleteValue#google.cloud.resourcesettings.v1alpha1.ResourceSettingsService.DeleteSettingValue` if `https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/organizations.settings/deleteValue#body.QUERY_PARAMETERS.ignore_read_only` is set to true. Using this flag is considered an acknowledgement that the setting value cannot be recreated. See `https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/organizations.settings/deleteValue#body.QUERY_PARAMETERS.ignore_read_only` for more details. |
| `dataType` | ``enum (`https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/folders.settings#Setting.DataType`)`` The data type for this setting. |
| `defaultValue` | ``object (`https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/Value`)`` The value received by `https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/organizations.settings/lookupEffectiveValue#google.cloud.resourcesettings.v1alpha1.ResourceSettingsService.LookupEffectiveSettingValue` if no setting value is explicitly set. Note: not all settings have a default value. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/projects.settings/deleteValue` | Deletes a setting value. |
| ### `https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/projects.settings/getValue` | Gets a setting value. |
| ### `https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/projects.settings/list` | Lists all the settings that are available on the Cloud resource `parent`. |
| ### `https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/projects.settings/lookupEffectiveValue` | Computes the effective setting value of a setting at the Cloud resource `parent`. |
| ### `https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/projects.settings/search` | Searches for all setting values that exist on the resource `parent`. |
| ### `https://developers.google.com/resource-settings/docs/reference/rest/v1alpha1/projects.settings/updateValue` | Updates a setting value. |