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

Cria um controle.

Por padrão, são permitidos 1.000 controles para um repositório de dados. É possível enviar uma solicitação para ajustar esse limite. Se o Control a ser criado já existir, um erro ALREADY_EXISTS será retornado.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Nome completo do recurso do repositório de dados pai. Formato: projects/{project}/locations/{location}/collections/{collectionId}/dataStores/{dataStoreId} ou projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}.

Parâmetros de consulta

Parâmetros
controlId

string

Obrigatório. O ID a ser usado no controle, que se tornará o componente final do nome do recurso do controle.

Esse valor precisa ter entre 1 e 63 caracteres. Os caracteres válidos são /[a-z][0-9]-_/.

Corpo da solicitação

O corpo da solicitação contém uma instância de Control.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Control.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • discoveryengine.controls.create

Para mais informações, consulte a documentação do IAM.