tipo de recurso synchronizationSchema

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.

Define qué objetos se sincronizan y cómo se sincronizan. El esquema de sincronización contiene la mayor parte de la información de configuración de un trabajo de sincronización concreto. Normalmente, algunas de las asignaciones de atributo se personalizan o se agrega un filtro de ámbito para sincronizar solo los objetos que cumplen una determinada condición.

En las secciones siguientes se describen los componentes de alto nivel del esquema de sincronización. Para obtener más información, consulte Descripción del esquema de Microsoft Entra y asignación de atributos: Active Directory a Microsoft Entra ID.

Definiciones de directorio

Las definiciones de directorio proporcionan información del motor de sincronización sobre directorios y sus objetos. Por ejemplo, la definición del directorio indica al motor de sincronización que un directorio de Microsoft Entra tiene objetos denominados usuario y grupo, atributos que son compatibles con esos objetos y los tipos de esos atributos. Para que un objeto y un atributo determinados se utilicen en reglas de sincronización/asignaciones de objetos, deben definirse como parte de la definición del directorio.

Reglas de sincronización

Las reglas de sincronización son el núcleo de la configuración de la sincronización. Definen para el motor de sincronización cómo se debe realizar la sincronización, incluidos qué objetos deben sincronizarse, cómo deben coincidir los objetos del directorio de origen con los objetos del directorio de destino y cómo se deben transformar los atributos cuando se sincronizan del directorio de origen al directorio de destino.

Asignaciones de objetos

Las asignaciones de objetos son la parte principal de la regla de sincronización. Cada asignación de objetos define cómo se debe sincronizar un objeto determinado desde el directorio de origen hasta el de destino. En concreto, la asignación define cómo se debe hacer coincidir un objeto del directorio de origen con un objeto del directorio de destino, qué filtros de ámbito (si los hay) se deben usar para decidir si se aprovisiona un objeto y cómo se deben transformar los atributos de objeto cuando se sincronizan desde el directorio de origen al de destino.

Métodos

Método Tipo de valor devuelto Descripción
Get synchronizationSchema Lea las propiedades y relaciones del objeto synchronizationSchema .
Actualizar Ninguno Actualice el esquema de sincronización.
Reset Ninguno Elimine el esquema personalizado, restableciendo el esquema a la configuración predeterminada.
Obtener operadores de filtro de esquema Colección filterOperatorSchema Enumerar todos los operadores admitidos en los filtros de ámbito.
Obtener funciones de esquema Colección attributeMappingFunctionSchema Enumerar todas las funciones admitidas en las expresiones de asignación de atributos.
Analizar expresión de asignación de atributos parseExpressionResponse Analizar una expresión de cadena en un objeto attributeMappingSource .

Propiedades

Propiedad Tipo Descripción
id Cadena Identificador único del esquema.
synchronizationRules Recopilación synchronizationRule Colección de reglas de sincronización configuradas para synchronizationJob o synchronizationTemplate.
version Cadena La versión del esquema, actualizada automáticamente con cada cambio de esquema.

Relaciones

Relación Tipo Descripción
directorios directoryDefinition collection Contiene la colección de directorios y todos sus objetos.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.synchronizationSchema",
  "id": "String (identifier)",
  "synchronizationRules": [
    {
      "@odata.type": "microsoft.graph.synchronizationRule"
    }
  ],
  "version": "String"
}
  • Last updated on