type de ressource synchronizationSchema

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Définit les objets qui sont synchronisés et la façon dont ils sont synchronisés. Le schéma de synchronisation contient la plupart des informations d’installation d’un travail de synchronisation particulier. En règle générale, vous personnalisez certains mappages d’attributs ou ajoutez un filtre d’étendue pour synchroniser uniquement les objets qui répondent à une certaine condition.

Les sections suivantes décrivent les composants généraux du schéma de synchronisation.

Définitions de répertoires

Les définitions de répertoires fournissent les informations du moteur de synchronisation sur les répertoires et leurs objets. Par exemple, la définition de répertoire indique au moteur de synchronisation qu’un répertoire Microsoft Entra a des objets nommés utilisateur et groupe, quels attributs sont pris en charge pour ces objets et les types pour ces attributs. Pour qu’un objet et un attribut particuliers soient utilisés dans les mappages de règles/objets de synchronisation, ils doivent être définis dans le cadre de la définition de répertoire.

Règles de synchronisation

Les règles de synchronisation sont au cœur de la configuration de la synchronisation. Ils définissent pour le moteur de synchronisation la façon dont la synchronisation doit être effectuée, notamment les objets qui doivent être synchronisés, la façon dont les objets du répertoire source doivent être mis en correspondance avec les objets du répertoire cible et la façon dont les attributs doivent être transformés lorsqu’ils sont synchronisés entre le répertoire source et le répertoire cible.

Mappages d’objets

Les mappages d’objets sont la partie main de la règle de synchronisation. Chaque mappage d’objet définit la façon dont un objet donné doit être synchronisé entre la source et le répertoire cible. En particulier, le mappage définit la façon dont un objet du répertoire source doit être mis en correspondance avec un objet dans le répertoire cible, les filtres d’étendue (le cas échéant) qui doivent être utilisés pour décider s’il faut provisionner un objet et comment les attributs d’objet doivent être transformés lorsqu’ils sont synchronisés entre le répertoire source et le répertoire cible.

Méthodes

Méthode	Type renvoyé	Description
Obtenir un schéma	synchronizationSchema	Lit les propriétés et les relations de l’objet synchronizationSchema .
Mettre à jour un schéma	Aucune	Mettez à jour le schéma de synchronisation.
Supprimer un schéma	Aucune	Supprimez le schéma personnalisé, en le réinitialisant à la configuration par défaut.
Répertorier les opérateurs de filtre	collection filterOperatorSchema	Répertorier tous les opérateurs pris en charge dans les filtres d’étendue.
Répertorier les fonctions de mappage d’attributs	collection attributeMappingFunctionSchema	Répertorie toutes les fonctions prises en charge dans les expressions de mappage d’attributs.
Analyser l’expression de mappage d’attribut	parseExpressionResponse	Analysez une expression de chaîne dans un objet attributeMappingSource .

Propriétés

Propriété	Type	Description
id	Chaîne	Identificateur unique du schéma.
synchronizationRules	synchronizationRule, collection	Collection de règles de synchronisation configurées pour synchronizationJob ou synchronizationTemplate.
version	Chaîne	Version du schéma, mise à jour automatiquement à chaque modification de schéma.

Relations

Relation	Type	Description
Téléphonique	collection directoryDefinition	Contient la collection de répertoires et tous leurs objets.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

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