Recurso: variável
Descreve uma única variável em um recurso RuntimeConfig. O nome representa a variável hierárquica. Por exemplo, ports/serving_port
é um nome de variável válido. O valor da variável é uma string opaca, e somente variáveis de folha podem ter valores (ou seja, variáveis que não têm filhos).
Representação JSON | |
---|---|
{ "name": string, "updateTime": string, "state": enum( |
Campos | ||
---|---|---|
name |
O nome do recurso de variável no formato:
Após criar uma variável, você não poderá alterar o nome dela. |
|
updateTime |
[Somente saída] O horário da última atualização da variável. Um timestamp no formato UTC "Zulu" RFC3339 é precisamente medido em nanossegundos. Exemplo: |
|
state |
[Somente saída] O estado atual da variável. O estado da variável indica o resultado da chamada |
|
contents do campo de união. O valor da variável. Ele pode ser binário ou string. É necessário especificar value ou text . Se os dois forem especificados, o servidor poderá retornar um erro. contents pode ser apenas um dos seguintes: |
||
value |
O valor binário da variável. O comprimento dele precisa ser inferior a 4096 bytes. Valores vazios também são aceitos. Ele precisa ser codificado em base64. É possível definir apenas um dos dois: Uma string codificada em base64. |
|
text |
O valor da string da variável. O comprimento dele precisa ser inferior a 4096 bytes. Valores vazios também são aceitos. Por exemplo, |
VariableState
VariableState
descreve o último estado conhecido da variável e é usado durante a chamada variables().watch
para diferenciar o estado da variável.
Enums | |
---|---|
VARIABLE_STATE_UNSPECIFIED |
Estado padrão da variável. |
UPDATED |
A variável foi atualizada enquanto variables().watch estava em execução. |
DELETED |
A variável foi excluída enquanto variables().watch estava em execução. |
Métodos |
|
---|---|
|
Cria uma variável na configuração especificada. |
|
Exclui uma ou diversas variáveis. |
|
Recebe informações sobre uma única variável. |
|
Lista as variáveis de uma determinada configuração, que correspondam aos filtros fornecidos. |
|
Atualiza uma variável existente com um novo valor. |
|
Observa uma variável específica e aguarda uma alteração no valor dela. |