以下是物联网平台API列表。

重要

在MQTT型企业版实例下,仅支持使用产品管理设备管理服务端订阅云产品流转(新版)分组管理消息通信相关的部分API。详细说明,请参见对应API列表中最后一列说明。

实例迁移的API

API

描述

MQTT型实例下是否支持

BatchGrayMigrationDevice

实例迁移时,如果有新增设备未灰度迁移,可以调用本接口持续灰度迁移增量设备。

产品管理的API

API

描述

MQTT型实例下是否支持

CreateProduct

创建产品。

是。

UpdateProduct

修改产品信息。

是。

QueryProductList

查询产品列表。

是。

QueryProduct

查询产品详细信息。

是。

DeleteProduct

删除指定产品。

是。

CreateProductTags

创建产品标签。

是。

UpdateProductTags

更新产品标签。

是。

DeleteProductTags

删除产品标签。

是。

ListProductTags

查询产品的所有标签。

是。

ListProductByTags

根据标签查询产品。

是。

UpdateProductFilterConfig

更新产品下设备上报的属性去重规则。

否。

QueryProductCertInfo

获取产品的X.509证书信息。

否。

SetProductCertInfo

设置产品的X.509证书信息。

否。

ReleaseProduct

发布指定产品。

是。

CancelReleaseProduct

取消指定产品的发布。

是。

设备管理的API

功能项

API

描述

MQTT型实例下是否支持

设备的注册

RegisterDevice

单个注册设备。

否。

BatchRegisterDevice

批量注册多个设备(随机生成设备名称)。

否。

BatchCheckDeviceNames

批量自定义设备名称,物联网平台会检查名称的合法性。

否。

BatchRegisterDeviceWithApplyId

根据ApplyId批量申请设备。

否。

QueryBatchRegisterDeviceStatus

查询批量注册设备申请的处理状态和结果。

是。

设备生命周期

DisableThing

禁用设备。

是。

EnableThing

解禁设备。

是。

ResetThing

重置设备。

是。

DeleteDevice

删除设备。

是。

设备标识

QueryClientIds

一型一密免注册场景下,查看单个设备的标识列表。

否。

TransformClientId

一型一密免注册场景下,若设备包含多个设备标识,需指定一个正确的设备标识,以防止非法的设备登录。

否。

DeleteClientIds

一型一密免注册场景下,若单个设备的标识个数超出限制(5个),可删除设备下的所有标识。

否。

设备信息

BatchUpdateDeviceNickname

批量更新设备的备注名称。

是。

QueryDeviceInfo

查询指定设备的基本信息(设备ID、设备证书和备注名称)。

是。

QueryDeviceDetail

查询设备详情。

是。

BatchQueryDeviceDetail

批量查询设备详情。

是。

QueryPageByApplyId

查询批量注册的设备信息。

是。

QueryDevice

查询产品的设备列表。

是。

GetDeviceStatus

获取设备的运行状态。

是。

BatchGetDeviceState

批量获取设备状态。

是。

QueryDeviceByStatus

根据设备状态查询设备列表。

否。

ListOTAModuleVersionsByDevice

查询设备上报过的OTA模块版本列表。

否。

QueryDeviceBySQL

通过SQL语句快速搜索满足指定条件的设备。

否。

QueryDeviceStatistics

获取设备的统计数量。

是。

设备标签

SaveDeviceProp

设置设备标签。

是。

QueryDeviceProp

查询设备标签列表。

是。

QueryDeviceByTags

根据标签查询设备。

是。

DeleteDeviceProp

删除设备标签。

是。

网关与子设备

BatchAddThingTopo

批量添加设备拓扑关系。

否。

NotifyAddThingTopo

通知网关增加设备拓扑关系。

否。

GetThingTopo

查询网关设备的子设备列表。

否。

GetGatewayBySubDevice

根据挂载的子设备信息查询对应的网关设备信息。

否。

RemoveThingTopo

移除网关设备或子设备所具有的拓扑关系。

