Method: projects.configs.variables.watch

Beobachtet eine bestimmte Variable und wartet auf eine Änderung des Werts der Variable. Wenn eine Änderung auftritt, gibt diese Methode den neuen Wert zurück oder es tritt eine Zeitüberschreitung ein.

Wenn eine Variable während der Beobachtung gelöscht wird, wird der Status variableState auf DELETED festgelegt und die Methode gibt die letzte bekannte Variable value zurück.

Wenn Sie für die Frist für die Beobachtung einen Wert festlegen, der größer als die interne Zeitüberschreitung (60 Sekunden) ist, wird der aktuelle Variablenwert zurückgegeben und variableState ist VARIABLE_STATE_UNSPECIFIED.

Mehr über das Erstellen von Watchern erfahren Sie in der Dokumentation Änderungen einer Variable überwachen.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Der Name der zu beobachtenden Variable im Format:

projects/[PROJECT_ID]/configs/[CONFIG_NAME]

Zur Autorisierung ist die folgende Google IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • runtimeconfig.variables.watch

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "newerThan": string
}
Felder
newerThan

string (Timestamp format)

Wenn angegeben, wird der aktuelle Zeitstempel der Variablen geprüft. Wenn der aktuelle Zeitstempel neuer als der Zeitstempel von newerThan ist, gibt die Methode sofort eine Antwort zurück.

Wenn nicht angegeben oder die Variable einen älteren Zeitstempel hat, wartet der Watcher mit der Antwort darauf, dass sich eine Variable ändert.

Ein Zeitstempel im Format "RFC3339 UTC 'Zulu'" in Nanosekunden. Beispiel: "2014-10-02T15:01:23.045123456Z".

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Variable.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

Testen!