Method: projects.locations.targets.patch

Aggiorna i parametri di un singolo target.

Richiesta HTTP

PATCH https://clouddeploy.googleapis.com/v1/{target.name=projects/*/locations/*/targets/*}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
target.name

string

Facoltativo. Nome di Target. Il formato è projects/{project}/locations/{location}/targets/{target}. Il componente target deve corrispondere a [a-z]([a-z0-9-]{0,61}[a-z0-9])?

I parametri di ricerca

Parametri
updateMask

string (FieldMask format)

Obbligatorio. La maschera per il campo viene utilizzata per specificare i campi che devono essere sovrascritti nella risorsa di destinazione dall'aggiornamento. I campi specificati in updateMask sono relativi alla risorsa, non alla richiesta completa. Un campo presente nella maschera verrà sovrascritto. Se l'utente non fornisce una maschera, tutti i campi vengono sovrascritti.

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

requestId

string

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

Ad esempio, prendi in considerazione una situazione in cui effettui una richiesta iniziale e la richiesta 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, ignorerà la seconda richiesta. Questo impedisce ai client di creare accidentalmente impegni duplicati.

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

allowMissing

boolean

Facoltativo. Se il criterio viene impostato su true, l'aggiornamento di un Target che non esiste comporterà la creazione di un nuovo Target.

validateOnly

boolean

Facoltativo. Se il criterio viene impostato su true, la richiesta viene convalidata e all'utente viene fornito un risultato previsto, ma non viene apportata alcuna modifica effettiva.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Target.

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.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM sulla risorsa name:

  • clouddeploy.targets.update

Per ulteriori informazioni, consulta la documentazione IAM.