否。

LoRaWAN设备

CreateLoRaNodesTask

创建批量注册LoRaWAN设备的任务。

否。

GetLoraNodesTask

查询批量注册LoRaWAN设备任务的状态。

否。

QueryLoRaJoinPermissions

查询账号下的LoRaWAN入网凭证列表。

否。

设备X.509证书

QueryDeviceCert

查询单个设备的X.509证书。

否。

QueryCertUrlByApplyId

查询批量注册设备的X.509证书下载链接。

否。

云网关设备

ImportDevice

MQTT型实例或MQTT云网关产品下单个导入设备。

否。

BatchImportDevice

MQTT型实例或MQTT云网关产品下批量导入设备。

是。

BatchCheckImportDevice

批量校验在MQTT型实例或MQTT云网关产品下批量导入的设备。

是。

QueryImportedDeviceByApplyId

根据申请批次ID(ApplyId)查询批量导入的设备列表。

是。

BatchImportVehicleDevice

在JT/T 808协议、GB/T 32960协议和SL 651协议云网关产品下批量导入设备。

否。

BatchCheckVehicleDevice

批量校验导入的JT/T 808协议、GB/T 32960协议和SL 651协议云网关设备。

否。

QueryVehicleDevice

查询JT/T 808协议、GB/T 32960协议和SL 651协议云网关设备信息。

否。

设备文件

QueryDeviceFileList

查询指定设备上传到物联网平台的所有文件。

否。

QueryDeviceFile

查询指定设备上传到物联网平台的指定文件信息。

否。

DeleteDeviceFile

删除指定设备上传到物联网平台的指定文件。

否。

物模型管理的API

API

描述

MQTT型实例下是否支持

CreateThingModel

为指定产品的物模型新增功能,支持定义物模型扩展描述。

否。

UpdateThingModel

更新指定产品物模型中的单个功能,支持更新物模型扩展描述。

QueryThingModel

查看指定产品的物模型中的功能定义详情。

CopyThingModel

复制指定产品的物模型到目标产品。

PublishThingModel

发布指定产品的物模型。

DeleteThingModel

删除指定产品物模型中的指定功能。

ListThingTemplates

获取物联网平台预定义的产品品类列表。

GetThingTemplate

查询指定品类的标准物模型信息。

ListThingModelVersion

获取指定产品的物模型历史版本列表。

GetThingModelTsl

查询指定产品的物模型。

ImportThingModelTsl

为指定产品导入物模型TSL,暂不支持扩展描述配置。

QueryThingModelPublished

查看指定产品的已发布物模型中的功能定义详情。

GetThingModelTslPublished

查询指定产品的已发布物模型TSL。

QueryThingModelExtendConfig

导出指定产品的物模型扩展描述配置。

QueryThingModelExtendConfigPublished

导出已发布物模型的扩展描述配置。

CreateThingScript

为指定产品提交数据解析脚本。

UpdateThingScript

修改指定产品的数据解析脚本。

GetThingScript

查询指定产品的数据解析脚本。

物模型使用的API

API

描述

MQTT型实例下是否支持

SetDeviceProperty

设置设备的属性。

否。

SetDevicesProperty

批量设置设备属性。

InvokeThingService

调用设备的服务。

InvokeThingsService

批量调用设备的服务。

QueryDevicePropertyData

查询设备的属性历史数据。

QueryDevicePropertiesData

批量查询指定设备的多个属性的历史数据。

QueryDeviceEventData

查询设备的事件历史数据。

QueryDeviceServiceData

获取设备的服务记录历史数据。

SetDeviceDesiredProperty

为指定设备批量设置期望属性值。

QueryDeviceDesiredProperty

查询指定设备的期望属性值。

QueryDevicePropertyStatus

查询指定设备的属性快照。

QueryDeviceOriginalPropertyStatus

查询指定设备的原始属性快照。

QueryDeviceOriginalPropertyData

查询指定设备的原始属性记录。

QueryDeviceOriginalEventData

