Тип ресурса bulkUpload

  • Статья

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

Важно!

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

Представляет возможность службы синхронизации Microsoft Entra обрабатывать массовые отправки. Дополнительные сведения см. в статье Основные понятия подготовки для входящего трафика на основе API.

Методы

Метод Тип возвращаемых данных Описание
Выполнение bulkUpload Нет Выполнение новой массовой отправки с помощью задания синхронизации.

Свойства

Тип ресурса bulkUpload принимает следующие свойства в полезных данных:

  • Параметр schemas на корневом уровне, который должен иметь значение urn:ietf:params:scim:api:messages:2.0:BulkRequest. Обязательно. В следующем блоке JSON показано представление параметра schemas .

    "schemas": [
  "urn:ietf:params:scim:api:messages:2.0:BulkRequest"
]

  • Параметр Operations содержит массив пар "ключ-значение". Каждый запрос может содержать не более 50 операций пользователя в этом параметре. В каждом объекте массива требуются следующие пары "ключ—значение".

    • Ключ метода должен иметь значение POST

    Примечание.

    Если для ключа метода задано значение POST, служба подготовки определит правильную операцию, выполняемую в целевом объекте (создание, обновление, включение и отключение) на основе конфигурации сопоставления атрибутов. Например, если вы задали {externalId,employeeId} в качестве пары совпадающих идентификаторов, служба подготовки будет проверка, если пользователь с employeeId существует в Microsoft Entra ID. Если он не существует, служба подготовки создаст пользователя. Если она существует, служба подготовки обновит запись пользователя.

    • Ключ пути всегда задает значение/Users
    • Для ключа bulkId задано значение уникального идентификатора. Например, если данные поступают из источника отдела кадров, можно задать это значение employeeId , которое гарантированно будет уникальным в системе управления персоналом.
    • объект data . Обязательно. Объект данных должен содержать следующие объекты:
    • Массив schemas в объекте data должен иметь схемы: urn:ietf:params:scim:schemas:core:2.0:User и urn:ietf:params:scim:schemas:extension:enterprise:2.0:User , представляющие URI схемы SCIM для основного ресурса пользователя и расширения корпоративного пользователя соответственно. В случае расширений атрибутов можно включить дополнительные пользовательские имена схем SCIM.
    • Ключ externalId имеет уникальный идентификатор в исходной системе. Например, employeeId или personIdstudentId.

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

    {
    "method": "POST",
    "bulkId": "d63f4f30-a198-43db-a34d-f72bfa1f551e",
    "path": "/Users",
    "data": {
      "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User",
        "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
      ],
      "externalId": "EMP1830"
  ... [You may include other SCIM attributes and extensions under the data object.]
    }
  }

Связи

Отсутствуют.

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

Ниже указано представление ресурса в формате JSON.

{
  "@odata.type": "#microsoft.graph.bulkUpload"
}