Smart Device Management API 使用标准 gRPC 错误代码。如需详细了解这些代码，请参阅错误处理。
API 中的错误响应采用以下格式：
{
"error": {
"code": 404,
"message": "Device enterprises/project-id/devices/device-id not found.",
"status": "NOT_FOUND"
}
}
使用“错误代码”表中的搜索框查找 API 错误，以及问题排查提示和相关特征与指南。您可以搜索表格中任何字段中的内容。
| 错误消息 | HTTP | RPC | 问题排查 |
|---|---|---|---|
| 摄像头图像已无法再下载。 | 504 | DEADLINE_EXCEEDED |
活动图片会在活动发布 30 秒后过期。请务必在过期前下载图片。 另请参阅： 下载摄像头拍摄的图片任务 显示设备 门铃设备 活动指南 GenerateImage 命令 CameraMotion 特征 CameraPerson 特征 CameraSound 特征 DoorbellChime 特征 |
| 门铃不支持该命令。 | 400 | FAILED_PRECONDITION |
在电池供电的门铃上，WebRTC 流无法延长。如果门铃上的视频流需要超出初始会话时长进行查看，请停止现有视频流并生成新的视频流。 另请参阅： 延长直播任务 ExtendWebRtcStream 命令 |
| 当前温控器模式不允许使用该命令。 | 400 | FAILED_PRECONDITION |
根据 ThermostatMode 特征，某些温控器型号在温控器模式为 OFF 时不支持更改节能模式。必须先将温控器模式更改为 HEAT、COOL 或 HEATCOOL，然后才能更改节能模式。 另请参阅： 更改模式任务 SetMode 命令 ThermostatMode 特征 ThermostatTemperatureSetpoint 特征 |
| 当温控器处于 MANUAL_ECO 模式时，不允许使用此命令。 | 400 | FAILED_PRECONDITION |
当温控器处于手动节能模式时，无法设置温度设定值。 另请参阅： 更改温度设定值任务 ThermostatEco 特征 ThermostatTemperatureSetpoint 特征 |
| 未提供命令。 | 404 | NOT_FOUND |
执行的命令在请求正文中没有有效的命令名称。请输入有效命令。 |
| 不支持该命令。 | 400 | INVALID_ARGUMENT |
为支持 WebRTC 的摄像头使用了 RTSP 直播命令，或为支持 RTSP 的摄像头使用了 WebRTC 直播命令。 另请参阅： 下载摄像头图像任务 |
| 包含无效值。 | 400 | INVALID_ARGUMENT |
提交的命令的实参中包含无效值。请务必发送有效值。 |
| 冷却值必须大于加热值。 | 400 | INVALID_ARGUMENT |
确保命令中的 heatCelsius 字段小于 coolCelsius 字段。另请参阅： 更改温度设定值任务 ThermostatTemperatureSetpoint 特征 |
| 找不到设备。 | 404 | NOT_FOUND |
指定的设备名称无效或缺失。指定有效的设备。 另请参阅： 连接 特性 |
| 未找到企业。 | 404 | NOT_FOUND |
指定的 Project ID 无效或缺失。指定有效的 Project ID。 |
| 事件 ID 不属于相应相机。 | 400 | FAILED_PRECONDITION |
使用摄像头事件返回的正确 eventID。另请参阅： 处理摄像头事件任务 显示设备 处理门铃和摄像头事件任务 事件指南 CameraEventImage 特征 CameraMotion 特征 CameraPerson 特征 CameraSound 特征 DoorbellChime 特征 |
| 由于超时，未能检索到回答 SDP。 | 504 | DEADLINE_EXCEEDED |
请尝试重新生成 WebRTC 直播。 另请参阅： |
| 特征中不存在相应字段。 | 400 | INVALID_ARGUMENT |
针对某个特征发送了不受支持的命令。 |
| 无效的 Offer SDP 缺少 CRLF。 | 400 | INVALID_ARGUMENT |
尝试生成 WebRTC 流时，offerSdp 字符串末尾缺少换行符。请确保 offerSdp 字符串以 \r\n 或 \n 结尾，然后尝试重新生成数据流。另请参阅： |
| 提议 SDP m 行无效。 | 400 | INVALID_ARGUMENT |
SDP 必须包含音频、视频和应用 m-line 这三者，且顺序必须如此。 另请参阅： |
| 提议 SDP 无效。 | 400 | INVALID_ARGUMENT |
Offer SDP 音频必须设置为 a=recvonly（仅接收）。另请参阅： |
| 权限遭拒。 | 403 | PERMISSION_DENIED |
user 未在合作伙伴连接管理器 (PCM) 中向 developer授予执行命令所需的相应设备级权限。 生成 WebRTC 直播时，此错误也可能表示 offerSdp中的音频设置不正确。另请参阅： 关联您的账号任务 GenerateWebRtcStream 命令 |
| 可配置数量暂时已达上限。 | 429 | RESOURCE_EXHAUSTED |
每个开发者都有配额限制，规定了他们可以进行的调用次数。如果您进行的调用次数超过配额，则会收到“速率受限”消息。如需解决此问题，请在配额到期后重新提交调用。 另请参阅： 沙盒调用频率限制概念 |
| 找不到会议室。 | 404 | NOT_FOUND |
结构中不存在相应会议室。 对会议室资源进行列表调用，以验证会议室 ID。 |
| 找不到结构。 | 404 | NOT_FOUND |
该结构在 Project中不存在。对结构资源进行列表调用，以验证结构 ID。 |
| 摄像头无法用于流式传输。 | 400 | FAILED_PRECONDITION |
摄像头处于离线状态，或者由于技术问题而无法进行直播。 另请参阅： 摄像头设备 摄像头（电池供电）设备 摄像头（有线）设备 门铃（电池供电）设备 门铃（有线）设备 GenerateWebRtcStream 命令GenerateWebRtcStream |
| 温控器风扇不可用。 | 400 | FAILED_PRECONDITION |
温控器不支持风扇。 风扇相关特征和命令无法用于此设备。 另请参阅： 开启或关闭风扇任务 风扇 特征 |