Method: projects.locations.collections.engines.controls.create

Crea un controllo.

Per impostazione predefinita, sono consentiti 1000 controlli per un datastore. È possibile inviare una richiesta per modificare questo limite. Se l'Control da creare esiste già, viene restituito un errore ALREADY_EXISTS.

Richiesta HTTP

POST https://discoveryengine.googleapis.com/v1/{parent=projects/*/locations/*/collections/*/engines/*}/controls

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Nome completo risorsa del datastore padre. Formato: projects/{project}/locations/{location}/collections/{collectionId}/dataStores/{dataStoreId} o projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}.

Parametri di query

Parametri
controlId

string

Obbligatorio. L'ID da utilizzare per il controllo, che diventerà il componente finale del nome della risorsa del controllo.

Questo valore deve contenere da 1 a 63 caratteri. I caratteri validi sono /[a-z][0-9]-_/.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Control.

Corpo della risposta

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

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa parent:

  • discoveryengine.controls.create

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