观察变量的变化

本页面介绍了如何为变量创建 watcher。如需详细了解 watcher,请参阅 Runtime Configurator 基础知识

准备工作

观察变量的变化

您可以通过调用 variables().watch 方法来观察变量的变化。该方法会观察变量 60 秒并返回该变量值是否发生了变化。如果该变量值在 60 秒内没有变化,则该方法会终止并返回变量 state=VARIABLE_STATE_UNSPECIFIED。如果该变量被删除,则该方法会返回变量 state=DELETED 和所知的最新变量值。

如需设置 watcher,请使用 Deployment Manager、Google Cloud CLI 或 API。

Deployment Manager

Deployment Manager 不支持此功能。请改为创建 waiter

gcloud

使用 Google Cloud CLI:

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

其中:

  • [VARIABLE_KEY] 是要观察的键。
  • [TIMEOUT_SEC] 是等候的秒数。它的默认值和最大值为 60 秒。

gcloud CLI 会监视该变量,并在达到指定的超时时间或变量发生更改后返回。如果变量发生变化,则响应包含某个适用的变量状态

API

在 API 中,向以下 URI 发出 POST 请求:

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

其中:

  • [PROJECT_ID] 是此请求的项目 ID。
  • [CONFIG_NAME] 是此请求的 RuntimeConfig 资源的名称。
  • [VARIABLE_KEY] 是要观察的键。

    或者,您可以提供带有 newerThan 属性的请求载荷:

    { "newerThan": "[TIMESTAMP]" }

    其中 [TIMESTAMP] 是从 Epoch 起算的 RFC 3339 UTC "Zulu" 格式的时间戳。例如:

    2014-10-02T15:01:23.045123456Z

    若您提供 newerThan 属性,则如果变量的当前时间戳比指定的时间戳更新,则该方法会立即返回。您可使用 newerThan 属性确保未错过 watch() 调用之间的任何变化。

    该方法会返回某个适用的变量状态

    如需详细了解该方法,请阅读 variables().watch 文档。

后续步骤