Method: projects.locations.dataAgents.create

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

Richiesta HTTP

POST https://geminidataanalytics.googleapis.com/v1beta/{parent=projects/*/locations/*}/dataAgents

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Valore per il genitore.

Parametri di query

Parametri
dataAgentId

string

Facoltativo. ID dell'oggetto richiedente. Deve essere univoco all'interno del genitore. Il formato consentito è: ^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$. Se non viene fornito, il server genererà automaticamente un valore per l'ID.
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 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 DataAgent.

Corpo della risposta

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

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:

  • geminidataanalytics.dataAgents.create

Per saperne di più, consulta la documentazione di IAM.