REST Resource: projects.configs.variables

Recurso: Variable

Describe una sola variable dentro de un recurso RuntimeConfig. El nombre indica el nombre de la variable jerárquica. Por ejemplo, ports/serving_port es un nombre de variable válido. El valor de la variable es una cadena opaca y solo las variables finales pueden tener valores (es decir, variables que no tienen ninguna variable secundaria).

Representación JSON 
{
  "name": string,
  "updateTime": string,
  "state": enum(VariableState),

  // Union field contents can be only one of the following:
  "value": string,
  "text": string
  // End of list of possible types for union field contents.
}
Campos
name

string

Es el nombre del recurso de variable, con el siguiente formato:

projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]

[PROJECT_ID] debe ser un ID de proyecto válido, [CONFIG_NAME] debe ser un recurso RuntimeConfig válido y [VARIABLE_NAME] debe seguir los nombres de ruta de acceso de archivos del sistema de archivos Unix.

El [VARIABLE_NAME] puede contener letras, números, barras y guiones ASCII. Las barras diagonales se usan como separadores de elementos de ruta y no forman parte de [VARIABLE_NAME], por lo que [VARIABLE_NAME] debe contener al menos un carácter que no sea una barra diagonal. Varias barras se combinan en un solo carácter de barra. Cada segmento de la ruta de acceso debe coincidir con la expresión regular 0-9A-Za-z. La longitud de un [VARIABLE_NAME] debe ser inferior a 256 caracteres.

Una vez que crees una variable, no podrás cambiar su nombre.
updateTime

string (Timestamp format)

Solo salida. Es la hora de la última actualización de la variable. La marca de tiempo será la marca de tiempo UTC.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con precisión de nanosegundos. Ejemplo: "2014-10-02T15:01:23.045123456Z".
state

enum(VariableState)

Solo salida. Es el estado actual de la variable. El estado de la variable indica el resultado de la llamada a variables().watch y se puede ver a través de las llamadas a get y list.

Campo de unión contents. Es el valor de la variable. Puede ser un valor binario o de cadena. Debes especificar value o text. Si especificas ambos, el servidor mostrará un error. contents solo puede ser una de las siguientes opciones:
value

string (bytes format)

Es el valor binario de la variable. La longitud del valor debe ser inferior a 4096 bytes. También se aceptan valores vacíos. El valor debe estar codificado en base64 y cumplir con el RFC4648 de IETF (https://www.ietf.org/rfc/rfc4648.txt). Solo se puede establecer una de value o text.

String codificada en base64.
text

string

Es el valor de cadena de la variable. La longitud del valor debe ser inferior a 4096 bytes. También se aceptan valores vacíos. Por ejemplo, text: "my text value". La string debe estar en UTF-8 válido.

VariableState

VariableState describe el último estado conocido de la variable y se usa durante una llamada a variables().watch para distinguir el estado de la variable.

Enums
VARIABLE_STATE_UNSPECIFIED Estado de la variable predeterminada.
UPDATED La variable se actualizó mientras se ejecutaba variables().watch.
DELETED Se borró la variable mientras se ejecutaba variables().watch.

Métodos

create

 Crea una variable dentro de la configuración determinada.

delete

 Borra una o varias variables.

get

 Obtiene información sobre una sola variable.

list

 Muestra una lista de variables dentro de una configuración determinada que coinciden con los filtros proporcionados.

testIamPermissions

 Permite mostrar los permisos que tiene un emisor para un recurso especificado.

update

 Actualiza una variable existente con un valor nuevo.

watch

 Observa una variable específica y espera a que cambie su valor.