查询指定设备的原始事件记录。

QueryDeviceOriginalServiceData

查询指定设备的原始服务调用记录。

ClearDeviceDesiredProperty

清空设备下已设置的期望属性值。

Topic管理的API

API

描述

MQTT型实例下是否支持

CreateProductTopic

创建产品自定义Topic类。

否。

UpdateProductTopic

修改产品自定义Topic类。

QueryProductTopic

查询产品自定义Topic类。

DeleteProductTopic

删除产品自定义Topic类。

CreateTopicRouteTable

添加Topic路由表。

QueryTopicRouteTable

查询Topic路由表。

QueryTopicReverseRouteTable

查询Topic反向路由表。

DeleteTopicRouteTable

删除Topic路由表。

分组管理的API

API

描述

MQTT型实例下是否支持

CreateDeviceGroup

创建静态分组。

是。

CreateDeviceDynamicGroup

创建动态分组。

否。

DeleteDeviceGroup

删除静态分组。

是。

DeleteDeviceDynamicGroup

删除动态分组。

否。

UpdateDeviceGroup

修改分组信息。

是。

QueryDeviceGroupInfo

查询分组详情。

是。

QueryDeviceGroupList

分页查询分组列表。

是。

QueryDynamicGroupDevices

查询动态分组下的设备列表。

否。

BatchAddDeviceGroupRelations

添加设备到静态分组。

是。

BatchDeleteDeviceGroupRelations

删除分组中已添加的指定设备。

是。

SetDeviceGroupTags

添加或更新分组标签。

是。

QueryDeviceGroupTagList

查询分组标签列表。

是。

QueryDeviceGroupByDevice

查询指定设备所在的分组列表。

是。

QuerySuperDeviceGroup

根据子分组ID查询父分组信息。

是。

QueryDeviceListByDeviceGroup

查询分组中的设备列表。

是。

QueryDeviceGroupByTags

根据标签查询设备分组。

是。

设备分发的API

API

描述

MQTT型实例下是否支持

CreateDeviceDistributeJob

创建设备分发任务,默认同时分发设备所属产品。

否。

CreateProductDistributeJob

创建产品分发任务,分发指定产品到指定的目标实例。

QueryDeviceDistributeDetail

获取设备分发任务执行完成后的结果信息。

QueryDeviceDistributeJob

获取设备分发任务的详细信息。

ListDeviceDistributeJob

获取设备分发任务列表。

DeleteDeviceDistributeJob

删除设备分发任务。

ListDistributedDevice

查询已分发的设备列表。

ListDistributedProduct

查询已分发的产品列表。

QueryDeviceProvisioning

查询指定设备的分发结果。

设备影子的API

API

描述

MQTT型实例下是否支持

GetDeviceShadow

查询设备影子。

否。

UpdateDeviceShadow

更新设备影子。

消息通信的API

API

描述

MQTT型实例下是否支持

SubscribeTopic

为指定设备订阅Topic。

否。

UnsubscribeTopic

为指定设备取消已订阅的指定Topic。

QueryDeviceSubTopic

查询设备已订阅的Topic列表。

否。

UpdateTopicConfig

设置自定义Topic是否支持保留消息广播。

Pub

通过自定义Topic向指定设备发布消息,支持向指定产品下订阅了指定自定义Topic的在线设备发送广播消息。

是。

BatchPub

通过自定义Topic向指定产品下的多个设备批量发送消息。

是。

PubBroadcast

向指定产品所有设备,或向订阅了指定Topic的所有设备发布广播消息。

否。

RRpc

向指定设备发送请求消息,并同步返回响应。

否。

AsyncRRpc

向指定设备发送消息。

是。

QueryMessageInfo

查询设备上下行消息的详情,包括消息的内容、消息的产生时间、发送消息的Topic等。

是。

服务端订阅API

API

描述

MQTT型实例下是否支持

CreateSubscribeRelation

创建MNS或AMQP服务端订阅。

是。

