Class Variable (0.30.0)

Variable(name, config)

A variable in the Cloud RuntimeConfig service.

See https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables

Parameters

Name	Description
name	`str` The name of the variable. This corresponds to the unique path of the variable in the config.
config	`Config` The config to which this variable belongs.

Inheritance

builtins.object > Variable

Properties

client

The client bound to this variable.

full_name

Fully-qualified name of this variable.

Example: projects/my-project/configs/my-config/variables/my-var

Exceptions

Type	Description
`ValueError	if the variable is missing a name.

Returns

Type	Description
str	The full name based on config and variable names.

path

URL path for the variable's APIs.

Returns

Type	Description
str	The URL path based on config and variable names.

state

Retrieve the state of the variable.

See https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables#VariableState

Returns

Type	Description
str	If set, one of "UPDATED", "DELETED", or defaults to "VARIABLE_STATE_UNSPECIFIED".

update_time

Retrieve the timestamp at which the variable was updated.

See https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables

Exceptions

Type	Description
ValueError	if value is not a valid RFC3339 timestamp

value

Value of the variable, as bytes.

See https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables

Returns

Type	Description
bytes or ``NoneType``	The value of the variable or ``None`` if the property is not set locally.

Methods

exists

exists(client=None)

API call: test for the existence of the variable via a GET request

See https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables/get

Parameter

Name	Description
client	`Client` (Optional) The client to use. If not passed, falls back to the `client` stored on the variable's config.

Returns

Type	Description
bool	True if the variable exists in Cloud RuntimeConfig.

from_api_repr

from_api_repr(resource, config)

Factory: construct a Variable given its API representation

Parameters

Name	Description
resource	`dict` change set representation returned from the API.
config	`Config` The config to which this variable belongs.

Returns

Type	Description
Variable	Variable parsed from ``resource``.

reload

reload(client=None)

API call: reload the variable via a GET request.

This method will reload the newest data for the variable.

See https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs/get

Parameter

Name	Description
client	`Client` (Optional) The client to use. If not passed, falls back to the client stored on the current config.