修订记录

2025-11-30

第二十七次正式发布

新增

• 添加域配置 - CreateDomainConfiguration
• 获取域配置列表 - ListDomainConfigurations
• 删除域配置 - DeleteDomainConfiguration
• 查询域配置 - ShowDomainConfiguration
• 更新域配置 - UpdateDomainConfiguration
• 创建OTA模块 - CreateOtaModule
• 查询OTA模块列表 - ListOtaModules
• 查询OTA模块详情 - ShowOtaModule
• 删除OTA模块 - DeleteOtaModule
• 修改OTA模块 - UpdateOtaModule
• 添加服务器证书 - CreateServerCertificate
• 获取服务器证书列表 - ListServerCertificate
• 删除服务端证书 - DeleteServerCertificate
• 查询服务器证书 - ShowServerCertificate
• 查询CA证书 - ShowCertificate

修改

创建规则动作 - CreateRuleAction、查询规则动作列表 - ListRuleActions、查询规则动作 - ShowRuleAction接口，channel参数新增MQTT_DEVICE_FORWARDING枚举类型支持转发设备消息。

2025-09-09

第二十六次正式发布

新增

• 查询实例规格列表 - ListInstanceFlavors
• 查询实例任务列表 - ListInstanceTasks
• 查询实例任务详情 - ShowInstanceTask
• 重试实例任务 - RetryInstanceTask

• 删除设备影子数据 - DeleteDeviceShadow
• 查询安全态势感知配置信息列表 - ListSecurityProfiles
• 创建安全态势感知配置 - CreateSecurityProfile
• 查询某个具体id的安全态势感知配置详情 - ShowSecurityProfile
• 删除某个具体id的安全态势感知配置信息 - DeleteSecurityProfile
• 更新某个具体id的安全态势感知配置信息 - UpdateSecurityProfile
• 创建鸿蒙软总线 - AddHarmonySoftBus
• 查询鸿蒙软总线列表 - ListHarmonySoftBus
• 查询鸿蒙软总线 - ShowHarmonySoftBus
• 删除鸿蒙软总线 - DeleteHarmonySoftBus
• 同步鸿蒙软总线信息 - CreateSyncHarmonySoftBus
• 重置鸿蒙软总线密钥 - ResetHarmonySoftBusKey
• 查询设备证书列表 - ListDeviceCertificate
• 查询设备证书 - ShowDeviceCertificate
• 更新设备证书 - UpdateDeviceCertificate
• 删除设备证书 - DeleteDeviceCertificate
• 查询使用指定设备证书的设备列表 - ListDeviceByDeviceCertificate
• 创建设备鉴权模板 - CreateDeviceAuthenticationTemplate
• 查询设备鉴权模板列表 - ListDeviceAuthenticationTemplates
• 删除设备鉴权模板 - DeleteDeviceAuthenticationTemplate
• 修改设备鉴权模板 - UpdateDeviceAuthenticationTemplate
• 查询设备鉴权模板详情 - ShowDeviceAuthenticationTemplate

2025-07-29

第二十五次正式发布

新增

• 删除指定消息id的消息 - DeleteDeviceMessage

2025-02-28

第二十四次正式发布

新增

• 修改设备网关 - ChangeGateway

2024-11-26

第二十三次正式发布

新增

• 查询设备下队列中的命令 - ListAsyncCommands
• 查询设备下的历史命令 - ListAsyncHistoryCommands
• 统计设备下的历史命令总数 - CountAsyncHistoryCommands
• 创建编解码函数 - AddFunctions
• 查询编解码函数 - ListFunctions
• 删除编解码函数 - DeleteFunctions

2024-09-13

第二十二次正式发布

新增

• 创建设备接入实例 - CreateInstance
• 查询实例列表 - ListInstances
• 查询实例详情 - ShowInstance
• 修改实例信息 - UpdateInstance
• 删除实例 - DeleteInstance
• 修改实例规格信息 - ResizeInstance
• 修改实例计费模式 - ChangeInstanceChargeMode
• 添加实例标签 - BindInstanceTags
• 删除实例标签 - UnbindInstanceTags

2024-06-25

第二十一次正式发布

新增

• 创建设备策略 - CreateDevicePolicy
• 查询设备策略列表 - ListDevicePolicies
• 删除设备策略 - DeleteDevicePolicy
• 查询设备策略列表 - ListDevicePolicies
• 更新设备策略信息 - UpdateDevicePolicy
• 绑定设备策略 - BindDevicePolicy
• 解绑设备策略 - UnbindDevicePolicy
• 查询设备策略绑定的目标列表 - ShowTargetsInDevicePolicy
• 创建预调配模板 - CreateProvisioningTemplate
• 查询预调配模板列表 - ListProvisioningTemplates
• 删除预调配模板 - DeleteProvisioningTemplate
• 查询预调配模板详情 - ShowProvisioningTemplate
• 更新指定id的预调配模板信息 - UpdateProvisioningTemplate
• 创建自定义鉴权 - CreateDeviceAuthorizer
• 查询自定义鉴权列表 - ListDeviceAuthorizers
• 删除自定义鉴权 - DeleteDeviceAuthorizer
• 查询自定义鉴权详情 - ShowDeviceAuthorizer
• 更新指定id的自定义鉴权 - UpdateDeviceAuthorizer

2024-05-30

第二十次正式发布

新增

