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

接口说明

使用说明

若查询数字孪生节点的属性数据，必须传入参数 IotId，且取值为孪生节点 ID。
目前本接口已不支持分页查询。调用本接口时，如果在指定时间段内，没有返回 PageSize 条记录，返回的 NextTime 和 NextValid 也是无效的。您可多次调用接口 QueryDevicePropertyData ，一次输入一个 Identifier 进行查询。

使用限制

一次调用下，最多查询 10 个属性的历史数据，最多返回 100 条数据。
标准型和尊享型企业版实例：仅可查询存储时效内的数据。数据存储时效，请参见存储配置。
其他实例：仅可查询最近 30 天内的属性数据。

QPS 限制

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

说明单个阿里云账号下的所有 RAM 用户共享该阿里云账号的配额。

流控信息

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

授权信息

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

具体说明如下：展开详情

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

iot:QueryDevicePropertiesData	Get	全部资源 *	无	无

请求参数

字段名称	字段详情
IotInstanceIdstring	实例 ID。您可在物联网平台控制台的实例概览页面，查看当前实例的 ID。展开详情示例值:iot_instc_pu***_c-v64********
PageSizeinteger<int32>	单个属性可返回的数据记录数量。最大值为 100。展开详情示例值:10
ProductKeystring	要查询设备所属的产品 ProductKey。展开详情示例值:a1BwAGV****参考取值来源: CreateProduct QueryProductList ReleaseProduct ListProductByTags BindLicenseProduct BatchBindProductsIntoProject
DeviceNamestring	要查询的设备名称。展开详情示例值:airconditioning
StartTimeinteger<int64>	属性记录的开始时间。取值为 13 位毫秒值时间戳，例如：1579249499000。注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:1579249499000
Ascinteger<int32>	返回结果中，属性记录按时间排序的方式。取值：展开详情示例值:0
IotIdstring	要查询属性所属的设备 ID或数字孪生节点 ID：展开详情示例值:Q7uOhVRdZRRlDnTLv****00100
EndTimeinteger<int64>	属性记录的结束时间。取值为 13 位毫秒值时间戳，例如：1579249499000。注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:1579249499000
Identifierarray<string>	属性的标识符列表。展开详情示例值:temperature子级条数 <= 10

请求说明

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

返回参数

字段名称	字段详情
NextValidboolean	目前本接口不支持分页查询，请忽略此参数返回值。示例值:true
NextTimeinteger<int64>	目前本接口不支持分页查询，请忽略此参数返回值。注意请注意，该值为 Long 类型，在某些语言中可能存在精度丢失的风险，请小心使用。示例值:1579249499000
RequestIdstring	阿里云为该请求生成的唯一标识符。示例值:E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565
ErrorMessagestring	调用失败时，返回的出错信息。示例值:系统异常
Successboolean	表示是否调用成功。展开详情示例值:true
Codestring	调用失败时，返回的错误码。更多信息，请参见错误码。示例值:iot.system.SystemException
PropertyDataInfosobject

返回示例

变更历史

暂无变更历史