Method: projects.locations.applications.updateApplicationInstances

Fügen Sie der Anwendung einen Zielstream-Eingang hinzu. Wenn die Anwendung bereitgestellt wird, wird die entsprechende neue Anwendungsinstanz erstellt. Wenn der Stream bereits in der Anwendung vorhanden ist, schlägt der RPC fehl.

HTTP-Anfrage

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

Dabei ist {endpoint} einer der unterstützten Dienstendpunkte.

Die URLs verwenden die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Name der abzurufenden Anwendung. Format: „projects/{project}/locations/{location}/applications/{application}“

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "applicationInstances": [
    {
      object (UpdateApplicationInstance)
    }
  ],
  "requestId": string,
  "allowMissing": boolean
}
Felder
applicationInstances[]

object (UpdateApplicationInstance)
requestId

string

Optional. Eine optionale Anfrage-ID zur Identifizierung von Anfragen. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignoriert, falls sie bereits abgeschlossen wurde, falls Sie Ihre Anfrage wiederholen müssen. Der Server gewährleistet dies für mindestens 60 Minuten nach der ersten Anfrage.

Stellen Sie sich beispielsweise eine Situation vor, in der Sie eine erste Anfrage stellen und diese das Zeitlimit überschreitet. Wenn Sie die Anfrage mit derselben Anfrage-ID noch einmal senden, kann der Server prüfen, ob der ursprüngliche Vorgang mit derselben Anfrage-ID empfangen wurde. Ist dies der Fall, wird die zweite Anfrage ignoriert. Dadurch wird verhindert, dass Clients versehentlich doppelte Zusicherungen erstellen.

Die Anfrage-ID muss eine gültige UUID sein, mit der Ausnahme, dass null UUID nicht unterstützt wird (00000000-0000-0000-0000-000000000000).
allowMissing

boolean

Wenn „true“, wird mit der Aktualisierungsanfrage eine Ressource erstellt, wenn die Zielressource nicht vorhanden ist. In diesem Fall wird die field_mask ignoriert.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

UpdateApplicationInstance

JSON-Darstellung 
{
  "updateMask": string,
  "instance": {
    object (Instance)
  },
  "instanceId": string
}
Felder
updateMask

string (FieldMask format)

Optional. Mit der Feldmaske werden die Felder angegeben, die durch die Aktualisierung in der Entwurfsressource überschrieben werden sollen. Die in „updateMask“ angegebenen Felder beziehen sich auf die Ressource und nicht auf die gesamte Anfrage. Ein Feld wird überschrieben, wenn es sich in der Maske befindet. Wenn der Nutzer keine Maske angibt, werden alle Felder überschrieben.

Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
instance

object (Instance)

Pflichtangabe. Die aktualisierte Ressource.
instanceId

string

Pflichtangabe. Die ID der Instanz.