bulkUpload 资源类型

命名空间：microsoft.graph

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

方法

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

属性

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} 设置为匹配的标识符对，则预配服务将检查具有 employeeId 的用户存在于Microsoft Entra ID中。 如果不存在，则预配服务将创建用户。 如果存在，则预配服务将更新用户记录。

  • 路径 键始终设置为 值 /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"
}