- Richiesta HTTP
- Parametri del percorso
- Parametri di query
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Autorizzazioni IAM
Crea una nuova indagine in un determinato progetto.
Richiesta HTTP
POST https://geminicloudassist.googleapis.com/v1alpha/{parent=projects/*/locations/*}/investigations
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri | |
|---|---|
parent |
Obbligatorio. Valore per il genitore. La località deve essere impostata su "global". |
Parametri di query
| Parametri | |
|---|---|
investigationId |
Facoltativo. ID da utilizzare per l'indagine, che diventerà il componente finale del nome risorsa dell'indagine. Questo valore deve contenere da 4 a 63 caratteri e i caratteri validi sono /[a-z][0-9]-/. Se non viene fornito, il server genererà un ID univoco per l'indagine. |
requestId |
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 di ignorarla se è già stata completata. Il server garantirà che per almeno 60 minuti dalla prima richiesta. Ad esempio, considera una situazione in cui effettui una richiesta iniziale e la richiesta scade. Se effettui nuovamente la richiesta con lo stesso ID richiesta, il server può verificare se è stata ricevuta l'operazione originale con lo stesso ID richiesta e, in caso affermativo, ignora la seconda richiesta. In questo modo, i clienti non creano impegni duplicati per errore. L'ID richiesta deve essere un UUID valido, ad eccezione dell'UUID zero, che non è supportato (00000000-0000-0000-0000-000000000000). |
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di Investigation.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza appena creata di Investigation.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/cloud-platform
Per ulteriori informazioni, consulta la Authentication Overview.
Autorizzazioni IAM
Richiede la seguente autorizzazione IAM per la risorsa parent:
geminicloudassist.investigations.create
Per saperne di più, consulta la documentazione di IAM.