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.

Vorbereitung

Variable auf Änderungen überprüfen

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, das gcloud-Befehlszeilentool oder die API verwenden.

Deployment Manager

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

gcloud

Mit dem gcloud-Befehlszeilentool:

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.

Das gcloud-Tool fragt die Variable ab 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 infrage kommenden 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

Dabei gilt:

  • [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 der infrage kommenden Variablenstatus zurück.

    Weitere Informationen zur Methode erhalten Sie in der Dokumentation zu variables().watch.

Weitere Informationen

Hat Ihnen diese Seite weitergeholfen? Teilen Sie uns Ihr Feedback mit:

Feedback geben zu...

Cloud Deployment Manager-Dokumentation