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

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

产品管理的API

API描述基础型实例下是否支持
CreateProduct创建产品。是。
UpdateProduct修改产品信息。是。
QueryProductList查询产品列表。是。
QueryProduct查询产品详细信息。是。
DeleteProduct删除指定产品。是。
CreateProductTags创建产品标签。是。
UpdateProductTags更新产品标签。是。
DeleteProductTags删除产品标签。是。
ListProductTags查询产品的所有标签。是。
ListProductByTags根据标签查询产品。是。
UpdateProductFilterConfig更新产品下设备上报的属性去重规则。否。
QueryProductCertInfo获取产品的X.509证书信息。否。
SetProductCertInfo设置产品的X.509证书信息。否。
ReleaseProduct发布指定产品。是。
CancelReleaseProduct取消指定产品的发布。是。

设备管理的API

API描述基础型实例下是否支持
RegisterDevice注册设备。否。
QueryClientIds一型一密免注册场景下,查看单个设备的标识列表。否。
TransformClientId一型一密免注册场景下,若设备包含多个设备标识,需指定一个正确的设备标识,以防止非法的设备登录。否。
DeleteClientIds一型一密免注册场景下,若单个设备的标识个数超出限制(5个),可删除设备下的所有标识。否。
QueryDeviceInfo查询指定设备的基本信息(设备ID、设备证书和备注名称)。是。
QueryDeviceDetail查询设备详情。是。
BatchQueryDeviceDetail批量查询设备详情。是。
QueryDevice查询产品的设备列表。是。
DeleteDevice删除设备。是。
GetDeviceStatus获取设备的运行状态。是。
BatchGetDeviceState批量获取设备状态。是。
DisableThing禁用设备。是。
EnableThing解禁设备。是。
ResetThing重置设备。是。
BatchCheckDeviceNames批量自定义设备名称,物联网平台会检查名称的合法性。否。
BatchRegisterDeviceWithApplyId根据ApplyId批量申请设备。否。
BatchRegisterDevice批次申请特定数量设备。否。
QueryBatchRegisterDeviceStatus查询批量注册设备状态。是。
QueryPageByApplyId查询批次设备列表。是。
SaveDeviceProp设置设备标签。是。
QueryDeviceProp查询设备标签列表。是。
DeleteDeviceProp删除设备标签。是。
GetThingTopo查询网关设备的子设备列表。否。
NotifyAddThingTopo通知网关增加设备拓扑关系。否。
BatchAddThingTopo批量添加设备拓扑关系。否。
RemoveThingTopo移除网关设备或子设备所具有的拓扑关系。否。
QueryDeviceStatistics获取设备的统计数量。是。
GetGatewayBySubDevice根据挂载的子设备信息查询对应的网关设备信息。否。
QueryDeviceByTags根据标签查询设备。是。
QueryDeviceFileList查询指定设备上传到物联网平台的所有文件。否。
QueryDeviceFile查询指定设备上传到物联网平台的指定文件信息。否。
DeleteDeviceFile删除指定设备上传到物联网平台的指定文件。否。
BatchUpdateDeviceNickname批量更新设备备注名称。是。
QueryLoRaJoinPermissions查询账号下的LoRaWAN入网凭证列表。否。
CreateLoRaNodesTask创建批量注册LoRaWAN设备的任务。否。
GetLoraNodesTask查询批量注册LoRaWAN设备任务的状态。否。
QueryDeviceCert查询单个设备的X.509证书。否。
QueryCertUrlByApplyId查询批量注册设备的X.509证书下载链接。否。
QueryDeviceByStatus根据设备状态查询设备列表。否。
QueryDeviceBySQL通过SQL语句快速搜索满足指定条件的设备。否。
ListOTAModuleVersionsByDevice查询设备上报过的OTA模块版本列表。否。
ImportDevice在MQTT云网关产品下单个导入设备。否。
BatchImportDevice在基础型实例或MQTT云网关产品下批量导入设备。是。
BatchCheckImportDevice批量校验在基础型实例或MQTT云网关产品下批量导入的设备。是。
QueryImportedDeviceByApplyId根据申请批次ID(ApplyId)查询批量导入的设备列表。是。
BatchImportVehicleDevice在JT/T 808协议云网关产品下批量导入设备。否。
BatchCheckVehicleDevice批量校验导入的JT/T 808协议云网关设备。否。
QueryVehicleDevice查询JT/T 808协议云网关设备信息。否。

设备分发的API

