Microsoft Entra ID SCIM批量上传失败问题求助

核心问题：请求URL不正确 #

你当前使用的URL：

https://graph.microsoft.com/v1.0/servicePrincipals/{servicePrincipalId}/synchronization/jobs/{jobId}/

缺少了SCIM批量上传接口要求的/bulkUpload后缀，正确的完整URL应该是：

https://graph.microsoft.com/v1.0/servicePrincipals/{servicePrincipalId}/synchronization/jobs/{jobId}/bulkUpload

这个路径缺失正是导致"Unexpected segment DynamicPathSegment"错误的根本原因——Graph API无法识别未指定具体操作的路径，误以为你在尝试访问某个动态属性段，而非批量上传接口。

验证其他配置的正确性 #

请求头 #

• 保持Content-Type: application/json即可，你提到使用application/scim+json会报错，这符合Entra ID当前的接口要求，无需强制遵循SCIM标准的内容类型。
• 确保请求携带了有效的身份验证令牌（Bearer Token），且令牌拥有Synchronization.ReadWrite.All权限。

请求体结构 #

你提供的两个请求体（简单用户数据、空操作集）以及微软文档示例的结构都是正确的，无需调整：

1. 简单用户数据示例：

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:BulkRequest"],
    "Operations": [{
        "method": "POST",
        "path": "/users",
        "bulkId": "102",
        "data": {
            "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
                "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
            ],  
            "externalId": "102",
            "userName": "tuser",
            "name": {
                "formatted": "Test User",
                "familyName": "User",
                "givenName": "Test",
                "displayName": "Test User",
                "title": "Tester",
                "userType": "Employee"
            }   
        }   
    }],
    "failOnErrors": null
}

2. 空操作集示例：

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:BulkRequest"],
    "Operations": [],
    "failOnErrors": null
}

额外排查建议 #

• 确认同步作业（{jobId}）的状态为已启用，未启用的作业无法处理批量上传请求。
• 检查令牌的权限范围，确保没有权限不足的情况（可通过Graph Explorer验证令牌权限）。
• 如果调整URL后仍报错，可尝试使用Graph Explorer直接发起请求，排除客户端工具的编码或请求构造问题。

内容的提问来源于stack exchange，提问作者ex4