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 determinado. Normalmente, se personalizan algunas de las asignaciones de atributos o se agrega un filtro de ámbito para sincronizar solo los objetos que cumplen una condición determinada.

En las secciones siguientes se describen los componentes de alto nivel del esquema de sincronización.

Definiciones de directorio

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

Reglas de sincronización

Las reglas de sincronización son el núcleo de la configuración de sincronización. Definen para el motor de sincronización cómo se debe realizar la sincronización, incluidos los objetos que se deben sincronizar, 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 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 origen al directorio de destino. En concreto, la asignación define cómo debe coincidir un objeto del directorio de origen con un objeto del directorio de destino, qué filtros de ámbito (si existe) se deben usar para decidir si se debe aprovisionar un objeto y cómo se deben transformar los atributos de objeto cuando se sincronizan desde el origen al directorio de destino.

Métodos

Método Tipo de valor devuelto Descripción
Obtener esquema synchronizationSchema Lea las propiedades y las relaciones del objeto synchronizationSchema .
Actualizar esquema Ninguno Actualice el esquema de sincronización.
Eliminar esquema Ninguno Elimine el esquema personalizado y restablezca el esquema a la configuración predeterminada.
Enumerar operadores de filtro colección filterOperatorSchema Enumere todos los operadores admitidos en los filtros de ámbito.
Enumeración de funciones de asignación de atributos attributeMappingFunctionSchema (colección) Enumera todas las funciones admitidas en las expresiones de asignación de atributos.
Análisis de la expresión de asignación de atributos parseExpressionResponse Analice una expresión de cadena en un objeto attributeMappingSource .

Propiedades

Propiedad Tipo Descripción
id Cadena Identificador único del esquema.
synchronizationRules colecció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 colección directoryDefinition Contiene la colección de directorios y todos sus objetos.

Representación JSON

Esta es una representación JSON del recurso.

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