UpdateSubscribeRelation

修改MNS或AMQP服务端订阅。

是。

QuerySubscribeRelation

查询MNS或AMQP服务端订阅。

是。

DeleteSubscribeRelation

删除MNS或AMQP服务端订阅。

是。

CreateConsumerGroup

创建一个消费组,用于创建AMQP服务端订阅。

是。

UpdateConsumerGroup

修改消费组名称。

是。

QueryConsumerGroupByGroupId

根据消费组ID查询消费组详情。

是。

QueryConsumerGroupList

查询用户所有消费组列表,或按消费组名称进行模糊查询。

是。

QueryConsumerGroupStatus

使用AMQP服务端订阅时,查询某个消费组的状态,包括在线客户端信息、消息消费速率、消息堆积数、最近消息消费时间。

是。

ResetConsumerGroupPosition

使用AMQP服务端订阅时,清空某个消费组的堆积消息。

是。

DeleteConsumerGroup

删除消费组。

是。

CreateConsumerGroupSubscribeRelation

在AMQP订阅中添加一个消费组。

是。

DeleteConsumerGroupSubscribeRelation

从AMQP订阅中的多个消费组移除指定消费组。

是。

云产品流转(旧版)的API

API

描述

MQTT型实例下是否支持

CreateRule

创建规则。

否。

CreateRuleAction

创建规则动作。

DeleteRule

删除规则。

DeleteRuleAction

删除规则动作。

GetRule

查询规则信息。

GetRuleAction

查询规则动作信息。

ListRule

查询规则列表。

ListRuleActions

查询规则动作列表。

UpdateRule

修改规则。

UpdateRuleAction

更新规则动作。

StartRule

启动规则。

StopRule

停止规则。

云产品流转(新版)的API

功能项

API

描述

MQTT型实例下是否支持

解析器

CreateParser

创建解析器。

是。

UpdateParser

更新解析器名称和描述。

是。

ListParser

查询解析器列表信息,包括解析器基本信息、启动状态、创建时间和修改时间。

是。

GetParser

查询指定解析器的详细信息,包括解析器基本信息、解析脚本、运行状态和关联的数据源等。

是。

DeleteParser

删除解析器。

是。

数据源

CreateParserDataSource

创建待流转的数据源。

是。

UpdateParserDataSource

更新数据源名称和描述信息。

是。

ListParserDataSource

查询所有数据源列表。

是。

GetParserDataSource

查询指定数据源的详细信息。

是。

DeleteParserDataSource

删除已创建的数据源。

是。

数据源Topic

CreateDataSourceItem

为已创建的数据源添加Topic。

是。

ListDataSourceItem

分页查询指定数据源下的Topic列表。

是。

DeleteDataSourceItem

删除指定数据源下的指定Topic。

是。

数据目的

CreateDestination

创建数据源流转的数据目的。

是。

UpdateDestination

更新数据目的名称、操作类型和描述信息。

是。

ListDestination

查询已创建的数据目的列表。

是。

GetDestination

查询指定数据目的详细信息。

是。

DeleteDestination

删除已创建的数据目的。

是。

配置解析器

AttachParserDataSource

为解析器关联指定数据源。

是。

ListParserDestination

查询指定解析器关联的数据目的列表。

是。

DetachParserDataSource

删除解析器中的指定数据源。

是。

AttachDestination

为解析器关联指定数据目的。

是。

DetachDestination

删除解析器中的指定数据目的。

是。

SaveScript

编辑并保存解析器的脚本草稿。

是。

PublishScript

发布指定解析器中的脚本。

是。

StartParser

启动解析器。

是。

StopParser

停止解析器运行。

是。

数据服务API

API

描述

MQTT型实例下是否支持

WriteDevicesHotStorageData

将设备自定义Topic数据写入热数据存储空间。

否。

QueryDevicesHotStorageDataStatus

查询设备热数据的快照数据。

QueryDevicesHotStorageData

查询设备热数据的时序数据。

ResetDeviceTimeline

