Eliminar objectConnection

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Eliminar un objectConnection para borrar el registro de vinculación almacenado en caché de un objeto en un synchronizationJob.

El servicio borra la entrada correspondiente de la caché del almacén de datos del conector para que el objeto se vuelva a evaluar durante un ciclo de sincronización posterior. Esta operación borra el registro de vinculación; No elimina el objeto de directorio de origen o destino.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) SynchronizationMetadata.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación SynchronizationMetadata.ReadWrite.OwnedBy SynchronizationMetadata.ReadWrite.All

El SynchronizationMetadata.ReadWrite.OwnedBy permiso de aplicación restringe el acceso a los trabajos de sincronización asociados con las entidades de servicio propiedad de la aplicación que llama.

Solicitud HTTP

DELETE /servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/objectConnections/{objectId}

Reemplácelo {objectId} por el identificador de origen o destino exacto del objeto en este trabajo de sincronización. Por ejemplo, utilice el id. de objeto de Microsoft Entra para el lado de Microsoft Entra de una conexión o el WID del trabajador de Workday para el origen de Workday. El servicio busca primero un identificador de origen y, después, un identificador de destino. Conserva el formato original del identificador.

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content.

Errores

Estado HTTP Condición
401 Unauthorized El autor de la llamada no está autenticado, carece del ámbito delegado o se produce un error en las comprobaciones de autorización delegada.
403 Forbidden Falta el permiso de aplicación necesario o el autor de la llamada no puede acceder al trabajo de sincronización solicitado.
404 Not Found El trabajo de sincronización o la conexión de objeto no existen.
429 Too Many Requests La solicitud se limita.

Ejemplos

Solicitud

En el ejemplo siguiente se utiliza el id. de objeto de Microsoft Entra del usuario de origen como {objectId}.

DELETE https://graph.microsoft.com/beta/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/objectConnections/9d47c4a5-0d5a-4c0e-91b6-6f6c9c6e4c77

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Contenido relacionado

  • Se actualizó por última vez el