DatetimeWithNanoseconds,
datetime.datetime or NoneType:
Datetime object parsed from RFC3339 valid timestamp, or
None if the property is not set locally.
Raises
ValueError – if value is not a valid RFC3339 timestamp
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["Version latestkeyboard_arrow_down\n\n- [0.35.0 (latest)](/python/docs/reference/runtimeconfig/latest/variable)\n- [0.34.0](/python/docs/reference/runtimeconfig/0.34.0/variable)\n- [0.33.3](/python/docs/reference/runtimeconfig/0.33.3/variable)\n- [0.32.6](/python/docs/reference/runtimeconfig/0.32.6/variable)\n- [0.31.0](/python/docs/reference/runtimeconfig/0.31.0/variable)\n- [0.30.0](/python/docs/reference/runtimeconfig/0.30.0/variable)\n- [0.29.2](/python/docs/reference/runtimeconfig/0.29.2/variable) \n\nVariables\n=========\n\nCreate / interact with Google Cloud RuntimeConfig variables.\n\n### google.cloud.runtimeconfig.variable.STATE_UNSPECIFIED()\n\nThe default variable state. See\n\u003chttps://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables#VariableState\u003e\n\n### google.cloud.runtimeconfig.variable.STATE_UPDATED()\n\nIndicates the variable was updated, while variables.watch was executing.\nSee\n\u003chttps://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables#VariableState\u003e\n\n### google.cloud.runtimeconfig.variable.STATE_DELETED()\n\nIndicates the variable was deleted, while [variables.watch](https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables/watch) was executing.\nSee\n\u003chttps://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables#VariableState\u003e\n\n### *class* google.cloud.runtimeconfig.variable.Variable(name, config)\n\nBases: [`object`](https://docs.python.org/3/library/functions.html#object)\n\nA variable in the Cloud RuntimeConfig service.\n\nSee\n\u003chttps://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables\u003e\n\n- **Parameters**\n\n - **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str)) -- The name of the variable. This corresponds to the\n unique path of the variable in the config.\n\n - **config** ([`google.cloud.runtimeconfig.config.Config`](/python/docs/reference/runtimeconfig/latest/config#google.cloud.runtimeconfig.config.Config)) -- The config to which this variable belongs.\n\n#### *property* client()\n\nThe client bound to this variable.\n\n#### create(client=None)\n\nAPI call: create the variable via a POST request\n\nSee\n\u003chttps://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables/create\u003e\n\n- **Parameters**\n\n **client** ([`Client`](/python/docs/reference/runtimeconfig/latest/client#google.cloud.runtimeconfig.client.Client)) -- (Optional) The client to use. If not passed, falls back to the\n `client` stored on the variable's config.\n- **Return type**\n\n [bool](https://docs.python.org/3/library/functions.html#bool)\n- **Returns**\n\n True if the variable has been created, False on error.\n\n#### exists(client=None)\n\nAPI call: test for the existence of the variable via a GET request\n\nSee\n\u003chttps://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables/get\u003e\n\n- **Parameters**\n\n **client** ([`Client`](/python/docs/reference/runtimeconfig/latest/client#google.cloud.runtimeconfig.client.Client)) -- (Optional) The client to use. If not passed, falls back to the\n `client` stored on the variable's config.\n- **Return type**\n\n [bool](https://docs.python.org/3/library/functions.html#bool)\n- **Returns**\n\n True if the variable exists in Cloud RuntimeConfig.\n\n#### *classmethod* from_api_repr(resource, config)\n\nFactory: construct a Variable given its API representation\n\n- **Parameters**\n\n - **resource** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict)) -- change set representation returned from the API.\n\n - **config** ([`google.cloud.runtimeconfig.config.Config`](/python/docs/reference/runtimeconfig/latest/config#google.cloud.runtimeconfig.config.Config)) -- The config to which this variable belongs.\n\n- **Return type**\n\n `google.cloud.runtimeconfig.variable.Variable`\n- **Returns**\n\n Variable parsed from `resource`.\n\n#### *property* full_name()\n\nFully-qualified name of this variable.\n\nExample:\n`projects/my-project/configs/my-config/variables/my-var`\n\n- **Return type**\n\n [str](https://docs.python.org/3/library/stdtypes.html#str)\n- **Returns**\n\n The full name based on config and variable names.\n- **Raises**\n\n [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) if the variable is missing a name.\n\n#### *property* path()\n\nURL path for the variable's APIs.\n\n- **Return type**\n\n [str](https://docs.python.org/3/library/stdtypes.html#str)\n- **Returns**\n\n The URL path based on config and variable names.\n\n#### reload(client=None)\n\nAPI call: reload the variable via a `GET` request.\n\nThis method will reload the newest data for the variable.\n\nSee\n\u003chttps://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs/get\u003e\n\n- **Parameters**\n\n **client** ([`google.cloud.runtimeconfig.client.Client`](/python/docs/reference/runtimeconfig/latest/client#google.cloud.runtimeconfig.client.Client)) -- (Optional) The client to use. If not passed, falls back to the\n client stored on the current config.\n\n#### *property* state()\n\nRetrieve the state of the variable.\n\nSee\n\u003chttps://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables#VariableState\u003e\n\n- **Return type**\n\n [str](https://docs.python.org/3/library/stdtypes.html#str)\n- **Returns**\n\n If set, one of \"UPDATED\", \"DELETED\", or defaults to\n \"VARIABLE_STATE_UNSPECIFIED\".\n\n#### *property* text()\n\nText of the variable, as string.\n\nSee\n\u003chttps://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables\u003e\n\n- **Return type**\n\n str or `NoneType`\n- **Returns**\n\n The text of the variable or `None` if the property\n is not set locally.\n\n#### update(client=None)\n\nAPI call: update the variable via a PUT request\n\nSee\n\u003chttps://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables/update\u003e\n\n- **Parameters**\n\n **client** ([`Client`](/python/docs/reference/runtimeconfig/latest/client#google.cloud.runtimeconfig.client.Client)) -- (Optional) The client to use. If not passed, falls back to the\n `client` stored on the variable's config.\n- **Return type**\n\n [bool](https://docs.python.org/3/library/functions.html#bool)\n- **Returns**\n\n True if the variable has been created, False on error.\n\n#### *property* update_time()\n\nRetrieve the timestamp at which the variable was updated.\n\nSee\n\u003chttps://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables\u003e\n\n- **Returns**\n\n `DatetimeWithNanoseconds`,\n [`datetime.datetime`](https://docs.python.org/3/library/datetime.html#datetime.datetime) or `NoneType`:\n Datetime object parsed from RFC3339 valid timestamp, or\n `None` if the property is not set locally.\n- **Raises**\n\n [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError) -- if value is not a valid RFC3339 timestamp\n\n#### *property* value()\n\nValue of the variable, as bytes.\n\nSee\n\u003chttps://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables\u003e\n\n- **Return type**\n\n bytes or `NoneType`\n- **Returns**\n\n The value of the variable or `None` if the property\n is not set locally."]]
