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

接口说明

使用说明

仅华东 2（上海）、华北 2（北京）和华南 1（深圳）地域的标准型和尊享型企业版实例下，支持调用该接口写入热数据。

热数据存储详细说明，请参见配置热数据存储。

使用限制

调用该接口的每秒请求写入数据数，由您购买实例下的热数据存储 IOPS规格决定。详细内容，请参见购买企业版实例和查看热数据存储 IOPS。

流控信息

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

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称	字段详情
IotInstanceIdstring	实例 ID。您可在物联网平台控制台的实例概览页面，查看当前实例的 ID。示例值:iot-2w****
ProductKeystring	设备所属的产品 ProductKey。展开详情示例值:a1BwAGV****参考取值来源: CreateProduct QueryProductList ReleaseProduct ListProductByTags BindLicenseProduct BatchBindProductsIntoProject
DeviceNamestring	设备的名称。展开详情示例值:device1
IotIdstring	设备 ID。展开详情示例值:y4u2weAI********HMle1234
UserTopicstring	自定义 Topic。从`user`类目开始，输入自定义 Topic 的后续所有类目。展开详情示例值:user/a*/b*
Itemsstring	写入的数据，固定为如下 JSON 数据结构。展开详情示例值:{ "Power": { "value": "on", "time": 1524448722000 }, "WF": { "value": 23.6, "time": 1524448722000 } }

请求说明

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

返回参数

字段名称	字段详情
Codestring	调用失败时，返回错误码。详细信息，请参见下文错误码。示例值:iot.system.SystemException
RequestIdstring	阿里云为该请求生成的唯一标识符。示例值:E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565
ErrorMessagestring	调用失败时，返回的出错信息。示例值:系统异常
Successboolean	是否调用成功。展开详情示例值:true

返回示例

错误码

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

全局错误码

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

400	iot.device.InvalidFormattedDeviceName	The DeviceName format is invalid.	诊断
400	iot.device.NullDeviceName	The DeviceName parameter cannot be empty.	诊断
400	iot.device.SetDevicePropertyFailed	An error occurred while setting the device properties.	诊断
400	iot.prod.InvalidFormattedProductkey	The ProductKey format is invalid.	诊断
400	iot.prod.NotExistedProduct	The specified product does not exist.	诊断
400	iot.prod.NullProductKey	The ProductKey parameter cannot be empty.	诊断
400	iot.check.InvalidFormattedParameter	The parameter format is invalid.	诊断
400	iot.messagebroker.HALFCONN	The specified operation has failed. The device is in an inactive status.	诊断
400	iot.messagebroker.OFFLINE	The specified operation has failed. The device is offline.	诊断
400	iot.prod.QueryProductAbilitiesFailed	An error occurred while querying the product features.	诊断
400	iot.system.IllegalRequest	The request parameter is invalid.	诊断
400	iot.dataalgo.ScriptMethodNotFound	Method is not found in script.	诊断
400	iot.dataalgo.ScriptExecutionTimeout	Script execution timeout.	诊断
400	iot.dataalgo.ScriptExecutionOomException	Script execution is out of memory.	诊断
400	Iot.Device.NotExistedDevice	The device does not exist.	诊断
400	iot.device.InvalidIoTId	The specified device ID is invalid.	诊断
400	iot.dataalgo.ScriptExecutionException	Script execution exception.	诊断
400	iot.prod.QueryPropertyNotFound	Query property not found.	诊断
400	iot.dataalgo.ScriptDataFormatException	Script function result format is incorrect.	诊断
400	iot.dataalgo.ScriptRelationNotExist	Script relation not exist.	诊断
400	iot.tsl.TslParseError	TSLlParseError: %s.	诊断
400	iot.tsl.InvalidFormattedTslError	The TSL format is invalid.	诊断
400	iot.tsl.InvalidHistoryTimestampError	The history timestamp is invalid.	诊断
400	iot.storage.HotStorageCapacityNotEnough	The timeline storage capacity not enough.	诊断
400	iot.storage.HotStorageIopsWriteNotEnough	The timeline storage write IOPS is not enough.	诊断

变更历史

暂无变更历史