Method: projects.configs.variables.watch

Monitora una variabile specifica e attende una variazione del relativo valore. In caso di modifica, questo metodo restituisce il nuovo valore o scade.

Se una variabile viene eliminata durante la sorveglianza, lo stato variableState viene impostato su DELETED e il metodo restituisce l'ultima variabile nota value.

Se imposti la scadenza per la visualizzazione su un valore maggiore del timeout interno (60 secondi), viene restituito il valore corrente della variabile e variableState sarà VARIABLE_STATE_UNSPECIFIED.

Per scoprire di più sulla creazione di un osservatore, leggi la documentazione relativa al monitoraggio di una variabile per rilevare le modifiche.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Il nome della variabile da monitorare, nel formato:

projects/[PROJECT_ID]/configs/[CONFIG_NAME]

L'autorizzazione richiede la seguente autorizzazione Google IAM sulla risorsa specificata name:

  • runtimeconfig.variables.watch

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "newerThan": string
}
Campi
newerThan

string (Timestamp format)

Se specificato, controlla il timestamp corrente della variabile e, se è più recente del timestamp newerThan, il metodo restituisce immediatamente.

Se non è specificato o la variabile ha un timestamp precedente, l'osservatore attende che il valore cambi prima di restituire.

Un timestamp in formato "Zulu" UTC RFC3339, preciso al nanosecondo. Esempio: "2014-10-02T15:01:23.045123456Z".

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Variable.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

Prova