检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
账号具备所有接口的调用权限，如果使用账号下的IAM用户发起API请求时，该IAM用户必须具备调用该接口所需的权限，否则，API请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，只有发起请求的用户被授予授权项所对应的策略，该用户才能成功调用该接口。例如，用户
通过调用注册接口向物联网平台发送注册请求或者在控制台上注册设备。 注册时需要填写设备标识码，通常使用MAC地址，Serial No或IMEI作为nodeId。 物联网平台向设备分配全局唯一的设备ID（deviceId）。 设备登录时，携带设备侧X.509证书发起接入鉴权请求。 平台验证通过后，返回成功响应，设备连接物联网平台成功。
需数据转发功能，可使用接口数据流转规则管理。 2020-09-17 第十三次正式发布 新增 网关新增子设备请求 网关新增子设备请求响应 网关删除子设备请求 网关删除子设备请求响应 2020-09-11 第十二次正式发布 新增 查询AMQP列表 创建AMQP队列 查询单个AMQP队列
常见MQTT消息类型主要有CONNECT、SUBSCRIBE、PUBLISH。 CONNECT：指客户端发起与服务端的连接请求。有效载荷（Payload）的主要参数，参考设备连接鉴权填写。 SUBSCRIBE：指客户端发起订阅的请求。有效载荷（Payload）中的主要参数“Topic name”，参考Topic定义中订阅者为设备的Topic。
网平台中的产品删除时，物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建产品删除通知规则的转发目标决定 请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 resource 是 String 参数说明：订阅的资源名称，取值为product。
务状态变更时，物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建批量任务状态变更通知规则的转发目标决定 请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 resource 是 String 参数说明：订阅的资源名称，取值为batchtask。
sys/messages/up?request_id={request_id}。若不指定，平台会自动生成request_id，用于标识此次请求。 参数说明 消息上报对数据内容不做固定的要求，当使用系统格式进行下发时，参数说明如下： 字段名 必选/可选 类型 参数描述 object_device_id
如何调用API 构造请求 认证鉴权 返回结果 父主题： 应用侧API参考
instance_type 否 String 参数说明：实例类型。 取值范围： standard：标准版实例 enterprise：企业版实例 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务
案进行设计： 应用平台调用同步命令接口下发命令A。 IoTDA收到同步命令A的请求后，会将命令转换为MQTT消息下发给设备，下发请求后平台会阻塞等待，等待设备返回命令A的执行结果。 设备收到命令A的请求，执行完对应操作后，返回命令A的响应。 IoTDA收到命令A的响应后返回命令结果给应用侧。
设备时间同步 设备时间同步请求 设备时间同步响应 父主题： 设备侧MQTT/MQTTS接口参考
缓存开关，用于开启缓存FunctionGraph的鉴权结果，缓存时间为300分钟~1天，默认不开启。 设备发起鉴权请求：设备通过MQTT协议发起的CONNECT请求需携带username参数，该参数应包含自定义鉴权的相关可选参数。 username格式如下。参数传值时需去掉大括号
个空格。 如果event_type为firmware_upgrade_v2、software_upgrade_v2，则在请求下载软固件包时不需要携带请求头。请求示例如下： GET https://******.obs.cn-north-4.myhuaweicloud.com:443/test
+ forecastDto); //9.执行请求 //10.使用com.huawei.apigateway:java-sdk-core:3.2.3版本的request函数构造请求参数 Request request = new Request();
SON或字符串对象。 PINGREQ：指客户端发给服务端的心跳请求。主要用于告知服务端客户端还活着、确认网络连接没有断开。约定的发送周期由协商的Keep Alive决定。 使用限制 上行Topic是指设备向平台发送请求，或上报数据，或回复响应。 下行Topic是指平台向设备下发指令，或回复响应。
配置自定义鉴权函数。在设备接入物联网平台时，物联网平台会获取设备ID和自定义鉴权函数名称等参数，并向FunctionGraph发起发起鉴权请求，由用户实现鉴权逻辑以完成设备的接入鉴权。 图1 自定义鉴权业务架构图 应用场景 迁移场景：当用户的设备从第三方云平台迁移到IoTDA平台
略变量在校验MQTT的主题时，会把变量变为接入设备对应的ID值，再进行匹配。 变量使用前缀“$”标记，后面跟一对大括号“{ }”，其中包含请求中值的变量名称。如下表，假设MQTT设备是在客户端ID为test_clientId，产品ID为test_productId，设备ID为test_deviceId。
如需了解实际场景下的计费样例以及各计费项在不同计费模式下的费用计算过程，请参见计费样例。 续费 包年/包月设备接入实例在到期后会影响设备接入服务的正常使用。如果您想继续使用设备接入服务，需要在规定的时间内为设备接入实例进行续费，否则实例将会自动释放，数据也可能会丢失。续费包括手动续费和自
ES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 单账号每秒最大MQTT连接请求数 10个 单个账号支持的最大MQTT连接数 10个/接入凭证 单个MQTT连接每秒最大推送速率 1000TPS 消息最大缓存时长及大小
网平台中的设备删除时，物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建设备删除通知规则的转发目标决定 请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 resource 是 String 参数说明：订阅的资源名称，取值为device。 event
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
