Controllo delle modifiche di una variabile

In questa pagina viene spiegato come creare un watcher per una variabile. Per scoprire di più sugli spettatori, consulta Runtime Configurator Fundamentals.

Prima di iniziare

Controllare il cambiamento di una variabile

Puoi controllare le variazioni di una variabile chiamando il metodo variables().watch. Il metodo controlla la variabile per 60 secondi e restituisce se il valore della variabile cambia. Se il valore non cambia entro 60 secondi, il metodo viene terminato e restituisce con la variabile state=VARIABLE_STATE_UNSPECIFIED. Se la variabile viene eliminata, il metodo restituisce una variabile state=DELETED e l'ultimo valore di variabile noto.

Per impostare un watcher, utilizza Deployment Manager, Google Cloud CLI o l'API.

Deployment Manager

Questa funzionalità non è supportata in Deployment Manager. Crea invece un waiter.

gcloud

Con Google Cloud CLI:

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

dove:

  • [VARIABLE_KEY] è il segreto per guardare il video.
  • [TIMEOUT_SEC] è il tempo di attesa in secondi. Il valore predefinito e massimo è 60 secondi.

L'interfaccia a riga di comando gcloud esamina la variabile e restituisce una volta raggiunto il periodo di timeout specificato o se la variabile cambia. Se la variabile è cambiata, la risposta contiene uno degli stati della variabile applicabili.

API

Nell'API, effettua una richiesta POST al seguente URI:

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

dove:

  • [PROJECT_ID] è l'ID progetto per questa richiesta.
  • [CONFIG_NAME] è il nome della risorsa RuntimeConfig per questa richiesta.

  • [VARIABLE_KEY] è il segreto per guardare il video.

    Facoltativamente, puoi fornire un payload per le richieste con la proprietà newerThan:

    { "newerThan": "[TIMESTAMP]" }

    dove [TIMESTAMP] è un timestamp in RFC 3339 a partire dall'epoca nel formato UTC "Zulu". Ad esempio:

    2014-10-02T15:01:23.045123456Z

    Se fornisci la proprietà newerThan, il metodo restituisce immediatamente se il timestamp corrente della variabile è più recente del timestamp specificato. Utilizza la proprietà newerThan per assicurarti di non aver perso alcuna modifica tra una chiamata a watch() e l'altra.

    Il metodo restituisce uno degli stati delle variabili applicabili.

    Per saperne di più sul metodo, consulta la documentazione di variables().watch.

Passaggi successivi