Type de ressource synchronizationSchema

Espace de noms: microsoft.graph

Important

Les API sous la /beta version de 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 de version .

Définit les objets qui seront synchronisés et comment ils le seront. 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 mappagesd’attributs ou ajoutez un filtre d’échelle pour synchroniser uniquement les objets qui répondent à une certaine condition.

Les sections suivantes décrivent les composants de haut niveau du schéma de synchronisation.

Définitions d’annuaire

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

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 en correspondance avec les objets du répertoire cible et comment les attributs doivent être transformés lorsqu’ils sont synchronisés de la source vers le répertoire cible.

Mappages d’objets

Les mappages d’objets sont la partie principale 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 comment un objet dans le répertoire source doit être mappage avec un objet dans le répertoire cible, quels filtres d’échelle (le cas nécessaire) doivent être utilisés pour décider s’il faut mettre en service un objet et comment les attributs d’objet doivent être transformés lorsqu’ils sont synchronisés de la source vers le répertoire cible.

Méthodes

Méthode	Type renvoyé	Description
Obtenir un schéma	synchronizationSchema	Lit les propriétés et relations de l’objet synchronizationSchema.
Mettre à jour un schéma	Aucun	Mettez à jour le schéma de synchronisation.
Supprimer un schéma	Aucun	Supprimez le schéma personnalisé, en réinitialisant le schéma à la configuration par défaut.
Liste des opérateurs de filtre	collection filterOperatorSchema	Liste de tous les opérateurs pris en charge dans les filtres d’portée.
Fonctions de mappage des attributs de liste	collection attributeMappingFunctionSchema	Liste de toutes les fonctions prise en charge dans les expressions de mappage d’attributs.
Expression de mappage d’attribut d’analyse	parseExpressionResponse	Parse a string expression into an attributeMappingSource object.

Propriétés

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

Relations

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

Représentation JSON

Voici une représentation JSON de la ressource.

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