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

Crea un Control.

De forma predeterminada, se permiten 1,000 controles para un almacén de datos. Se puede enviar una solicitud para ajustar este límite. Si el Control que se creará ya existe, se muestra un error ALREADY_EXISTS.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Es el nombre completo del recurso del almacén de datos principal. Formato: projects/{project}/locations/{location}/collections/{collectionId}/dataStores/{dataStoreId} o projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}.

Parámetros de consulta

Parámetros
controlId

string

Obligatorio. Es el ID que se usará para el control, que se convertirá en el componente final del nombre del recurso del control.

Este valor debe tener entre 1 y 63 caracteres. Los caracteres válidos son /[a-z][0-9]-_/.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Control.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Control.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • discoveryengine.controls.create

Para obtener más información, consulta la documentación de IAM.