删除指定设备下已存储的时序数据。

CreateDataAPIService

创建数据算法服务API。

GetDataAPIServiceDetail

获取数据算法服务API详情。

InvokeDataAPIService

调用数据算法服务API,获取SQL查询结果。

ListAnalyticsData

执行数据服务API对应的查询任务,从而获取数据源里的指定数据。

AddDataForApiSource

向物联网平台导入外部数据。您可将本地或其他平台的数据上传至物联网平台,用于数据的分析和处理。

BatchAddDataForApiSource

向物联网平台批量导入外部数据。

CreateDownloadDataJob

创建数据下载任务。

GetDownloadFile

获取数据表数据下载任务的执行结果。

安全隧道的API

API

描述

MQTT型实例下是否支持

CreateDeviceTunnel

创建安全隧道。

否。

CloseDeviceTunnel

关闭状态为已打开的安全隧道。

DeleteDeviceTunnel

删除状态为已关闭的安全隧道。

QueryDeviceTunnel

查询单个安全隧道的详细信息,包括安全隧道的所属设备、创建时间、ID、连接状态等。

OTA升级API

API

描述

MQTT型实例下是否支持

GenerateOTAUploadURL

生成升级包文件上传到OSS的URL及详细信息。

否。

GenerateDeviceNameListURL

生成设备列表文件上传到OSS的URL及详细信息。在创建静态升级批次时,设备列表文件可用于指定要升级的设备。

CreateOTAFirmware

添加升级包。

ModifyOTAFirmware

修改升级包信息,包括升级包名称、升级包描述和自定义信息。

DeleteOTAFirmware

删除指定升级包。

ListOTAFirmware

查询升级包列表。

QueryOTAFirmware

查询指定升级包的详细信息。

CreateOTAVerifyJob

创建升级包验证批次。

CreateOTAStaticUpgradeJob

创建静态升级批次。

CreateOTADynamicUpgradeJob

创建动态升级批次。

UpdateOTAJob

更新静态升级批次和动态升级批次的配置。

ListOTAJobByFirmware

获取升级包下的升级批次列表。

ListOTAJobByDevice

获取设备所在的升级包升级批次列表。

ListOTATaskByJob

查询指定升级批次下的设备升级作业列表。

QueryOTAJob

查询指定升级批次的详情。

CancelOTAStrategyByJob

取消动态升级批次所关联的动态升级策略。

CancelOTATaskByDevice

取消指定升级包下状态为待升级的设备升级作业。

CancelOTATaskByJob

取消指定批次下的设备升级作业。

CreateOTAModule

创建产品的OTA模块。

UpdateOTAModule

修改OTA模块别名、描述。

DeleteOTAModule

删除自定义OTA模块。

ListOTAModuleByProduct

查询产品下的OTA模块列表。

ConfirmOTATask

批量确认处于待确认状态的设备升级作业。

ListOTAUnfinishedTaskByDevice

查询指定设备下,未完成状态的设备升级作业列表。

ReupgradeOTATask

重新升级指定批次下升级失败或升级取消的设备升级作业。

ListOTAModuleVersionsByDevice

查询设备上报过的OTA模块版本列表。

设备任务的API

API

描述

MQTT型实例下是否支持

CreateJob

创建设备任务。

否。

GenerateFileUploadURL

生成文件上传到OSS的信息。

UpdateJob

更新任务下作业配置。

QueryJob

查询指定设备任务的详细信息。

ListJob

查询阿里云账号下的任务列表。

CancelJob

取消任务的执行。

DeleteJob

删除设备任务。

ListTask

查询指定任务或指定设备下的作业列表。

QueryTask

查询指定任务下的作业。

QueryJobStatistics

查询指定任务下各状态作业的统计信息。

RerunJob

重新执行指定设备任务下,所有已超时和失败的设备作业。

增值服务的API

音视频通信服务的API

API

描述

MQTT型实例下是否支持

BindLicenseProduct

为指定产品授权License。

