找不到 API ? 点击 反馈吧
- 实例迁移
- 产品管理
- 设备管理
- 设备分发
- 安全隧道管理
- 分组管理
- 物模型管理
- 物模型使用
- 为指定设备设置属性值SetDeviceProperty
- 批量设置设备属性值SetDevicesProperty
- 在一个设备上调用指定服务InvokeThingService
- 批量调用设备服务InvokeThingsService
- 查询指定设备的属性记录QueryDevicePropertyData
- 批量查询指定设备的属性上报数据QueryDevicePropertiesData
- 查询指定设备的事件记录QueryDeviceEventData
- 查询指定设备的服务调用记录QueryDeviceServiceData
- 为指定设备批量设置期望属性值SetDeviceDesiredProperty
- 查询指定设备的期望属性值QueryDeviceDesiredProperty
- 查询指定设备的属性快照QueryDevicePropertyStatus
- 查询设备上报的原始属性QueryDeviceOriginalPropertyStatus
- 查询指定设备的原始属性记录QueryDeviceOriginalPropertyData
- 查询设备上报的原始事件QueryDeviceOriginalEventData
- 查询设备本身调用的原始服务QueryDeviceOriginalServiceData
- ClearDeviceDesiredProperty
- 任务管理
- Topic管理
- 云产品流转(旧版)
- 云产品流转(新版)
- 数据服务
- 消息通信
- 服务端订阅
- 设备影子
- OTA升级
- 开通服务
- 增值服务
- 场景联动
- 边缘实例管理
- 边缘计算新增API
- 边缘计算-场景联动
- 边缘计算-远程运维
- 边缘计算-消息路由
- 物联网应用开发API管理
- 其他
- 其它
InvokeThingService
调用该接口在单个设备上调用指定服务
服务地址:
华东2(上海)
参数配置
高级配置
输入参数
只看必填
注意事项
IotInstanceId实例ID
ProductKey要调用服务的设备所属的产品Produc...
DeviceName要调用服务所属设备的DeviceName
Identifier服务的标识符
Args要启用服务的入参信息
IotId要调用服务的设备ID
Qos
文档
调用结果
SDK 示例
CLI示例
相关示例 (1)
调用历史
错误码
流控
插件下载了解更多
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
接口说明
使用说明
定义产品物模型服务时,已设置服务调用方式。因此,调用本接口时,物联网平台会根据请求参数 Identifier 值,选择服务对应的调用方式。
- 同步方式:物联网平台直接使用 RRPC 同步方式下行推送请求,设备返回 RRPC 响应消息。RRPC 使用详情,请参见什么是 RRPC。
- 异步方式:物联网平台采用异步方式下行推送请求,设备采用异步方式返回结果。订阅的 Topic 详情,请参见设备服务调用。
注意 若创建产品时,设置物模型校验类型为免校验,调用本接口会默认为异步调用方式。
调用服务到设备端后,设备会返回调用结果给接口的调用方。设备端响应逻辑及响应结果,需您在设备端完成开发。设备返回结果的数据格式必须符合标准的 Alink 协议,Alink JSON 格式如下:
{
"id": "58***89",
"code": 200,
"data": {},
"message": "success",
"localizedMsg": "localizedMsg"
}
说明
id 为物联网平台生成的唯一 ID,设备从服务调用请求中获取,并原文返回。
- code 为整型数字,会返回给接口调用方,用于判断服务调用结果。
- data 为调用设备服务的结果数据,会返回给接口调用方。数据必须为 JSON 格式,由用户自行定义返回内容。
- message、localizedMsg 根据业务需要进行返回。 例如物联网平台的设备接入 C Link SDK 提供了物模型使用示例,详细内容,请参见调用服务。
使用限制
同步调用服务,最大超时时间为 8 秒。若 8 秒内服务器未收到回复,则返回超时错误。异步调用服务无最大超时时间限制。
QPS 限制
单个阿里云账号调用该接口的每秒请求数(QPS)最大限制为 500。
说明
RAM 用户共享阿里云账号配额。
请求参数
字段名称 | 字段详情 |
---|---|
IotInstanceIdstring | 实例 ID。您可在物联网平台控制台的实例概览页面,查看当前实例的 ID。展开详情 示例值:iot_instc_pu****_c*-v64******** |
ProductKeystring | 要调用服务的设备所属的产品 ProductKey。展开详情 示例值:a1BwAGV****参考取值来源: CreateProduct QueryProductList ReleaseProduct ListProductByTags BindLicenseProduct BatchBindProductsIntoProject |
DeviceNamestring | 要调用服务所属设备的 DeviceName。展开详情 示例值:light |
Identifierstring | 服务的标识符。展开详情 示例值:Set |
Argsstring | 要启用服务的入参信息,数据格式为 JSON String,例如Args={"param1":1}。展开详情 示例值:{"param1":1} |
IotIdstring | 要调用服务的设备 ID。物联网平台为该设备颁发的 ID,设备的唯一标识符。展开详情 示例值:Q7uOhVRdZRRlDnTLv****00100 |
Qosinteger<int32> | 取值 <= 1 |
请求说明
调用 API 时,除了本文介绍的该 API 的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数文档。
返回参数
变更历史
暂无变更历史