API 错误代码参考

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 命令   温控器 特征
在 MANUAL_ECO 模式下的温控器不允许使用命令。	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。
事件 ID 不属于相机。	400	FAILED_PRECONDITION	。eventID
由于超时，未能检索到答案 SDP。	504	DEADLINE_EXCEEDED	请再次尝试生成 WebRTC 直播。 另请参阅：
特征不存在。	400	INVALID_ARGUMENT	系统针对某个特征发送的命令不受支持。
无效的优惠 SDP 缺少 CRLF。	400	INVALID_ARGUMENT	在尝试生成 WebRTC 流时，offerSdp 字符串末尾缺少换行符。请确保 offerSdp 字符串以 \r\n 或 \n 结尾，然后再次尝试生成该数据流。 另请参阅：
优惠 SDP m 行无效。	400	INVALID_ARGUMENT	优惠 SDP 必须按顺序包含全部三个音频、视频和应用 M 行。 另请参阅：
优惠 SDP 无效。	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	温控器没有风扇功能。风扇相关特征和指令不适用于此设备。 另请参阅：   打开或关闭风扇任务   风扇 特征