Method: projects.locations.setUpDataConnector

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

Solicitud HTTP

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

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

Parámetros de ruta

Parámetros
parent

string

Obligatorio. El superior de Collection, en 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. El ID que se usará para el Collection, que se convertirá en el componente final del nombre de recurso del Collection. Se crea una Collection nueva como parte de la configuración de DataConnector. DataConnector es un recurso singleton en Collection, que administra todos los DataStore de la Collection.

Debe cumplir con el estándar RFC-1034 con un límite de longitud de 63 caracteres. De lo contrario, se muestra un error INVALID_ARGUMENT.

collectionDisplayName

string

Obligatorio. El nombre visible de la Collection.

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

dataConnector

object (DataConnector)

Obligatorio. El DataConnector que se inicializará en la Collection recién creada.

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.assist.readwrite
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.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.