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 秒后过期。请务必在图片过期之前下载。

另请参阅：
  下载摄像头图片任务
  显示屏设备
  门铃设备
  事件指南
  GenerateImage 命令
  CameraMotion trait
  CameraPerson trait
  CameraSound trait
  DoorbellChime trait
门铃不支持该命令。 400 FAILED_PRECONDITION 在电池供电的门铃上，无法延长 WebRTC 流式传输。如果需要在初始会话时长之后观看门铃上的直播，请停止现有直播并生成新的直播。

另请参阅：
  延长直播时长任务
  ExtendWebRtcStream 命令
当前温控器模式不允许执行该命令。 400 FAILED_PRECONDITION 根据 ThermostatMode trait，某些温控器型号不支持在温控器模式为“关闭”时更改节能模式。更改节能模式之前，必须将温控器模式更改为 HEAT、COOL 或 HEATCOOL。

另请参阅：
  更改模式任务
  SetMode 命令
  ThermostatMode 特征
{14point}15/}设置
当温控器处于 MANUAL_ECO 模式时，不允许执行此命令。 400 FAILED_PRECONDITION 当温控器处于手动节能模式时，无法设置温度设定值。

另请参阅：
  更改温度设定值任务
  ThermostatEco trait
  ThermostatTemperatureSetpoint trait
未提供命令。 404 NOT_FOUND 执行了命令，但请求正文中没有有效的命令名称。输入有效的命令。
不支持该命令。 400 INVALID_ARGUMENT 对支持 WebRTC 的摄像头使用了 RTSP 直播命令，或对支持 RTSP 的摄像头使用了 WebRTC 直播命令。

另请参阅：
  下载摄像头图片任务
包含无效值。 400 INVALID_ARGUMENT 提交的命令的参数值无效。请务必发送有效的值。
冷却值必须大于制热值。 400 INVALID_ARGUMENT 请确保命令中的 heatCelsius 字段小于 coolCelsius 字段。

另请参阅：
  更改温度设定值任务
  ThermostatTemperatureSetpoint 特征
找不到设备。 404 NOT_FOUND 指定的设备名称无效或缺失。指定有效的设备。

另请参阅：
  Connectivity trait
未找到企业。 404 NOT_FOUND 指定的 Project ID 无效或缺失。指定有效的 Project ID。
事件 ID 不属于摄像头。 400 FAILED_PRECONDITION eventID
由于超时，未能检索回答 SDP。 504 DEADLINE_EXCEEDED 尝试再次生成 WebRTC 直播。

另请参阅：
特征中不存在该字段。 400 INVALID_ARGUMENT 针对 trait 发送了不受支持的命令。
无效的优惠 SDP 缺少 CRLF。 400 INVALID_ARGUMENT 尝试生成 WebRTC 流时，offerSdp 字符串末尾缺少换行符。请确保 offerSdp 字符串以 \r\n 或 \n 结尾，然后尝试重新生成音频流。

另请参阅：
优惠 SDP m 行无效。 400 INVALID_ARGUMENT 提供商 SDP 必须包含音频、视频和应用 m-line 这三个 m-line，且必须按此顺序。

另请参阅：
优惠 SDP 无效。 400 INVALID_ARGUMENT 提供 SDP 音频必须设置为 a=recvonly（仅限接收）。

另请参阅：
权限遭拒。 403 PERMISSION_DENIED user 未向 developer授予在合作伙伴关联管理器 (PCM) 中执行命令所需的适当设备级权限。

生成 WebRTC 直播时，此错误可能还表示 offerSdp 中的音频设置不正确。

另请参阅：
  关联您的账号任务
  GenerateWebRtcStream 命令
速率受限。 429 RESOURCE_EXHAUSTED 每个开发者都有配额限制，用于限制其可以进行的调用次数。如果您发出的调用次数超出配额，则会收到“速率受限”消息。如需解决此问题，请在配额到期后重新提交调用。

另请参阅：
  沙盒调用频率限制概念
找不到会议室。 404 NOT_FOUND 建筑物中没有房间。对 rooms 资源进行列表调用以验证房间 ID。
找不到结构。 404 NOT_FOUND Project中不存在该结构。对结构体资源进行列表调用，以验证结构体 ID。
摄像头无法用于流式传输。 400 FAILED_PRECONDITION 摄像头处于离线状态，或者因技术问题而无法流式传输。

另请参阅：
  摄像头设备
  摄像头（电池版）设备
  摄像头（有线）设备
  门铃（电池版）设备
  门铃（有线）设备
  GenerateWebRtcStream 命令
温控器风扇不可用。 400 FAILED_PRECONDITION 温控器不具备风扇功能。此设备无法使用与风扇相关的特征和指令。

另请参阅：
  打开或关闭风扇任务
  风扇 特征