Method: projects.locations.targets.create

Crea un nuovo target in un progetto e una località specifici.

Richiesta HTTP

POST https://clouddeploy.googleapis.com/v1/{parent=projects/*/locations/*}/targets

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. La raccolta principale in cui deve essere creato il Target. Il formato deve essere projects/{projectId}/locations/{location_name}.

I parametri di ricerca

Parametri
targetId

string

Obbligatorio. ID di Target.

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).

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 appena creata.

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 parent:

  • clouddeploy.targets.create

Per ulteriori informazioni, consulta la documentazione IAM.