Тип ресурса synchronizationSchema

Статья
10/04/2023

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Определяет, какие объекты синхронизируются и как они синхронизируются. Схема синхронизации содержит большую часть сведений о настройке для определенного задания синхронизации. Как правило, вы настраиваете некоторые сопоставления атрибутов или добавляете фильтр области для синхронизации только объектов, удовлетворяющих определенному условию.

В следующих разделах описываются высокоуровневые компоненты схемы синхронизации.

Определения каталогов

Определения каталогов предоставляют сведения подсистемы синхронизации о каталогах и их объектах. Например, определение каталога сообщает обработчику синхронизации, что каталог Microsoft Entra содержит объекты с именами user и group, какие атрибуты поддерживаются для этих объектов, а также типы для этих атрибутов. Чтобы конкретный объект и атрибут использовались в правилах синхронизации и сопоставлениях объектов, они должны быть определены как часть определения каталога.

Правила синхронизации

Правила синхронизации являются ядром настройки синхронизации. Они определяют для подсистемы синхронизации способ выполнения синхронизации, включая объекты, которые следует синхронизировать, как объекты из исходного каталога должны сопоставляться с объектами в целевом каталоге и как следует преобразовывать атрибуты при их синхронизации из источника в целевой каталог.

Сопоставления объектов

Сопоставления объектов являются main частью правила синхронизации. Каждое сопоставление объектов определяет способ синхронизации заданного объекта из источника в целевой каталог. В частности, сопоставление определяет, как объект в исходном каталоге должен сопоставляться с объектом в целевом каталоге, какие фильтры области (если таковые есть) следует использовать для решения о подготовке объекта и как следует преобразовывать атрибуты объекта при синхронизации из исходного каталога в целевой каталог.

Методы

Метод	Возвращаемый тип	Описание
Получение схемы	synchronizationSchema	Чтение свойств и связей объекта synchronizationSchema .
Обновление схемы	Нет	Обновите схему синхронизации.
Удаление схемы	Нет	Удалите настроенную схему, сбросив ее до конфигурации по умолчанию.
Список операторов фильтра	коллекция filterOperatorSchema	Список всех операторов, поддерживаемых фильтрами области.
Перечисление функций сопоставления атрибутов	Коллекция attributeMappingFunctionSchema	Список всех функций, поддерживаемых в выражениях сопоставления атрибутов.
Выражение сопоставления атрибутов синтаксического анализа	parseExpressionResponse	Анализ строкового выражения в объект attributeMappingSource .

Свойства

Свойство	Тип	Описание
id	String	Уникальный идентификатор схемы.
synchronizationRules	Коллекция synchronizationRule	Коллекция правил синхронизации, настроенных для элемента synchronizationJob или synchronizationTemplate.
version	String	Версия схемы, обновляется автоматически при каждом изменении схемы.

Связи

Связь	Тип	Описание
Каталоги	Коллекция directoryDefinition	Содержит коллекцию каталогов и все их объекты.

Представление JSON

В следующем представлении JSON показан тип ресурса.

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