Resource: Variable
Describes a single variable within a RuntimeConfig resource. The name denotes the hierarchical variable name. For example, ports/serving_port
is a valid variable name. The variable value is an opaque string and only leaf variables can have values (that is, variables that do not have any child variables).
JSON representation | |
---|---|
{ "name": string, "updateTime": string, "state": enum( |
Fields | ||
---|---|---|
name |
The name of the variable resource, in the format:
The The Once you create a variable, you cannot change the variable name. |
|
updateTime |
Output only. The time of the last variable update. Timestamp will be UTC timestamp. A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: |
|
state |
Output only. The current state of the variable. The variable state indicates the outcome of the |
|
Union field contents . The value of the variable. It can be either a binary or a string value. You must specify one of either value or text . Specifying both will cause the server to return an error. contents can be only one of the following: |
||
value |
The binary value of the variable. The length of the value must be less than 4096 bytes. Empty values are also accepted. The value must be base64 encoded, and must comply with IETF RFC4648 (https://www.ietf.org/rfc/rfc4648.txt). Only one of A base64-encoded string. |
|
text |
The string value of the variable. The length of the value must be less than 4096 bytes. Empty values are also accepted. For example, |
VariableState
The VariableState
describes the last known state of the variable and is used during a variables().watch
call to distinguish the state of the variable.
Enums | |
---|---|
VARIABLE_STATE_UNSPECIFIED |
Default variable state. |
UPDATED |
The variable was updated, while variables().watch was executing. |
DELETED |
The variable was deleted, while variables().watch was executing. |
Methods |
|
---|---|
|
Creates a variable within the given configuration. |
|
Deletes a variable or multiple variables. |
|
Gets information about a single variable. |
|
Lists variables within given a configuration, matching any provided filters. |
|
Returns permissions that a caller has on the specified resource. |
|
Updates an existing variable with a new value. |
|
Watches a specific variable and waits for a change in the variable's value. |