BindLicenseDevice

为指定产品下批量设备授权License

CheckBindLicenseDeviceProgress

根据批量授权设备接口返回的唯一ID(CheckProgressId)查询授权的进度。

QueryLicenseDeviceList

查询授权License的设备列表。

UnbindLicenseProduct

取消指定产品的License授权。

IoT孪生引擎的API

API

描述

MQTT型实例下是否支持

ImportDTData

触发孪生体的数据映射配置,实现数据到孪生节点的映射。

位置服务的API

API

描述

MQTT型实例下是否支持

GisQueryDeviceLocation

查询设备位置信息。

否。

GisSearchDeviceTrace

查询设备轨迹详情。

千里传音的API

API

描述

MQTT型实例下是否支持

BindLicenseDevice

为指定产品下设备授权License。

否。

CheckBindLicenseDeviceProgress

根据批量授权设备接口返回的唯一ID(CheckProgressId)查询授权的进度。

QuerySpeechLicenseAvailableQuota

查询当前License的剩余可用配额。

CreateSpeech

创建语料。

UpdateSpeech

更新语料,包括语料的播报声音、播报速度和音量大小等。

GetSpeechVoice

获取语料播报声音。

TestSpeech

试听语料。

QuerySpeech

查询语料详情,包括语料的播报声音、语料类型和音量大小等。

QuerySpeechList

查询语料列表。

PushSpeech

推送语料到设备。

DeleteSpeech

删除语料。

QuerySolutionDeviceGroupPage

查询项目下的分组列表。

QuerySpeechPushJob

查询语料推送任务列表。

QuerySpeechPushJobDevice

查询指定语料推送任务下的设备。

QuerySpeechPushJobSpeech

查询语料推送任务下的语料详情,包括语料的播报声音、语料类型和语料文本等。

SpeechByCombination

组合播报设备中的语料。

SyncSpeechByCombination

同步组合播报设备中的语料。

SpeechBySynthesis

下发动态播报内容到设备进行播报。

QuerySpeechDevice

查询播报设备的可用空间。

QueryDeviceSpeech

查询设备的语料列表。

GetSpeechDeviceDetail

查询播报设备的详情,包括设备的状态、设备的可用空间等。

DeleteDeviceSpeech

删除设备中的语料。

ShareSpeechByCombination

推送共享音频到设备播报。

AddShareTaskDevice

添加设备到语料分享任务。

QueryShareTaskDeviceList

查询语料分享任务的设备列表。

DeleteShareTaskDevice

删除语料分享任务中设备。

QuerySpeechLicenseDeviceList

查询千里传音License设备列表。

GetSpeechLicenseDeviceStatistics

查询千里传音License设备统计信息。

QueryProjectShareDeviceList

查询项目的分享设备列表。

PageQuerySpeechBroadcastHour

分页查询千里传音下共享播报的小时数据信息。

CountSpeechBroadcastHour

分页查询千里传音下共享播报的小时数据量。

PageQuerySharedSpeechOpen

被共享方分页查询共享的语料。

GetShareTaskByDeviceOpen

根据设备信息查询分享任务。

GetShareSpeechModelAudio

获取共享语料的语音文件。

CreateSharePromotionActivity

创建千里传音分享任务的促销活动。

QuerySharePromotionActivityAuditResult

查询千里传音分享任务的促销活动审核结果。

CreateSharePromotionSpeechModel

为千里传音分享任务的促销活动创建共享语料。

AddDeviceToSharePromotion

将千里传音分享任务中已有共享设备添加到促销活动中。

QueryShareProductNameByProductKey

根据产品ProductKey查询分享任务下共享设备所属产品的名称。

寄雁传书服务的API

API

描述

MQTT型实例下是否支持

PrintByTemplate

根据寄雁传书控制台创建的小票打印模板完成小票打印。

否。

开通服务的API

OpenIotService:开通物联网平台服务。

其他API

物联网边缘计算的云端API调用说明,请参见边缘计算API