• 创建网桥 - AddBridge
• 查询网桥列表 - ListBridges
• 删除网桥 - DeleteBridge
• 重置网桥密钥 - ResetBridgeSecret
• 更新CA证书 - UpdateCertificate
• 查询指定设备加入的设备组列表 - ListDeviceGroupsByDevice

2024-04-26

第十九次正式发布

新增

• 创建设备代理 - CreateDeviceProxy
• 查询设备代理列表 - ListDeviceProxies
• 查询设备代理详情 - ShowDeviceProxy
• 修改设备代理 - UpdateDeviceProxy
• 删除设备代理 - DeleteDeviceProxy

2024-04-11

第十八次正式发布

新增

• 新建数据流转积压策略
• 查询数据流转积压策略列表
• 修改数据流转积压策略
• 查询数据流转积压策略
• 删除数据流转积压策略
• 新建数据流转流控策略
• 查询数据流转流控策略列表
• 修改数据流转流控策略
• 查询数据流转流控策略
• 删除数据流转流控策略

2024-03-29

第十七次正式发布

新增

• 更新资源空间

修改

• 创建批量任务、查询批量任务列表、查询批量任务接口，新增task_mode参数用于软固件升级任务支持网关模式，task_ext_info参数用于支持添加批量任务的额外扩展信息。

2024-03-13

第十六次正式发布

修改

上传设备CA证书、获取设备CA证书列表接口新增返回参数，provision_enable参数用于确认该CA证书是否开启自注册能力，template_id参数为开启自注册能力后关联的模板ID。

2024-02-27

第十五次正式发布

修改

创建规则、查询规则列表、修改规则、查询规则接口，调整ActionSmnForwarding结构中的message_content参数为非必选参数，调整message_title参数的取值范围，新增message_template_name参数用于提供选择SMN模板的能力。

2023-01-05

第十四次正式发布

修改

• 生成接入凭证：新增参数force_disconnect，用于生成接入凭证时供用户选择是否强制断开北向MQTT/AMQP的连接。

2023-12-06

第十三次正式发布

修改

• 重置设备密钥 - ResetDeviceSecret：新增参数secret_type，用于设置/更新设备辅密钥。
• 重置设备指纹 - ResetFingerprint：新增参数fingerprint_type，用于设置/更新设备辅指纹。
• 查询设备 - ShowDevice、创建设备 - AddDevice、修改设备 - UpdateDevice：新增响应参数secondary_secret、secondary_fingerprint，用于查询出设备的辅指纹/辅密钥。

2023-11-15

第十二次正式发布

修改创建规则动作、修改规则动作 - UpdateRuleAction、查询规则动作列表 - ListRuleActions、修改规则动作 - UpdateRuleAction接口。

• 调整dms_kafka_forwarding结构中的mechanism参数枚举值，新增security_protocol参数用以完整的支持kafka的安全认证能力。
• 新增http_forwarding结构中的signature_enable、token参数，用以提供HTTP推送多样化的安全认证能力。

2023-10-23

第十一次正式发布

修改

查询产品列表，新增product_name入参，支持产品名称检索能力。

2023-07-21

第十次正式发布

新增

• 删除批量任务
• 创建设备隧道
• 查询设备所有隧道
• 查询设备隧道
• 关闭设备隧道
• 删除设备隧道

2023-06-17

第九次正式发布

新增

• 重试批量任务
• 停止批量任务

修改

设备同步命令、修改设备属性接口，增加响应参数error_code、error_msg，用以支持返回同步操作时设备的异常行为，如超时未响应。

2023-05-13

第八次正式发布

修改

添加设备组、修改设备组、查询设备组列表、查询设备组接口，新增group_type、dynamic_group_rule参数，用以支持动态设备组能力。

2023-04-19

第七次正式发布

新增

下发广播消息接口。

修改

创建批量任务、查询批量任务列表、查询批量任务，修改task_type参数，增加支持"updateDevices"枚举值，用以支持批量更新设备任务。

2023-03-29

第六次正式发布

修改

创建规则、修改规则、查询规则列表、查询规则接口，新增device_linkage_status_condition参数，用于支持设备状态变化的联动规则条件。

2023-02-24

第五次正式发布

新增

• 创建OTA升级包
• 查询OTA升级包列表
• 查询OTA升级包详情
• 删除OTA升级包

修改

修改查询设备接口，新增响应参数connection_status_update_time、active_time参数用以查询设备的连接状态变更时间和激活时间。

2023-02-07

第四次正式发布

修改

创建规则动作、修改规则动作 - UpdateRuleAction、查询规则动作列表 - ListRuleActions、修改规则动作 - UpdateRuleAction接口，新增dms_rocketmq_forwarding、mrs_kafka_forwarding、roma_forwarding、influxdb_forwarding参数用以支持对rocketmq、kafka、roma、influxdb的消息流转能力。

2022-12-14

第三次正式发布

新增

灵活搜索设备列表接口。

修改

修改创建规则、修改规则、查询规则列表、查询规则接口，新增rule_type参数的枚举值"DEVICE_SIDE"，用以支持设备端测规则联动的能力。

2022-09-20

第二次正式发布

修改下发设备消息、查询设备消息接口，新增properties参数用于支持MQTT5.0特性能力。

2022-06-30

第一次正式发布

应用侧API参考

设备侧MQTT/MQTTS接口参考

设备侧HTTPS接口参考

模组AT指令参考