Method: projects.locations.applications.updateApplicationInstances

Ajoute l'entrée de flux cible à l'application. Si l'application est déployée, la nouvelle instance d'application correspondante est créée. Si le flux a déjà été ajouté à l'application, l'appel RPC échoue.

Requête HTTP

POST https://{endpoint}/v1/{name=projects/*/locations/*/applications/*}:updateApplicationInstances

Où {endpoint} est l'un des points de terminaison de service compatibles.

Les URL utilisent la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de l'application à récupérer. Format: "projects/{project}/locations/{location}/applications/{application}"

Corps de la requête

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

Représentation JSON 
{
  "applicationInstances": [
    {
      object (UpdateApplicationInstance)
    }
  ],
  "requestId": string,
  "allowMissing": boolean
}
Champs
applicationInstances[]

object (UpdateApplicationInstance)
requestId

string

Facultatif. ID de requête facultatif permettant d'identifier les requêtes. Spécifiez un ID de requête unique pour que le serveur sache qu'il doit ignorer la requête si vous devez la retenter alors qu'elle est déjà terminée. Le serveur garantit cela pendant au moins 60 minutes après la première requête.

Par exemple, imaginons que vous effectuez une requête initiale et que celle-ci expire. Si vous effectuez à nouveau la requête avec le même ID de requête, le serveur peut vérifier si une opération d'origine ayant le même ID de requête a été reçue et, le cas échéant, ignorer la deuxième requête. Ainsi, les clients ne peuvent pas créer accidentellement des engagements en double.

L'ID de requête doit être un UUID valide, à ceci près qu'un UUID égal à zéro (00000000-0000-0000-0000-000000000000) n'est pas accepté.
allowMissing

boolean

Si la valeur est "true", la requête de mise à jour crée une ressource si la ressource cible n'existe pas. Cette fois, le champ "field_mask" est ignoré.

Corps de la réponse

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

Niveaux d'accès des autorisations

Requiert le champ d'application OAuth suivant :

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

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

UpdateApplicationInstance

Représentation JSON 
{
  "updateMask": string,
  "instance": {
    object (Instance)
  },
  "instanceId": string
}
Champs
updateMask

string (FieldMask format)

Facultatif. Le masque de champ permet de spécifier les champs à écraser dans la ressource Draft par la mise à jour. Les champs spécifiés dans updateMask sont relatifs à la ressource, et non à la requête complète. Un champ est écrasé s'il figure dans le masque. Si l'utilisateur ne fournit pas de masque, tous les champs seront écrasés.

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo"
instance

object (Instance)

Obligatoire. Ressource en cours de mise à jour.
instanceId

string

Obligatoire. ID de l'instance.