Google Cloud Resource Settings V1 Client - Class Setting (1.1.3)

Reference documentation and code samples for the Google Cloud Resource Settings V1 Client class Setting.

The schema for settings.

Generated from protobuf message google.cloud.resourcesettings.v1.Setting

Namespace

Google \ Cloud \ ResourceSettings \ V1

Methods

__construct

Constructor.

Parameters
Name	Description
`data`	`array` Optional. Data for populating the Message object.
`↳ 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"
`↳ metadata`	`Google\Cloud\ResourceSettings\V1\SettingMetadata` Output only. Metadata about a setting which is not editable by the end user.
`↳ local_value`	`Google\Cloud\ResourceSettings\V1\Value` The configured value of the setting at the given parent resource (ignoring the resource hierarchy). The data type of Value must always be consistent with the data type defined in Setting.metadata.
`↳ effective_value`	`Google\Cloud\ResourceSettings\V1\Value` Output only. The computed effective value of the setting at the given parent resource (based on the resource hierarchy). The effective value evaluates to one of the following options in the given order (the next option is used if the previous one does not exist): 1. the local setting value on the given resource: Setting.local_value 2. if one of the given resource's ancestors have a local setting value, the local value at the nearest such ancestor 3. the setting's default value: SettingMetadata.default_value 4. an empty value (defined as a `Value` with all fields unset) The data type of Value must always be consistent with the data type defined in Setting.metadata.
`↳ etag`	`string` A fingerprint used for optimistic concurrency. See UpdateSetting for more details.

getName

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"

Returns
Type	Description
`string`

setName

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"

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getMetadata

Output only. Metadata about a setting which is not editable by the end user.

Returns
Type	Description
`Google\Cloud\ResourceSettings\V1\SettingMetadata\|null`

hasMetadata

clearMetadata

setMetadata

Output only. Metadata about a setting which is not editable by the end user.

Parameter
Name	Description
`var`	`Google\Cloud\ResourceSettings\V1\SettingMetadata`

Returns
Type	Description
`$this`

getLocalValue

The configured value of the setting at the given parent resource (ignoring the resource hierarchy). The data type of Value must always be consistent with the data type defined in Setting.metadata.

Returns
Type	Description
`Google\Cloud\ResourceSettings\V1\Value\|null`

hasLocalValue

clearLocalValue

setLocalValue

The configured value of the setting at the given parent resource (ignoring the resource hierarchy). The data type of Value must always be consistent with the data type defined in Setting.metadata.

Parameter
Name	Description
`var`	`Google\Cloud\ResourceSettings\V1\Value`

Returns
Type	Description
`$this`

getEffectiveValue

Output only. The computed effective value of the setting at the given parent resource (based on the resource hierarchy).

The effective value evaluates to one of the following options in the given order (the next option is used if the previous one does not exist):

the local setting value on the given resource: Setting.local_value
if one of the given resource's ancestors have a local setting value, the local value at the nearest such ancestor
the setting's default value: SettingMetadata.default_value
an empty value (defined as a Value with all fields unset) The data type of Value must always be consistent with the data type defined in Setting.metadata.

Returns
Type	Description
`Google\Cloud\ResourceSettings\V1\Value\|null`

hasEffectiveValue

clearEffectiveValue

setEffectiveValue

Output only. The computed effective value of the setting at the given parent resource (based on the resource hierarchy).

The effective value evaluates to one of the following options in the given order (the next option is used if the previous one does not exist):

the local setting value on the given resource: Setting.local_value
if one of the given resource's ancestors have a local setting value, the local value at the nearest such ancestor
the setting's default value: SettingMetadata.default_value
an empty value (defined as a Value with all fields unset) The data type of Value must always be consistent with the data type defined in Setting.metadata.

Parameter
Name	Description
`var`	`Google\Cloud\ResourceSettings\V1\Value`

Returns
Type	Description
`$this`

getEtag

A fingerprint used for optimistic concurrency. See UpdateSetting for more details.

Returns
Type	Description
`string`

setEtag

A fingerprint used for optimistic concurrency. See UpdateSetting for more details.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`