Method: projects.configs.variables.watch

Observa una variable específica y espera a que cambie su valor. Cuando hay un cambio, este método muestra el valor nuevo o se agota el tiempo de espera.

Si se borra una variable mientras se observa, el estado variableState se establece en DELETED y el método muestra la última variable conocida value.

Si estableces la fecha límite de observación en un valor mayor que el tiempo de espera interno (60 segundos), se muestra el valor de la variable actual y variableState será VARIABLE_STATE_UNSPECIFIED.

Para obtener más información sobre cómo crear un objeto de supervisión, consulta la documentación Cómo supervisar una variable en busca de cambios.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Es el nombre de la variable que se debe supervisar, en el siguiente formato:

projects/[PROJECT_ID]/configs/[CONFIG_NAME]

La autorización requiere el siguiente permiso de Google IAM en el recurso especificado name:

  • runtimeconfig.variables.watch

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "newerThan": string
}
Campos
newerThan

string (Timestamp format)

Si se especifica, verifica la marca de tiempo actual de la variable y, si es más reciente que la marca de tiempo de newerThan, el método se muestra de inmediato.

Si no se especifica o la variable tiene una marca de tiempo anterior, el observador espera a que cambie el valor antes de mostrarlo.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con precisión de nanosegundos. Ejemplo: "2014-10-02T15:01:23.045123456Z".

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Variable.

Alcances de autorización

Se necesita uno de los siguientes alcances de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.