Variable auf Änderungen überprüfen

Auf dieser Seite wird erklärt, wie ein Watcher für eine Variable erstellt wird. Weitere Informationen zu Watchers finden Sie in Grundlagen des Runtime Configurators.

Hinweis

Änderungsvariable abrufen

Durch Aufrufen der Methode variables().watch können eine Variable beobachten, um Änderungen festzustellen. Die Methode fragt die Variable 60 Sekunden lang ab und wird wieder aktiviert, wenn sich der Wert der Variable ändert. Wenn sich der Wert innerhalb von 60 Sekunden nicht ändert, wird die Methode beendet und die Variable state=VARIABLE_STATE_UNSPECIFIED zurückgegeben. Wenn die Variable gelöscht wird, gibt die Methode eine Variable state=DELETED und den letzten bekannten Variablenwert zurück.

Zum Festlegen eines Watchers können Sie Deployment Manager, die Google Cloud CLI oder die API verwenden.

Deployment Manager

Dies wird im Deployment Manager nicht unterstützt. Erstellen Sie stattdessen einen Waiter.

gcloud

Mit der Google Cloud CLI:

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

Dabei gilt:

  • [VARIABLE_KEY] ist der abzufragende Schlüssel.
  • [TIMEOUT_SEC] ist die zu wartende Zeit in Sekunden. Der Standard- und Höchstwert beträgt 60 Sekunden.

Die gcloud CLI beobachtet die Variable und wird wieder aktiviert, wenn das festgelegte Zeitlimit erreicht ist oder sich die Variable ändert. Wenn sich die Variable geändert hat, enthält die Antwort einen der anwendbaren Variablenstatus.

API

Erstellen Sie in der API eine POST-Anfrage an den folgenden URI:

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

wobei

  • [PROJECT_ID] ist die Projekt-ID für diese Anfrage.
  • [CONFIG_NAME] ist der Name der RuntimeConfig-Ressource für diese Anfrage.
  • [VARIABLE_KEY] ist der abzufragende Schlüssel.

    Optional können Sie mit dem Attribut newerThan eine Anfragenutzlast angeben:

    {"newerThan": "[TIMESTAMP]"}

    wobei [TIMESTAMP] ein Zeitstempel in RFC 3339 seit der Epoche im UTC-Format "Zulu" ist. Beispiel:

    2014-10-02T15:01:23.045123456Z

    Bei Angabe des Attributs newerThan gibt die Methode sofort eine Antwort zurück, wenn der aktuelle Zeitstempel für die Variable neuer ist als der angegebene Zeitstempel. Verwenden Sie das Attribut newerThan, um sicherzustellen, dass Sie keine Änderungen zwischen watch()-Aufrufen verpasst haben.

    Die Methode gibt einen zutreffenden Variablenstatus zurück.

    Weitere Informationen zur Methode finden Sie in der variables().watch-Dokumentation.

Nächste Schritte