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 |
|---|---|---|
| Get | synchronizationSchema | Lea las propiedades y las relaciones del objeto synchronizationSchema . |
| Actualizar | Ninguno | Actualice el esquema de sincronización. |
| Reset | Ninguno | Elimine el esquema personalizado y restablezca el esquema a la configuración predeterminada. |
| Obtener operadores de filtro de esquema | colección filterOperatorSchema | Enumere todos los operadores admitidos en los filtros de ámbito. |
| Obtener funciones de esquema | 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
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"
}