Creación, actualización y eliminación de conexiones en Microsoft Graph

Las conexiones desde servicios externos al servicio Búsqueda de Microsoft se representan mediante el recurso externalConnection de Microsoft Graph.

La plataforma de conectores de Microsoft Graph ofrece una manera sencilla de agregar datos externos a Microsoft Graph. Una conexión es un contenedor lógico para los datos externos que un administrador puede administrar como una sola unidad.

Una vez creada una conexión, puede agregar contenido desde cualquier origen de datos externo, como un origen de datos local o un servicio de SaaS externo. Solo puede ver y administrar las conexiones que creó o aquellas para las que esté explícitamente autorizado para administrar. Un administrador de búsqueda puede ver y administrar todas las conexiones en el espacio empresarial desde el Centro de administración moderno.

Estructura de conector de ejemplo de un sistema personalizado de vales de servicio de asistencia

Estructura de conector de ejemplo de un sistema personalizado de vales de servicio de asistencia

Vista de administrador de Connections que incluye al conector de vales personalizados

Vista de administrador de Connections que incluye el conector de vales personalizados

Puede modelar una conexión de la forma que quiera, sin embargo, crear una conexión para cada instancia del conector es el modelo más común. Por ejemplo, cada vez que configure el conector de archivos compartidos de Microsoft Windows, se crea una nueva conexión. También puede crear una única conexión para agregar todos los elementos del origen de datos. Por ejemplo, crear una sola conexión para agregar todos los vales e incidencias de varios equipos del sistema de servicio de asistencia.

Estados y operaciones

La conexión puede existir en uno de los siguientes estados.

Estado Descripción
Borrador Se aprovisiona una conexión vacía. El origen de datos, el esquema o cualquier configuración aún no se ha configurado.
Listo La conexión se aprovisiona con el esquema registrado y está lista para la ingesta.
Obsoleto Esto sucede cuando alguna característica dependiente, como una API, ha caído en desuso. La única operación válida en este caso es eliminar la conexión.
LimitExceeded Si alcanza el límite máximo de una conexión o la cuota de nivel del espacio empresarial en todas las conexiones, no podrá agregar más elementos hasta que salga de ese estado.

En la siguiente tabla se especifican las operaciones disponibles para cada estado.

Operación Borrador Listo Obsoleto LimitExceeded
Crear conexión ✔️ ✔️
Leer conexión ✔️ ✔️ ✔️ ✔️
Actualizar conexión ✔️ ✔️ ✔️
Eliminar conexión ✔️ ✔️ ✔️ ✔️
Crear esquema ✔️
Leer esquema ✔️ ✔️ ✔️
Actualizar esquema
Eliminar esquema
Crear elemento ✔️
Leer elemento ✔️ ✔️ ✔️
Actualizar elemento ✔️ ✔️
Eliminar elemento ✔️ ✔️

Una conexión le permite a la aplicación definir un esquema de los elementos que se van a indexar y proporciona un punto de conexión para que el servicio agregue, actualice o elimine elementos del índice. Crear una conexión es el primer paso para que una aplicación agregue elementos al índice de búsqueda.

Crear una conexión

Para que una aplicación pueda agregar elementos al índice de búsqueda, debe crear y configurar una conexión mediante los pasos siguientes.

Importante

Una vez que se ha registrado un esquema, no se puede cambiar por otra conexión existente.

Actualizar una conexión

Puede cambiar el nombre para mostrar o la descripción de una conexión existente si actualiza la conexión.

Eliminar una conexión

Puede eliminar una conexión y quitar todos los elementos indexados mediante esa conexión.

Pasos siguientes