检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
注册设备 在使用IoTDA进行收发消息前，您需要创建产品和设备。 访问设备接入服务，单击“控制台”进入设备接入控制台。选择左侧导航栏“IoTDA实例”，单击您需要的实例卡片进入实例。 创建产品。单击左侧导航栏“产品”，单击页面左侧的“创建产品”。根据页面提示填写参数，然后单击“确定”，完成产品的创建。
是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 响应参数
HTTP_FORWARDING：HTTP服务消息类型。 DIS_FORWARDING：转发DIS服务消息类型。 OBS_FORWARDING：转发OBS服务消息类型。 AMQP_FORWARDING：转发AMQP服务消息类型。 DMS_KAFKA_FORWARDING：转发kafka消息类型。 ROMA
图1 设备属性上报 使用场景 设备端及应用端需要平台进行转换、管理、缓存的数据。 需要通过数据转发规则转发到华为云其他云服务上进行存储和处理的场景。 使用限制 单个消息内容不大于64KB。 需要设置产品模型，数据内容需要与产品模型中定义的属性相匹配。 网关上报子设备属性时一次最大可上报子设备数量为100个。
设备Topic策略概述 概述 设备策略主要用于对发布/订阅的非$oc开头自定义topic中的数据进行传输限制。通过灵活访问的控制模型，提供了基于用户角色的访问控制，能够管理客户端发布/订阅主题的授权。借助策略功能，可以用于管理一个或多个设备/产品/群组发布、订阅的权限，以保证非$
删除资源空间 功能介绍 删除指定资源空间。删除资源空间属于高危操作，删除资源空间后，该空间下的产品、设备等资源将不可用，请谨慎操作！ 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/apps/{app_id} 表1 路径参数 参数
例规格，实例规格变更不会对业务产生影响。 访问设备接入服务，单击“管理控制台”进入设备接入控制台。 选择左侧导航栏“IoTDA实例”，单击实例对应的“变更”选择变更后的实例规格。 可设置延迟生效，选定维护的时间窗口，将会在指定时间窗口内进行变更。 图3 实例管理-变更规格 续费/退订
SDK代码，使设备上线，并订阅广播topic。然后运行应用侧SDK代码，调用broadcastMessage接口向设备发送广播消息，设备侧收到的广播消息样例如下： 图1 广播消息样例 父主题： 广播通信
网关删除子设备请求响应 功能介绍 平台将该网关删除的子设备列表信息通知给网关设备。平台收到网关删除子设备请求后会在30秒内通过此接口返回响应消息。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down
设备接入服务如何获取设备数据？ 全新升级后的设备接入服务获取设备数据，需要通过规则引擎，将数据转发至其他服务获取。例如转发至OBS存储，转发至DIS或DMS后再发送至应用服务器。 父主题： 方案咨询
数据转发至华为云服务 数据转发至DIS 数据转发至RocketMQ 数据转发至GeminiDB Influx 数据转发至Kafka存储 数据转发至FunctionGraph函数工作流 数据转发至MySQL存储 数据转发至OBS长期存储 数据转发至BCS可信上链 数据转发至MongoDB存储
）。 主题中“/”分隔符不超过7个。 若发布、订阅的主题不符合以上限制，会直接拒绝本次订阅/发布请求。在设备“详情页面>消息跟踪”中可以看到报错。 图1 消息跟踪-策略校验 父主题： 设备Topic策略
网关更新子设备状态响应 功能介绍 平台将该网关更新子设备状态结果以列表返回，平台收到网关更新子设备状态请求后会在30秒内通过此接口返回响应消息。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down
接入功能。 已开通设备接入服务。未开通则访问设备接入服务，单击“立即使用”后开通该服务。 已开通OBS服务。未开通则访问OBS服务，单击“立即使用”后开通该服务。 已开通数据可视化DLV服务。未开通则访问数据可视化DLV服务，单击“立即使用”后开通该服务。 示例场景 在本示例中，我们实现下述场景：
和其他服务的关系 设备发放服务与其他服务的关系如表1所示。 表1 与其他服务的关系列表 交互功能 相关服务 位置 创建设备时，需要使用设备接入服务创建的产品 设备接入服务（IoT Device Access，IoTDA） 创建产品 创建自定义策略时需要使用函数 函数工作流服务（FunctionGraph）
备连接鉴权。 订阅/发布消息：设备对云服务端进行主题发布或订阅。 策略鉴权：云服务端根据设备订阅/发布的Topic进行过滤，当该设备订阅的Topic被策略禁止，则响应失败ACK，订阅失败。若允许或未设定，则响应成功ACK，订阅成功。 设备侧发布成功的消息数据可通过数据流转推送到应用侧。
OBS对应桶页面上传升级文件。勾选需要的OBS对象后单击按钮“下一步”。 如果设备接入服务未访问授权密钥管理服务（KMS)，请单击“加密服务授权”处的“访问授权”进行授权访问，否则在OBS服务侧设置或修改存储桶配置为启用“默认加密”时，会影响升级文件的下载。 图1 上传升级包-OBS文件
iotda:messages:queryList 查询指定消息id的消息 GET /v5/iot/{project_id}/devices/{device_id}/messages/{message_id} iotda:messages:query 下发广播消息 POST /v5/iot/{pro
展字段服务端才会返回Certificate Status。 在左侧导航栏中选择“设备 > 所有设备”，选择对应设备，单击“详情 > 消息跟踪 > 启动消息跟踪”，使用MQTT模拟器证书双向认证，设备端使用已吊销证书，查看消息跟踪错误详情。 图5 设备证书-已吊销 图6 消息跟踪-OCSP校验失败详情
添加设备。添加已注册的设备到指定的设备组中。 removeDevice: 删除设备。从指定的设备组中删除设备，只是解除了设备和设备组的关系，该设备在平台仍然存在。 device_id 是 String 参数说明：设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
