检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
略使用说明。 设备鉴权：设备发起连接鉴权（MQTT设备），鉴权参数填写请参考：设备连接鉴权。 订阅/发布消息：设备对云服务端进行主题发布或订阅。 策略鉴权：云服务端根据设备订阅/发布的Topic进行过滤，当该设备订阅的Topic被策略禁止，则响应失败ACK，订阅失败。若允许或未设定，则响应成功ACK，订阅成功。
MQTT客户端接入说明 在调用创建规则触发条件、创建规则动作和修改规则触发条件配置并激活规则后，您需要参考本文将MQTT客户端接入物联网平台，成功接入后，在您的服务端运行MQTT客户端，即可接收订阅的消息。 连接配置说明 MQTT客户端接入物联网平台的连接地址和连接认证参数说明如下： MQTT接入域名
平台通知网关子设备删除 功能介绍 平台将该网关删除的子设备信息通知给网关设备。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
平台下发获取版本信息通知 功能介绍 平台下发获取版本信息通知。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释： 平台
适用于资源需求波动的场景，可以随时开通，随时删除。 设备接入服务(IoTDA)计划于2023年1月1日起将原基础版升级为标准版免费单元，原基础版用户可继续使用基础版，新用户可直接使用标准版免费单元，支持平滑扩容至更高规格以及更多的服务组合能力。原基础版用户如需迁移至标准版可参考迁移指导。
创建设备 功能介绍 应用服务器可调用此接口在物联网平台创建一个设备，仅在创建后设备才可以接入物联网平台。 该接口支持使用gateway_id参数指定在父设备下创建一个子设备，并且支持多级子设备，当前最大支持二级子设备。 该接口同时还支持对设备进行初始配置，接口会读取创建设备请求参
创建设备代理 功能介绍 应用服务器可调用此接口在物联网平台创建一个动态设备代理规则，用于子设备自主选择网关设备上线和上报消息，即代理组下的任意网关下的子设备均可以通过代理组里其他设备上线(网关更新子设备状态 )然后进行数据上报(网关批量设备属性上报 )。 单实例最多可以配置10个设备代理
查询规则条件列表 功能介绍 应用服务器可调用此接口查询物联网平台中设置的规则条件列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/routing-rule/rules 表1 路径参数 参数 是否必选 参数类型 描述 project_id
修改设备代理 功能介绍 应用服务器可调用此接口修改物联网平台中指定设备代理的基本信息。 调用方法 请参见如何调用API。 URI PUT /v5/iot/{project_id}/device-proxies/{proxy_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
API概览 设备鉴权 API 说明 设备鉴权 设备鉴权接口，鉴权通过后建立设备与平台间才能处理业务连接。鉴权成功后平台返回access_token。调用属性上报、消息上报等其他接口时，都需要携带access_token信息。如果access_token超期，需要重新认证设备获取a
广播通信概述 概述 广播通信常用于一对多的消息通信。多个设备订阅相同的广播Topic，应用服务器调用广播消息下发的接口指定广播Topic的名称，就可以给已订阅该广播Topic的所有在线设备发布消息。广播模式的典型用途是根据设备的类别向设备发送通知。 例如，地震局给指定区域内的所有公民发送地震预警信息。
包年/包月转按需 购买包年/包月设备接入实例后，您可以将该设备接入实例的计费模式转为按需计费，回收部分成本，同时更加灵活地使用设备接入服务。 包年/包月转按需，支持两种方式： 即时转按需：按需的计费模式立即生效。 到期转按需：包年/包月计费模式到期后，按需的计费模式才会生效。 约束与限制
按需转包年/包月 如果您需要长期使用设备接入标准版服务，可以将设备接入标准版实例转为包年/包月计费模式，以节省开支。按需计费变更为包年/包月会生成新的订单，用户支付订单后，包年/包月资源将立即生效。 假设用户于2023/04/18 15:29:16开通了按需计费的标准版低频单元S
网关删除子设备请求 功能介绍 网关主动删除其下接入的子设备，在平台上完成销户。网关与子设备关系，请查看网关与子设备。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
设备信息上报 功能描述 设备向平台上报设备信息。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释： 网关设备上报时，子设备
创建自定义鉴权 功能介绍 应用服务器可调用此接口在物联网平台创建一个自定义鉴权。自定义鉴权是指用户可以通过函数服务自定义实现鉴权逻辑，以对接入平台的设备进行身份认证。 单个实例最大可配置10个自定义鉴权 仅标准版实例、企业版实例支持该接口调用，基础版不支持。 调用方法 请参见如何调用API。
灵活搜索设备列表 功能介绍 接口说明 应用服务器使用SQL语句调用该接口，灵活的搜索所需要的设备资源列表 限制 仅标准版实例、企业版实例支持该接口调用，基础版不支持。 单账号调用该接口的 TPS 限制最大为1/S(每秒1次请求数) 类SQL语法使用说明 类SQL语句由select
List<ServiceProperty> Body 参数解释: 设备服务数据列表。 表1 ServiceProperty 名称 必选 类型 说明 service_id 是 String 参数解释: 设备服务id。 properties 是 Object 参数解释: 设备服务的属性列表，具体字段在设备关联的产品模型中定义。
网关更新子设备状态 功能介绍 网关更新子设备状态，更新结果通过网关更新子设备状态响应接口通知网关设备。网关与子设备关系，请查看网关与子设备。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述
设备时间同步响应 功能描述 平台向设备发送时间同步响应，携带设备发送时间device_send_time。当平台收到时间server_recv_time 后，向设备发送时间server_send_time 。 例如，设备收到的设备侧时间为device_recv_time ，则设备计算自己的准确时间为：
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
