bulkUpload 资源类型

  • 项目

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示 Microsoft Entra 同步服务处理批量上传的功能。 有关详细信息，请参阅 API 驱动的入站预配概念。

方法

方法 返回类型 说明
执行批量上传 None 使用同步作业执行新的批量上传。

属性

bulkUpload 资源类型接受有效负载中的以下属性：

  • 根级别的 架构 参数，必须设置为 urn:ietf:params:scim:api:messages:2.0:BulkRequest。 必填。 以下 JSON 块显示了 架构 参数的表示形式。

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

  • Operations 参数包含键值对的数组。 在此参数下，每个请求最多可以包含 50 个用户操作。 数组中的每个对象 都需要 以下键值对。

    • 方法 键必须设置为 POST

    注意

    当 方法 键设置为 POST时，预配服务将根据属性映射配置确定要对目标执行的操作， (创建/更新/启用/禁用) 。 例如，如果您已将 {externalId，employeeId} 设置为匹配的标识符对，则预配服务将检查 entra ID Microsoft 中是否存在具有 employeeId 的用户。 如果不存在，则预配服务将创建用户。 如果存在，则预配服务将更新用户记录。

    • 路径 键始终设置为 值 /Users
    • bulkId 密钥设置为唯一 ID 值。 例如，如果数据来自 HR 源，则可以将此值 employeeId 设置为，该值在 HR 系统中保证是唯一的。
    • 数据 对象。 必填。 数据对象必须具有以下对象：
    • schemas对象下的data数组必须具有架构：urn:ietf:params:scim:schemas:core:2.0:User和urn:ietf:params:scim:schemas:extension:enterprise:2.0:User分别表示核心用户资源和企业用户扩展的 SCIM 架构 URI。 对于属性扩展，可以包括其他自定义 SCIM 架构名称。
    • externalId 密钥设置为源系统中的唯一标识符。 例如， employeeId 或 personId 或 studentId。

    以下 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"
}