API描述基础型实例下是否支持
CreateDeviceDistributeJob创建设备分发任务,默认同时分发设备所属产品。否。
CreateProductDistributeJob创建产品分发任务,分发指定产品到指定的目标实例。
QueryDeviceDistributeDetail获取设备分发任务执行完成后的结果信息。
QueryDeviceDistributeJob获取设备分发任务的详细信息。
ListDeviceDistributeJob获取设备分发任务列表。
DeleteDeviceDistributeJob删除设备分发任务。
ListDistributedDevice查询已分发的设备列表。
ListDistributedProduct查询已分发的产品列表。

安全隧道的API

API描述基础型实例下是否支持
CreateDeviceTunnel创建安全隧道。否。
CloseDeviceTunnel关闭状态为已打开的安全隧道。
DeleteDeviceTunnel删除状态为已关闭的安全隧道。
QueryDeviceTunnel查询单个安全隧道的详细信息,包括安全隧道的所属设备、创建时间、ID、连接状态等。

分组管理的API

API描述基础型实例下是否支持
CreateDeviceGroup创建静态分组。是。
CreateDeviceDynamicGroup创建动态分组。否。
DeleteDeviceGroup删除静态分组。是。
DeleteDeviceDynamicGroup删除动态分组。否。
UpdateDeviceGroup修改分组信息。是。
QueryDeviceGroupInfo查询分组详情。是。
QueryDeviceGroupList分页查询分组列表。是。
QueryDynamicGroupDevices查询动态分组下的设备列表。否。
BatchAddDeviceGroupRelations添加设备到静态分组。是。
BatchDeleteDeviceGroupRelations删除分组中已添加的指定设备。是。
SetDeviceGroupTags添加或更新分组标签。是。
QueryDeviceGroupTagList查询分组标签列表。是。
QueryDeviceGroupByDevice查询指定设备所在的分组列表。是。
QuerySuperDeviceGroup根据子分组ID查询父分组信息。是。
QueryDeviceListByDeviceGroup查询分组中的设备列表。是。
QueryDeviceGroupByTags根据标签查询设备分组。是。

物模型管理的API

API描述基础型实例下是否支持
CreateThingModel为指定产品的物模型新增功能,支持定义物模型扩展描述。否。
UpdateThingModel更新指定产品物模型中的单个功能,支持更新物模型扩展描述。
QueryThingModel查看指定产品的物模型中的功能定义详情。
CopyThingModel复制指定产品的物模型到目标产品。
PublishThingModel发布指定产品的物模型。
DeleteThingModel删除指定产品物模型中的指定功能。
ListThingTemplates获取物联网平台预定义的产品品类列表。
GetThingTemplate查询指定品类的标准物模型信息。
ListThingModelVersion获取指定产品的物模型历史版本列表。
GetThingModelTsl查询指定产品的物模型。
ImportThingModelTsl为指定产品导入物模型TSL,暂不支持扩展描述配置。
QueryThingModelPublished查看指定产品的已发布物模型中的功能定义详情。
GetThingModelTslPublished查询指定产品的已发布物模型TSL。
QueryThingModelExtendConfig导出指定产品的物模型扩展描述配置。
QueryThingModelExtendConfigPublished导出已发布物模型的扩展描述配置。
CreateThingScript为指定产品提交数据解析脚本。
UpdateThingScript修改指定产品的数据解析脚本。
GetThingScript查询指定产品的数据解析脚本。

物模型使用的API

API描述基础型实例下是否支持
SetDeviceProperty设置设备的属性。否。
SetDevicesProperty批量设置设备属性。
InvokeThingService调用设备的服务。
InvokeThingsService批量调用设备的服务。
QueryDevicePropertyData查询设备的属性历史数据。
QueryDevicePropertiesData批量查询指定设备的多个属性的历史数据。
QueryDeviceEventData查询设备的事件历史数据。
QueryDeviceServiceData获取设备的服务记录历史数据。
SetDeviceDesiredProperty为指定设备批量设置期望属性值。
QueryDeviceDesiredProperty查询指定设备的期望属性值。
QueryDevicePropertyStatus查询指定设备的属性快照。
QueryDeviceOriginalPropertyStatus查询指定设备的原始属性快照。
QueryDeviceOriginalPropertyData查询指定设备的原始属性记录。
QueryDeviceOriginalEventData查询指定设备的原始事件记录。
QueryDeviceOriginalServiceData查询指定设备的原始服务调用记录。
ClearDeviceDesiredProperty清空设备下已设置的期望属性值。

设备任务的API

API描述基础型实例下是否支持
CreateJob创建设备任务。否。
GenerateFileUploadURL生成文件上传到OSS的信息。
UpdateJob更新任务下作业配置。
QueryJob查询指定设备任务的详细信息。
ListJob查询阿里云账号下的任务列表。
CancelJob取消任务的执行。
DeleteJob删除设备任务。
ListTask查询指定任务或指定设备下的作业列表。
QueryTask查询指定任务下的作业。
QueryJobStatistics查询指定任务下各状态作业的统计信息。
RerunJob重新执行指定设备任务下,所有已超时和失败的设备作业。

