检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
修改设备信息 接口说明 应用服务器在物联网平台注册设备后，若设备的基本信息发生变更，可调用此接口在物联网平台修改设备的基本信息，包括设备类型、设备模型、厂商信息、接入协议等。 URI 请求方法 PUT URI /iocm/app/dm/v1.4.0/devices/{deviceId}
注册设备（密码方式） 接口说明 在设备接入物联网平台前，应用服务器需要调用此接口在物联网平台注册设备，获取设备ID和密码。在设备接入物联网平台时携带设备ID和密码，完成设备的接入认证。 此注册设备接口适用于使用MQTT协议接入的设备。 URI 请求方法 POST URI /iocm/app/reg/v2
查询设备影子 接口说明 若设备处于离线或异常状态时，应用服务器无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子，当设备重新上线时，设备影子会把配置下发给设备。应用服务器可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 注意事项 当前仅使用
增加设备组成员 接口说明 若需要把新增的设备或已有设备增加到某个设备组中，应用服务器可调用此接口向指定设备组添加设备成员。在向设备组添加设备前，建议通过“查询指定设备组”接口查询该设备组的当前设备数量及最大设备数量限制，确保设备组中还有足够的可添加成员数量。 注意事项 一个设备只能归属一个设备组。
刷新设备密钥 接口说明 已在物联网平台注册的设备，若设备的唯一标识码发生变更（如更换设备等场景），应用服务器需要调用此接口在物联网平台更新设备的唯一标识，并重新绑定设备。 注意事项 仅当设备处于离线状态时，才能进行刷新设备密钥操作。 URI 请求方法 PUT URI /iocm/app/reg/v1
NB设备接入时，出现513错误？ 终端设备每次上电后，都会向物联网平台发起TUP注册流程。TUP协议为华为私有协议，包装在CoAP协议之上，与LWM2M协议类似。海思芯片设置TUP注册过程不能超过4s，如果在4s内未完成TUP注册，则上报513错误。 当出现此513错误时，可以按照如下方法进行处理：
设备命令下发 接口说明 设备Profile文件中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令，设备不在线时命令下发失败。下发命令的具体格式需要应用服务器与设
更新设备状态 接口功能 通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建
注册设备（验证码方式） 接口说明 在设备接入物联网平台前，应用服务器需要调用此接口在物联网平台注册设备，并设置设备的唯一标识（如IMEI）。在设备接入物联网平台时携带设备唯一标识，完成设备的接入认证。 此注册设备接口适用于使用LWM2M/CoAP协议接入的设备，或者集成了AgentLite
String(1-64) 设备命令ID，用于唯一标识一条命令，在下发设备命令时由物联网平台分配获得。 appId String(1-64) 设备命令所属的应用ID。 deviceId String(1-64) 下发命令的设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。
String(1-64) 设备命令ID，用于唯一标识一条命令，在下发设备命令时由物联网平台分配获得。 appId String(1-64) 设备命令所属的应用ID。 deviceId String(1-64) 下发命令的设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。
设备绑定 接口功能 设备第一次接入物联网平台时需要进行绑定操作，上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用绑定配置接口设置物联网平台的IP与端口。 设备绑定是指设备第一次接入物联网平台的过程，需要开发者先在物联网平台注册直
path 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 cascade 必选 Boolean query 仅当设备下连接了非直连设备时生效，不设置时可填写null。 true，级联删除，即删除直连设备和其下的非直连设备。 false，删除直连设备，但是不删其
path 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 cascade 可选 String query 仅当设备下连接了非直连设备时生效，不设置时可填写None。 “true”，级联删除，即删除直连设备和其下的非直连设备。 “false”，删除直连设备，但是不
FG_IOCM_PORT。 设备绑定是指设备第一次接入物联网平台的过程，需要开发者先在物联网平台注册直连设备，之后在设备上发起绑定操作，将设备绑定到物联网平台上。如果未在物联网平台注册该设备，则绑定操作会失败，Agent Lite将会等待一段时间继续尝试。 接口描述 1 HW_INT
添加设备 接口功能 当有新设备接入网关后，通过调用设备添加接口将非直连设备接入物联网平台，并且获得平台分配的唯一设备逻辑ID。 接口描述 1 public static boolean addDevice(int cookie, IotaDeviceInfo deviceInfo);
网关ID，用于标识一个网关设备。当设备是直连设备时，gatewayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。 appId 可选 String query 设备所属的应用ID，当查询授权应用下设备的服务能力时才需要填写。
接口说明 物联网平台设备侧支持MQTT协议的connect消息接口，接口规范参考MQTT标准规范，鉴权通过后建立设备与平台间的MQTT连接。 物联网平台目前只支持MQTTS接入，设备通过connect消息接口跟平台建立MQTT连接时，需要携带TLS证书。TLS证书获取请在开发资源获取处获取Agent
删除设备组 典型场景 若因分组变更，第三方应用不再需要使用某个设备组，且不想在物联网平台上继续保存该设备组信息时，可调用此接口在物联网平台删除指定设备组。 接口功能 支持第三方应用在物联网平台根据设备组ID删除指定设备组。 接口描述 1 def deleteDeviceGroup(self
Bearer ****** 正常响应示例 Status Code: 200 OK 错误码 Http状态码 错误码 错误描述 说明 400 120015 Bad request error. 请求错误。 处理建议：请检查接口请求中fileId的格式是否正确。 403 1010009
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
