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

Cria um controlo.

Por predefinição, são permitidos 1000 controlos para um arquivo de dados. Pode enviar uma solicitação para ajustar este limite. Se o Control a criar já existir, é devolvido um erro ALREADY_EXISTS.

Pedido HTTP

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

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Nome completo do recurso do armazenamento de dados principal. 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 usar para o controlo, que se torna o componente final do nome do recurso do controlo.

Este valor tem de ter entre 1 e 63 carateres. Os carateres válidos são /[a-z][0-9]-_/.

Corpo do pedido

O corpo do pedido contém uma instância de Control.

Corpo da resposta

Se for bem-sucedido, o corpo da resposta contém uma instância recém-criada de Control.

Âmbitos de autorização

Requer um dos seguintes âmbitos do OAuth:

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

Para mais informações, consulte o Authentication Overview.

Autorizações de IAM

Requer a seguinte autorização de IAM no recurso parent:

  • discoveryengine.controls.create

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