Get 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.

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

Durante la versión preliminar pública, debe especificar un objectId conocido. No se admite la lista de colecciones; una solicitud GET a la colección objectConnections devuelve .400 Bad Request

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.Read.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación SynchronizationMetadata.Read.OwnedBy SynchronizationMetadata.Read.All

El SynchronizationMetadata.ReadWrite.All permiso también admite esta operación para aplicaciones y cuentas profesionales o educativas delegadas. El SynchronizationMetadata.ReadWrite.OwnedBy permiso de aplicación también admite esta operación.

Los SynchronizationMetadata.Read.OwnedBy permisos y SynchronizationMetadata.ReadWrite.OwnedBy de aplicación restringen el acceso a los trabajos de sincronización asociados a las entidades de servicio propiedad de la aplicación que llama.

Solicitud HTTP

GET /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.

Parámetros de consulta opcionales

Este método solo admite el parámetro de $select consulta OData para personalizar la respuesta. No se admiten otros parámetros de consulta OData. Para obtener información general, vea Parámetros de consulta OData.

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 tiene éxito, este método devuelve un 200 OK código de respuesta y un objeto objectConnection en el cuerpo de la respuesta.

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}.

GET 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 200 OK
Content-Type: application/json

{
  "objectId": "9d47c4a5-0d5a-4c0e-91b6-6f6c9c6e4c77",
  "sourceAnchor": "9d47c4a5-0d5a-4c0e-91b6-6f6c9c6e4c77",
  "targetAnchor": "EXTERNAL_userA",
  "displayName": "User A",
  "objectTypeName": "User"
}

Contenido relacionado

  • Se actualizó por última vez el