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

Crea un recurso Control.

De forma predeterminada, se permiten 1000 controles por almacén de datos. Se puede enviar una solicitud para ajustar este límite. Si el Control que se va a crear ya existe, se devuelve un error ALREADY_EXISTS.

Solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
parent

string

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

Los parámetros de consulta

Parámetros
controlId

string

Obligatorio. ID que se usará para el control, que se convertirá en el componente final del nombre de 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

En el cuerpo de la solicitud se incluye una instancia de Control.

Cuerpo de la respuesta

Si la solicitud se realiza correctamente, en el cuerpo de la respuesta se incluye una instancia recién creada de Control.

Permisos de autorización

Debes disponer de 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 el Authentication Overview.

Permisos de IAM

Requiere el siguiente permiso de gestión de identidades y accesos en el recurso parent:

  • discoveryengine.controls.create

Para obtener más información, consulta la documentación de gestión de identidades y accesos.