Method: projects.locations.setUpDataConnector

Crea un Collection y configura el DataConnector para él. Para detener un DataConnector después de la configuración, usa el método CollectionService.DeleteCollection.

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Es el elemento superior de Collection, con el formato projects/{project}/locations/{location}.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "collectionId": string,
  "collectionDisplayName": string,
  "dataConnector": {
    object (DataConnector)
  }
}
Campos
collectionId

string

Obligatorio. Es el ID que se usará para el Collection, que se convertirá en el componente final del nombre del recurso del Collection. Se crea un nuevo Collection como parte de la configuración de DataConnector. DataConnector es un recurso singleton en Collection que administra todos los DataStore de Collection.

Este campo debe cumplir con el estándar RFC-1034 y tener un límite de 63 caracteres. De lo contrario, se muestra un error INVALID_ARGUMENT.

collectionDisplayName

string

Obligatorio. El nombre visible del Collection.

Debe ser legible y usarse para mostrar colecciones en el panel de la consola. Es una cadena codificada en UTF-8 con un límite de 1,024 caracteres.

dataConnector

object (DataConnector)

Obligatorio. Es el DataConnector que se inicializará en el Collection recién creado.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Alcances 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
  • https://www.googleapis.com/auth/discoveryengine.assist.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.locations.setUpDataConnector

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