Method: projects.configs.variables.watch

Surveille une variable spécifique et attend que sa valeur change. En cas de modification, cette méthode renvoie la nouvelle valeur ou expire.

Si une variable est supprimée pendant sa surveillance, l'état variableState est défini sur DELETED et la méthode renvoie la dernière variable value connue.

Si vous définissez la date limite de surveillance sur une valeur supérieure au délai d'expiration interne (60 secondes), la valeur actuelle de la variable est renvoyée et variableState est VARIABLE_STATE_UNSPECIFIED.

Pour en savoir plus sur la création d'un observateur, consultez la documentation Surveiller une variable pour détecter les modifications.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Nom de la variable à surveiller, au format suivant:

projects/[PROJECT_ID]/configs/[CONFIG_NAME]

L'autorisation Google IAM suivante est requise pour la ressource name indiquée :

  • runtimeconfig.variables.watch

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "newerThan": string
}
Champs
newerThan

string (Timestamp format)

Si spécifié, vérifie l'horodatage actuel de la variable. Si l'horodatage actuel est plus récent que celui de newerThan, la méthode renvoie immédiatement une réponse.

Si elle n'est pas spécifiée ou si la variable possède un code temporel plus ancien, l'observateur attend que la valeur change avant de renvoyer la valeur.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z".

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Variable.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.