检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询设备命令 接口说明 应用服务器向设备下发命令后，可调用此接口在物联网平台查询下发命令的状态及内容信息，以了解命令的执行情况，可查询指定时间段内本应用下的所有下发命令，或者指定设备的所有下发命令。
下发命令的具体格式需要应用服务器与设备自定义，物联网平台在接口中直接进行封装，透传。 此接口适用于使用MQTT协议接入的设备，例如集成了AgentLite SDK的设备。
查询设备影子 接口说明 若设备处于离线或异常状态时，应用服务器无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子，当设备重新上线时，设备影子会把配置下发给设备。应用服务器可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。
场景说明 对于设备上报的数据，即使创建应用时开启了存储数据能力，设备管理服务也只保存7天的历史数据。 若您希望长期保存数据，可以选择让平台将设备上报数据推送给应用服务器，由应用服务器进行保存；还可以选择让平台将设备上报数据转发给对象存储服务（OBS），由OBS进行存储。
注册设备（密码方式） 接口说明 在设备接入物联网平台前，应用服务器需要调用此接口在物联网平台注册设备，获取设备ID和密码。在设备接入物联网平台时携带设备ID和密码，完成设备的接入认证。 此注册设备接口适用于使用MQTT协议接入的设备。
创建设备组 接口说明 应用服务器可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 注意事项 一个设备只能归属一个设备组。
创建软件升级任务 接口说明 若需要对设备进行软件版本升级，应用服务器可调用此接口为多个设备创建软件升级任务，升级前请确保目标版本包已上传到物联网平台。 注意事项 仅支持对使用LWM2M协议接入的设备进行软件升级。
若应用服务器需要调用物联网平台的API接口进行一些业务处理，请求中必须携带appId以接入对应的项目空间，鉴权接口携带在Body中，其他接口的appId的值一般携带在Header中。
例如转发至OBS存储，转发至DIS或DMS后再发送至应用服务器。 需要注意的是设备接入服务不解析数据，若设备采用二进制上报数据，则平台进行码流base64封装后再转发。 父主题： 方案咨询（联通用户专用）
删除设备组 接口说明 若因分组变更，应用服务器不再需要使用某个设备组，且不想在物联网平台上继续保存该设备组信息时，可调用此接口在物联网平台删除指定设备组。
查询单个设备信息 接口说明 已在物联网平台注册的设备，应用服务器若需要查看某个设备的详细信息（如厂商、型号、版本、状态和服务属性等信息），可调用此接口在物联网平台查询获取。
服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 父主题： 应用安全接入
场景说明 物联网平台支持设备数据上报和设备命令下发，但若要将两者联动起来，一般需要由应用服务器实现对应逻辑。 设备管理服务提供规则引擎功能，平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令，减少应用服务器开发工作量。
appId 应用的appId。appId是平台为伙伴服务器分配的ID。 accessToken 鉴权接口获取的accessToken。 父主题： 应用侧Python SDK API参考（联通用户专用）
批量创建设备命令 应用服务器若需要向多个设备下发相同的设备命令时，可调用此接口向批量设备下发命令。 此功能通过创建批量任务接口向设备下发批量任务实现，“taskType”参数设置为“DeviceCmd”时，为向批量设备下发命令。 父主题： 命令下发
public void setAppId(String appId) 设置应用的appId。appId是物联网平台为第三方应用分配的身份标识，用于唯一标识一个应用。 public void setSecret(String secret) 设置应用的secret。
删除子设备 若子设备不再需要接入物联网平台，应用服务器可调用此接口解绑网关下的子设备。 此功能通过设备命令下发接口向网关下发命令实现，具体删除子设备命令需网关提前实现（即网关收到什么命令会触发删除子设备的流程），并已在设备的Profile文件中定义。
注册设备（验证码方式） 接口说明 在设备接入物联网平台前，应用服务器需要调用此接口在物联网平台注册设备，并设置设备的唯一标识（如IMEI）。在设备接入物联网平台时携带设备唯一标识，完成设备的接入认证。
进阶体验 按照本页面的指导，使用Postman模拟应用服务器接入物联网平台后，您应该已经基本了解应用服务器如何通过调用物联网平台开放的接口与平台交互。 若您想要进一步体验设备管理服务，可参考开发指南开发真实应用和真实设备，并接入物联网平台，体验更多功能。
查询版本包列表 接口说明 在进行设备版本升级前，应用服务器可调用此接口查询已经上传到物联网平台的版本升级包列表信息，确保设备要升级的版本包已上传到平台，可根据条件查询满足要求的版本包。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
