Method: projects.configs.variables.watch

监控特定变量，并等待变量值发生变化。发生更改时，此方法会返回新值或超时。

如果变量在被监视期间被删除，则 variableState 状态会设为 DELETED，并且该方法会返回最后已知的变量 value。

如果您将观察的截止期限设置为大于内部超时时间 (60 秒) 的值，系统会返回当前变量值，并且 variableState 将为 VARIABLE_STATE_UNSPECIFIED。

如需详细了解如何创建监视器，请参阅监控变量是否发生变化文档。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
name

string

要监控的变量的名称，格式如下：

projects/[PROJECT_ID]/configs/[CONFIG_NAME]

必须对指定的资源 name 具有以下 Google IAM 权限才能进行授权：

  • runtimeconfig.variables.watch

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "newerThan": string
}
字段
newerThan

string (Timestamp format)

如果指定，则检查变量的当前时间戳；如果当前时间戳比 newerThan 时间戳更新，则该方法会立即返回。

如果未指定或变量的时间戳较旧，则监视器会等待值发生变化，然后再返回。

此时间戳采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，且精确到纳秒。示例："2014-10-02T15:01:23.045123456Z"。

响应正文

如果成功，则响应正文包含一个 Variable 实例。

授权范围

需要以下 OAuth 范围之一：

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

如需了解详情，请参阅身份验证概览。