synchronizationSchema type de ressource

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 quels objets sont synchronisés et comment ils sont synchronisés. Le schéma de synchronisation contient la plupart des informations de configuration pour 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 remplissent une certaine condition.

Les sections suivantes décrivent les composants de haut niveau du schéma de synchronisation. Pour plus d’informations, consultez Comprendre le schéma Microsoft Entra et Mappage d’attributs: Active Directory vers Microsoft Entra ID.

Définitions de répertoire

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

Règles de synchronisation

Les règles de synchronisation constituent le cœur de la configuration de la synchronisation. Ils définissent pour le moteur de synchronisation comment la synchronisation doit être effectuée, y compris les objets à synchroniser, comment les objets du répertoire source doivent être mis en correspondance avec les objets du répertoire cible et comment les attributs doivent être transformés lorsqu’ils sont synchronisés du répertoire source vers le répertoire cible.

Mappages d’objets

Les mappages d’objets constituent 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é du répertoire source au répertoire cible. En particulier, le mappage définit comment un objet dans le répertoire source doit être mis en correspondance avec un objet dans le répertoire cible, quels filtres d’étendue (le cas échéant) 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 du répertoire source au répertoire cible.

Méthodes

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

Propriétés

Propriété Type Description
id String Identifiant unique du schéma.
synchronisationrègles synchronisationcollection de règles Un ensemble de règles de synchronisation configurées pour le synchronizationJob ou le synchronizationTemplate.
version String Version du schéma, mise à jour automatiquement à chaque modification de schéma.

Relations

Relation Type Description
annuaires collection directoryDefinition Contient la collection des 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"
}
  • Last updated on