Inspeção de alterações em uma variável

Nesta página, você aprende a criar um inspetor para uma variável. Para saber mais sobre os inspetores, consulte Noções básicas do Runtime Configurator.

Antes de começar

Como inspecionar as alterações de uma variável

É possível inspecionar uma variável para descobrir alterações chamando o método variables().watch. Com esse método, a variável é inspecionada por 60 segundos e retorna se o valor dela for alterado. Se o valor não for alterado em 60 segundos, o método será encerrado e retornará com a variável state=VARIABLE_STATE_UNSPECIFIED. Se a variável for excluída, o método retornará com uma variável state=DELETED e o último valor conhecido da variável.

Para definir um inspetor, use o Deployment Manager, a Google Cloud CLI ou a API.

Deployment Manager

Não há suporte para esse recurso no Deployment Manager. Em vez disso, crie um waiter.

gcloud

Com a Google Cloud CLI:

gcloud beta runtime-config configs variables watch [VARIABLE_KEY] --max-wait [TIMEOUT_SEC] --config-name [CONFIG_NAME]

em que:

  • [VARIABLE_KEY] é a chave a ser observada;
  • [TIMEOUT_SEC] é o tempo de espera em segundos. O valor máximo e padrão é de 60 segundos.

A CLI gcloud monitora a variável e retorna depois que atinge o tempo limite especificado ou a variável é alterada. Quando ela é alterada, a resposta contém um dos estados de variável aplicáveis.

API

Na API, faça uma solicitação POST para o seguinte URI:

https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_KEY]:watch

em que:

  • [PROJECT_ID] é o ID do projeto da solicitação;
  • [CONFIG_NAME] é o nome do recurso RuntimeConfig para esta solicitação;
  • [VARIABLE_KEY] é a chave a ser observada.

    Opcionalmente, é possível fornecer um payload de solicitação com a propriedade newerThan:

    {"newerThan": "[TIMESTAMP]"}

    em que [TIMESTAMP] é um carimbo de data/hora RFC 3339 desde epoch no formato UTC "Zulu". Por exemplo:

    2014-10-02T15:01:23.045123456Z

    Se você fornecer a propriedade newerThan, o método retornará imediatamente se o carimbo de data e hora atual da variável for mais recente do que o carimbo de data e hora especificado. Use a propriedade newerThan para garantir que você não perdeu nenhuma alteração entre as chamadas watch().

    Um dos estados de variável aplicáveis é retornado pelo método.

    Para saber mais sobre o método, consulte a documentação do variables().watch.

A seguir