云产品流转(旧版)的API

API描述基础型实例下是否支持
ListRule查询规则列表。否。
CreateRule创建规则。
GetRule查询规则信息。
UpdateRule修改规则。
DeleteRule删除规则。
ListDataSourceItem分页查询规则引擎中指定数据源下的Topic列表。
ListRuleActions查询规则动作列表。
GetRuleAction查询规则动作信息。
CreateRuleAction创建规则动作。
UpdateRuleAction更新规则动作。
DeleteRuleAction删除规则动作。
StartRule启动规则。
StopRule停止规则。

云产品流转(新版)的API

API描述基础型实例下是否支持
CreateParser创建解析器。是。
UpdateParser更新解析器名称和描述。是。
ListParser查询解析器列表信息,包括解析器基本信息、启动状态、创建时间和修改时间。是。
GetParser询指定解析器的详细信息,包括解析器基本信息、解析脚本、运行状态和关联的数据源等。是。
DeleteParser删除解析器。是。
CreateParserDataSource创建待流转的数据源。是。
UpdateParserDataSource更新数据源名称和描述信息。是。
ListParserDataSource查询所有数据源列表。是。
GetParserDataSource查询指定数据源的详细信息。是。
DeleteParserDataSource删除已创建的数据源。是。
CreateDataSourceItem为已创建的数据源添加Topic。是。
ListDataSourceItem分页查询指定数据源下的Topic列表。是。
DeleteDataSourceItem删除指定数据源下的指定Topic。是。
CreateDestination创建数据源流转的数据目的。是。
UpdateDestination更新数据目的名称、操作类型和描述信息。是。
ListDestination查询已创建的数据目的列表。是。
GetDestination查询指定数据目的详细信息。是。
DeleteDestination删除已创建的数据目的。是。
AttachParserDataSource为解析器关联指定数据源。是。
ListParserDestination查询指定解析器关联的数据目的列表。是。
DetachParserDataSource删除解析器中的指定数据源。是。
AttachDestination为解析器关联指定数据目的。是。
DetachDestination删除解析器中的指定数据目的。是。
SaveScript编辑并保存解析器的脚本草稿。是。
PublishScript发布指定解析器中的脚本。是。
StartParser启动解析器。是。
StopParser停止解析器运行。是。

Topic管理API

API描述基础型实例下是否支持
CreateProductTopic创建产品自定义Topic类。否。
UpdateProductTopic修改产品自定义Topic类。
QueryProductTopic查询产品自定义Topic类。
DeleteProductTopic删除产品自定义Topic类。
CreateTopicRouteTable添加Topic路由表。
QueryTopicRouteTable查询Topic路由表。
QueryTopicReverseRouteTable查询Topic反向路由表。
DeleteTopicRouteTable删除Topic路由表。

服务端订阅API

API描述基础型实例下是否支持
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描述基础型实例下是否支持
RRpc向指定设备发送请求消息,并同步返回响应。否。
PubBroadcast向指定产品所有设备,或向订阅了指定Topic的所有设备发布广播消息。否。
Pub通过自定义Topic向指定设备发布消息,支持向指定产品下订阅了指定自定义Topic的在线设备发送广播消息。是。
BatchPub通过自定义Topic向指定产品下的多个设备批量发送消息。是。
QueryMessageInfo查询设备上下行消息的详情,包括消息的内容、消息的产生时间、发送消息的Topic等。是。
SubscribeTopic为指定设备订阅Topic。否。
QueryDeviceSubTopic查询设备已订阅的Topic列表。否。
UpdateTopicConfig设置自定义Topic是否支持保留消息广播。

数据服务API

API描述基础型实例下是否支持
WriteDevicesHotStorageData将设备自定义Topic数据写入热数据存储空间。否。
QueryDevicesHotStorageDataStatus查询设备热数据的快照数据。
QueryDevicesHotStorageData查询设备热数据的时序数据。
CreateDataAPIService创建数据算法服务API。
GetDataAPIServiceDetail获取数据算法服务API详情。
InvokeDataAPIService调用数据算法服务API,获取SQL查询结果。
ListAnalyticsData执行数据服务API对应的查询任务,从而获取数据源里的指定数据。
AddDataForApiSource向物联网平台导入外部数据。您可将本地或其他平台的数据上传至物联网平台,用于数据的分析和处理。
BatchAddDataForApiSource向物联网平台批量导入外部数据。
CreateDownloadDataJob创建数据下载任务。
GetDownloadFile获取数据表数据下载任务的执行结果。

