type de ressource synchronizationSchemasynchronizationSchema resource type

Espace de noms : microsoft.graphNamespace: microsoft.graph

Important

Les API sous la /beta version de Microsoft Graph peuvent faire l’objet de modifications.APIs under the /beta version in Microsoft Graph are subject to change. L’utilisation de ces API dans des applications de production n’est pas prise en charge.Use of these APIs in production applications is not supported. Pour déterminer si une API est disponible dans la version 1.0, utilisez le sélecteur de version .To determine whether an API is available in v1.0, use the Version selector.

Définit les objets qui seront synchronisés et leur mode de synchronisation.Defines what objects will be synchronized and how they will be synchronized. Le schéma de synchronisation contient la plupart des informations de configuration d’une tâche de synchronisation particulière.The synchronization schema contains most of the setup information for a particular synchronization job. En règle générale, vous allez personnaliser certains mappages d’attributsou ajouter un filtre d’étendue pour synchroniser uniquement les objets qui satisfont à une certaine condition.Typically, you will customize some of the attribute mappings, or add a scoping filter to synchronize only objects that satisfy a certain condition.

Les sections suivantes décrivent les composants de haut niveau du schéma de synchronisation.The following sections describe the high-level components of the synchronization schema.

Définitions de répertoireDirectory definitions

Les définitions d’annuaire fournissent des informations sur le moteur de synchronisation sur les répertoires et leurs objets.Directory definitions provide the synchronization engine information about directories and their objects. Par exemple, la définition de répertoire indique au moteur de synchronisation qu’un annuaire Azure AD possède des objets nommés User et Group, quels attributs sont pris en charge pour ces objets et les types de ces attributs.For example, the directory definition tells the synchronization engine that an Azure AD directory has objects named user and group, which attributes are supported for those objects, and the types for those attributes. Pour qu’un objet et un attribut particulier soient utilisés dans les mappages de règles/objets de synchronisation, ils doivent être définis dans le cadre de la définition du répertoire.In order for a particular object and attribute to be used in synchronization rules/object mappings, they have to be defined as part of the directory definition.

Règles de synchronisationSynchronization rules

Les règles de synchronisation constituent le cœur de la configuration de la synchronisation.Synchronization rules are the core of the synchronization setup. Elles définissent pour le moteur de synchronisation le mode d’exécution de la synchronisation, notamment les objets à synchroniser, la façon dont les objets de l’annuaire source doivent être mis en correspondance avec les objets de l’annuaire cible, ainsi que la façon dont les attributs doivent être transformés lorsqu’ils sont synchronisés de l’annuaire source vers le répertoire cible.They define for the synchronization engine how the synchronization should be performed, including what objects should be synchronized, how objects from the source directory should be matched with objects in the target directory, and how attributes should be transformed when they're synchronized from the source to the target directory.

Mappages d’objetsObject mappings

Les mappages d’objets sont la partie principale de la règle de synchronisation.Object mappings are the main part of the synchronization rule. Chaque mappage d’objet définit la manière dont un objet donné doit être synchronisé entre la source et l’annuaire cible.Each object mapping defines how a given object should be synchronized from the source to the target directory. En particulier, le mappage définit comment un objet dans l’annuaire source doit être mis en correspondance avec un objet dans l’annuaire cible, quels (le cas échéant) les filtres d’étendue 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 l’annuaire source au répertoire cible.In particular, the mapping defines how an object in the source directory should be matched with an object in the target directory, what (if any) scoping filters should be used to decide whether to provision an object, and how object attributes should be transformed when they're synchronized from the source to the target directory.

MéthodesMethods

MéthodeMethod Type renvoyéReturn Type DescriptionDescription
Obtenir un schémaGet schema synchronizationSchemasynchronizationSchema Lit les propriétés et relations de l’objet synchronizationSchema .Read properties and relationships of the synchronizationSchema object.
Mettre à jour le schémaUpdate schema AucunNone Mettez à jour le schéma de synchronisation.Update the synchronization schema.
Supprimer le schémaDelete schema AucunNone Supprimez le schéma personnalisé, en redéfinissant le schéma à la configuration par défaut.Delete the customized schema, resetting the schema to the default configuration.
Opérateurs de filtrage de listeList filter operators collection filterOperatorSchemafilterOperatorSchema collection Répertoriez tous les opérateurs pris en charge dans les filtres d’étendue.List all operators supported in the scoping filters.
Fonctions de mappage des attributs de listeList attribute mapping functions collection attributeMappingFunctionSchemaattributeMappingFunctionSchema collection Répertorie toutes les fonctions prises en charge dans les expressions de mappage d’attribut.List all functions supported in the attribute mapping expressions.
Expression de mappage d’attribut d’analyseParse attribute mapping expression parseExpressionResponseparseExpressionResponse Analyser une expression de chaîne dans un objet attributeMappingSource .Parse a string expression into an attributeMappingSource object.

PropriétésProperties

PropriétéProperty TypeType DescriptionDescription
idid StringString Identificateur unique du schéma.Unique identifier for the schema.
synchronizationRulessynchronizationRules collection synchronizationRulesynchronizationRule collection Collection de règles de synchronisation configurées pour le synchronizationJob ou synchronizationTemplate.A collection of synchronization rules configured for the synchronizationJob or synchronizationTemplate.
versionversion StringString Version du schéma, mise à jour automatiquement avec chaque modification de schéma.The version of the schema, updated automatically with every schema change.

RelationsRelationships

RelationRelationship TypeType DescriptionDescription
Directordirectories collection directoryDefinitiondirectoryDefinition collection Contient la collection des répertoires et de tous leurs objets.Contains the collection of directories and all of their objects.

Représentation JSONJSON representation

Voici une représentation JSON de la ressource.The following is a JSON representation of the resource.

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