Method: projects.locations.applications.updateApplicationInstances

Aggiunge l'input dello stream target all'applicazione. Se l'applicazione è dipiattata, verrà creata la nuova istanza dell'applicazione corrispondente. Se lo stream è già nell'applicazione, l'RPC non andrà a buon fine.

Richiesta HTTP

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

dove {endpoint} è uno degli endpoint di servizio supportati.

Gli URL utilizzano la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Il nome dell'applicazione da recuperare. Formato: "projects/{project}/locations/{location}/applications/{application}"

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "applicationInstances": [
    {
      object (UpdateApplicationInstance)
    }
  ],
  "requestId": string,
  "allowMissing": boolean
}
Campi
applicationInstances[]

object (UpdateApplicationInstance)

requestId

string

Facoltativo. Un ID richiesta facoltativo per identificare le richieste. Specifica un ID richiesta univoco in modo che, se devi riprovare a inviare la richiesta, il server sappia ignorarla se è già stata completata. Il server lo garantisce per almeno 60 minuti dalla prima richiesta.

Ad esempio, prendi in considerazione una situazione in cui effettui una richiesta iniziale e questa scade. Se effettui di nuovo la richiesta con lo stesso ID richiesta, il server può verificare se è stata ricevuta l'operazione originale con lo stesso ID richiesta e, in questo caso, ignora la seconda richiesta. In questo modo, i clienti non possono creare accidentalmente impegni duplicati.

L'ID richiesta deve essere un UUID valido, ad eccezione del fatto che l'UUID zero non è supportato (00000000-0000-0000-0000-000000000000).

allowMissing

boolean

Se true, la richiesta di aggiornamento creerà una risorsa se la risorsa di destinazione non esiste. In questo caso, field_mask verrà ignorato.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

UpdateApplicationInstance

Rappresentazione JSON
{
  "updateMask": string,
  "instance": {
    object (Instance)
  },
  "instanceId": string
}
Campi
updateMask

string (FieldMask format)

Facoltativo. La maschera di campi viene utilizzata per specificare i campi da sovrascrivere nella risorsa bozza dall'aggiornamento. I campi specificati in updateMask si riferiscono alla risorsa, non alla richiesta completa. Un campo verrà sovrascritto se si trova nella maschera. Se l'utente non fornisce una maschera, tutti i campi verranno sovrascritti.

Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".

instance

object (Instance)

Obbligatorio. La risorsa in fase di aggiornamento.

instanceId

string

Obbligatorio. L'ID dell'istanza.