设备影子API

API描述基础型实例下是否支持
GetDeviceShadow查询设备影子。否。
UpdateDeviceShadow更新设备影子。

OTA升级API

API描述基础型实例下是否支持
GenerateOTAUploadURL生成升级包文件上传到OSS的URL及详细信息。否。
GenerateDeviceNameListURL生成设备列表文件上传到OSS的URL及详细信息。在创建静态升级批次时,设备列表文件可用于指定要升级的设备。
CreateOTAFirmware添加升级包。
DeleteOTAFirmware删除指定升级包。
ListOTAFirmware查询升级包列表。
QueryOTAFirmware查询指定升级包的详细信息。
CreateOTAVerifyJob创建升级包验证批次。
CreateOTAStaticUpgradeJob创建静态升级批次。
CreateOTADynamicUpgradeJob创建动态升级批次。
ListOTAJobByFirmware获取升级包下的升级批次列表。
ListOTAJobByDevice获取设备所在的升级包升级批次列表。
ListOTATaskByJob查询指定升级批次下的设备升级作业列表。
QueryOTAJob查询指定升级批次的详情。
CancelOTAStrategyByJob取消动态升级批次所关联的动态升级策略。
CancelOTATaskByDevice取消指定升级包下状态为待升级的设备升级作业。
CancelOTATaskByJob取消指定批次下的设备升级作业。
CreateOTAModule创建产品的OTA模块。
UpdateOTAModule修改OTA模块别名、描述。
DeleteOTAModule删除自定义OTA模块。
ListOTAModuleByProduct查询产品下的OTA模块列表。
ConfirmOTATask批量确认处于待确认状态的设备升级作业。
ListOTAUnfinishedTaskByDevice查询指定设备下,未完成状态的设备升级作业列表。

音视频通信服务的API

API描述基础型实例下是否支持
BindLicenseProduct为指定产品授权License。
BindLicenseDevice为指定产品下批量设备授权License
CheckBindLicenseDeviceProgress根据批量授权设备接口返回的唯一ID(CheckProgressId)查询授权的进度。
QueryLicenseDeviceList查询授权License的设备列表。
UnbindLicenseProduct取消指定产品的License授权。

IoT孪生引擎的API

API描述基础型实例下是否支持
ImportDTData触发孪生体的数据映射配置,实现数据到孪生节点的映射。

千里传音API

API描述基础型实例下是否支持
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根据设备信息查询分享任务。

寄雁传书服务API

API描述基础型实例下是否支持
PrintByTemplate根据寄雁传书控制台创建的小票打印模板完成小票打印。否。

声码服务API

API描述基础型实例下是否支持
CreateSoundCode创建声码。否。
DeleteSoundCode删除声码。
QuerySoundCodeList查询声码列表。
GetSoundCodeAudio获取声码音频下载地址。
CreateSoundCodeSchedule创建声码排程。
UpdateSoundCodeSchedule更新声码排程。
DeleteSoundCodeSchedule删除声码排程。
QuerySoundCodeScheduleList查询声码排程列表。
GetSoundCodeSchedule查询声码排程详情。
UpdateSchedulePeriod更新声码排程时间段。
CreateSchedulePeriod创建声码排程时间段。
DeleteSchedulePeriod删除声码排程时间段。
QuerySchedulePeriodList查询声码排程时间段列表。
CreateSoundCodeLabel为指定排程创建声码标签。
UpdateSoundCodeLabel更新声码标签。
DeleteSoundCodeLabel删除声码标签。
QuerySoundCodeLabelList查询指定排程的声码标签列表。
BatchCreateSoundCodeLabel为指定排程批量创建声码标签。
BatchCreateSoundCodeLabelWithLabels为指定排程批量创建指定声码标签。
QuerySoundCodeLabelBatchList查询指定排程的声码标签批次列表。
QuerySoundCodeLabelBatchFailedResult查询指定声码标签批次下创建失败的声码标签列表。
PackageSoundCodeLabelBatchAudio获取声码标签批次音频打包地址。
RetrySoundCodeLabelBatch重启声码标签批次。

位置服务API

API描述基础型实例下是否支持
GisQueryDeviceLocation查询设备位置信息。否。
GisSearchDeviceTrace查询设备轨迹详情。

图文识别服务API

API描述基础型实例下是否支持
RecognizeCarNum通过图文识别技术识别出图片中的车牌号码。否。
RecognizePictureGeneral通过图文识别技术识别出图片中的文字信息。

开通服务的API

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

其他API

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