Поделиться через


Тип ресурса bulkUpload

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

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

Методы

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

Свойства

Тип ресурса 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"
}