Method: projects.configs.variables.watch

Observa uma variável específica e aguarda uma alteração no valor dela. Quando há uma alteração, este método retorna o novo valor ou esgota o tempo limite.

Se uma variável for excluída durante a observação, o estado variableState será definido como DELETED, e o método vai retornar a última variável conhecida value.

Se você definir o prazo de observação para um valor maior que o tempo limite interno (60 segundos), o valor atual da variável será retornado e o variableState será VARIABLE_STATE_UNSPECIFIED.

Para saber mais como criar um inspetor, leia a documentação Inspeção de alterações em uma variável.

Solicitação HTTP

POST https://runtimeconfig.googleapis.com/v1beta1/{name=projects/*/configs/*/variables/**}:watch

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

O nome da variável que será observada, no formato:

projects/[PROJECT_ID]/configs/[CONFIG_NAME]

A autorização requer a seguinte permissão do Google IAM no recurso especificado name:

  • runtimeconfig.variables.watch

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "newerThan": string
}
Campos
newerThan

string (Timestamp format)

Se especificado, verifica o carimbo de data/hora atual da variável. Se o carimbo de data/hora atual for mais recente do que o newerThan, o método será retornado imediatamente.

Se não for especificado ou se a variável tiver um timestamp mais antigo, o inspetor aguardará uma alteração no valor antes de ser retornado.

Um carimbo de data/hora no formato UTC “Zulu” RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Variable.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloudruntimeconfig

Para mais informações, consulte a Visão geral da autenticação.

Testar