AsyncRRpc_物联网平台_API文档-阿里云OpenAPI开发者门户

接口说明

对于 MQTT 协议（包括云网关和非云网关）和云网关 GB/T 32960 协议的设备，可调用本接口从服务端下发消息给对应设备。

单个阿里云账号调用该接口的每秒请求数（QPS）最大限制为 1,000。

说明 RAM 用户共享阿里云账号配额。

当前云产品API请求速率暂未透出。

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作
暂无数据

字段名称	字段详情
IotInstanceIdstring	实例 ID。您可在物联网平台控制台的实例概览页面，查看当前实例的 ID。展开详情示例值:iot-v64********
ProductKeystring	要接收消息的设备所属产品的 ProductKey。示例值:aldfeSe****参考取值来源: CreateProduct QueryProductList ReleaseProduct ListProductByTags BindLicenseProduct BatchBindProductsIntoProject
DeviceNamestring	要接收消息的设备名称。示例值:device1
ExtInfostring	发送消息给云网关 GB/T 32960 协议的设备时，需要传入此参数，标识消息的命令类型，可取值：展开详情示例值:{"commandType": 128}
MessageContentstring	要发送的消息主体。展开详情示例值:eyJ0ZXN0IjoidGFzayBwdWIgYnJvYWRjYXN0In0=
TopicFullNamestring	发送消息给 MQTT 协议设备时，需要传入对应设备的自定义 Topic。Topic 的操作权限必须为订阅或发布和订阅。展开详情示例值:/a1uZfYb**/A_Vol**/user/update

调用 API 时，除了本文介绍的该 API 的特有请求参数，还需传入公共请求参数。公共请求参数说明，请参见公共参数文档。

字段名称	字段详情
Codestring	调用失败时，返回错误码。详细信息，请参见下文错误码。示例值:iot.device.InvalidFormattedDeviceName
MessageIdinteger<int64>	成功发送请求消息后，云端生成的消息 ID，用于标识该消息。注意请注意，该值为 Long 类型，在某些语言中可能存在精度丢失的风险，请小心使用。示例值:889455942124347392
ErrorMessagestring	调用失败时，返回的出错信息。示例值:设备名称格式错误。
RequestIdstring	阿里云为该请求生成的唯一标识符。示例值:E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565
Successboolean	是否调用成功。展开详情示例值:true

没有我想要的错误码, 点击反馈

HTTP 状态码	错误码	错误信息	操作

400	iot.prod.NullProductKey	The ProductKey is empty.	诊断
400	iot.prod.InvalidFormattedProductkey	The ProductKey format is incorrect.	诊断
400	iot.device.NullDeviceName	The deviceName is empty.	诊断
400	iot.device.InvalidFormattedDeviceName	The deviceName format is incorrect.	诊断
400	iot.device.InactiveDevice	The device is inactive.	诊断
400	iot.device.OfflineDevice	The device is offline.	诊断
400	iot.Device.NotExistedDevice	This device does not exist.	诊断

暂无变更历史