Azure IoT Central创建设备组查询失败，无法生成Job求助

问题详情 #

• 操作目标：创建设备组，后续基于该组创建Job向所有设备发送重启命令
• 使用API：PUT https://{subdomain}.{baseDomain}/api/deviceGroups/{uuidCreatedByMe}?api-version=2022-07-31
• 请求体示例（标准JSON格式）：

{
    "description": "Pulses' group to be rebooted, created at 2022-09-06T16:10:01.000Z",
    "displayName": "Reboot group sample-group-id",
    "filter": "SELECT * FROM devices WHERE $template = \"templateId\" AND $id IN [\"deviceId1\", \"deviceId2\"]"
}

• 错误返回：

{
   "code": "InternalServerError",
   "message": "Something went wrong on our end. Please try again. You can contact support at https://aka.ms/iotcentral-support. Please include the following information. Request ID: requestId, Time: Tue, 06 Sep 2015 477:10:01 GMT.",
   "requestId": "requestId",
   "time": "Tue, 06 Sep 2022 16:10:01 GMT"
}

• 异常现象：创建设备组后，在设备组列表中能看到这些组，但无法查看组内设备数量，也无法基于其创建Job；通过REST API删除这些组的操作可正常执行

排查与解决建议 #

1. 核查查询语句的细节问题
   虽然官方文档标注该语法合法，但实际执行可能存在隐性问题：

   • 确保$template的值在JSON请求体中已正确转义双引号（如\"templateId\"），避免JSON解析错误
   • 确认IN数组中的设备ID均为IoT Central中已存在的有效ID，无效ID可能导致服务器端查询计算异常
   • 检查查询语句的大小写（$template、$id为系统属性，大小写敏感）和空格格式，避免语法隐性错误

2. 确保请求体为标准JSON格式
   原请求体使用JavaScript对象语法（单引号、模板字符串），需转换为标准JSON：

   • 所有键和字符串值必须使用双引号
   • 提前计算description和displayName的实际字符串值，不能直接使用模板字符串语法

3. 排除服务器端临时故障
   500属于服务器内部错误，可尝试：

   • 间隔一段时间后重新发起请求
   • 在IoT Central门户中使用相同查询语句手动创建设备组，若门户创建失败则说明查询存在问题；若门户创建成功，需检查API请求的认证、请求头等其他细节

4. 验证API版本兼容性
   确认api-version=2022-07-31与你的IoT Central应用版本兼容，部分旧版本应用可能需要使用更早的API版本

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