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 秒后过期。请务必在过期前下载。 另请参阅: 下载图片任务 展示设备 设备 事件指南 生成日志命令 {1/28 。 |
400 | FAILED_PRECONDITION |
WebRTC 流无法放在由电池驱动的门铃上。如果需要在超出初始会话时长的基础上查看门铃直播,请停止现有直播并生成新的直播。 另请参阅: 延长直播任务 ExtendWebRtcStream 命令 |
400 | FAILED_PRECONDITION |
根据 ThermostatMode 特征,某些温控器型号不支持在温控器模式关闭时更改节能模式。在更改节能模式之前,您必须将温控器模式更改为 HEAT、COOL 或 HEATCOOL。 另请参阅: 更改模式任务 SetMode 命令 温控器 特征 |
400 | FAILED_PRECONDITION |
当温控器处于节能模式时,无法设置温度设置点。 另请参阅: 更改温度设定点任务 ThermostatEco 特征 ThermostatTemperatureSetpoint trait |
404 | NOT_FOUND |
一条命令在请求正文中没有有效的命令名称。请输入有效的命令。 |
400 | INVALID_ARGUMENT |
对支持 WebRTC 的相机使用 RTSP 直播命令,或对支持 RTSP 的相机使用 WebRTC 直播命令。 另请参阅: 下载相机图片任务 |
400 | INVALID_ARGUMENT |
所提交命令的参数中含有无效值。请务必发送一个有效值。 |
400 | INVALID_ARGUMENT |
请确保 heatCelsius 字段小于命令中的 coolCelsius 字段。另请参阅: 更改温度设定点任务 温控器温度设置 特征 |
404 | NOT_FOUND |
指定的设备名称无效或缺失。请指定有效设备。 另请参阅: 连接性 特征 |
404 | NOT_FOUND |
指定的 Project ID 无效或缺失。请指定有效的 Project ID。 |
400 | FAILED_PRECONDITION |
。eventID |
504 | DEADLINE_EXCEEDED |
请再次尝试生成 WebRTC 直播。 另请参阅: |
400 | INVALID_ARGUMENT |
系统针对某个特征发送的命令不受支持。 |
400 | INVALID_ARGUMENT |
在尝试生成 WebRTC 流时,offerSdp 字符串末尾缺少换行符。请确保 offerSdp 字符串以 \r\n 或 \n 结尾,然后再次尝试生成该数据流。另请参阅: |
400 | INVALID_ARGUMENT |
优惠 SDP 必须按顺序包含全部三个音频、视频和应用 M 行。 另请参阅: |
400 | INVALID_ARGUMENT |
优惠 SDP 音频必须设置为a=recvonly (仅限接收)。另请参阅: |
403 | PERMISSION_DENIED |
user 未在合作伙伴连接管理器 (PCM) 中授予执行命令所需的相应设备级权限。 生成 WebRTC 直播时,此错误也表示 offerSdp 中的音频设置不正确。另请参阅: 关联您的帐号任务 GenerateWebRtcStream 命令 developer |
429 | RESOURCE_EXHAUSTED |
每个开发者都有一个配额,用于限制其可以发出的调用次数。如果调用的配额超过配额,您会收到速率限制消息。如需解决此问题,请在配额过期后重新提交通话。 另请参阅: 沙盒速率限制概念 |
404 | NOT_FOUND |
该结构在聊天室中不存在。对会议室资源进行列表调用以验证会议室 ID。 |
404 | NOT_FOUND |
相应结构在 Project中不存在。对结构资源进行列表调用以验证结构 ID。 |
400 | FAILED_PRECONDITION |
温控器没有风扇功能。风扇相关特征和指令不适用于此设备。 另请参阅: 打开或关闭风扇任务 风扇 特征 |