云服务 API 参考行业场景垂直行业解决方案空间环境管理环境数据查询查询设备环境指标的统计数据

查询设备环境指标的统计数据

更新时间：2023-06-21 07:13:02下载pdf

本文介绍查询设备环境指标的统计数据的 API。

接口描述

通过资产 ID，查询资产下设备各项环境指标近七日统计数据。

接口地址

GET: /v1.0/iot-03/assets/{asset_id}/devices/environment-statistics

请求参数

参数名	类型	参数位置	是否必填	说明
asset_id	String	uri	true	资产 ID
last_row_key	String	query	false	最后行号

返回参数

参数名	类型	说明
result	DeviceEnvironmentStatisticsRes

result 说明

参数名	类型	说明
asset_name	String	资产名称
devices	List	设备列表
last_row_key	String	每页最后一条数据行号
has_next	Boolean	是否有下一页

devices 说明

参数名	类型	说明
device_id	String	设备 ID
statistics_data	List	统计数据

statistics_data 说明

参数名	类型	说明
date	String	统计日期
values	List	统计点列表

values 说明

参数名	类型	说明
code	String	指标编码
types	List	统计类型列表

types 说明

参数名	类型	说明
type	String	统计类型, 如: avg, min, max
value	String	统计值
unit	String	统计值单位

请求示例

GET: GET /v1.0/iot-03/assets/19237****74234/devices/environment-statistics?last_row_key=ad2fsw2dw

返回示例

{
    "result": {
        "last_row_key": "vdevo162676686854434",
        "devices": [
            {
                "device_id": "6ce2041044d859508ccaxh",
                "statistics_data": [
                    {
                        "date": "20210721",
                        "values": [
                            {
                                "types": [
                                    {
                                        "type": "avg",
                                        "unit": "",
                                        "value": "25.54"
                                    }
                                ],
                                "code": "bright_value"
                            }
                        ]
                    },
                    {
                        "date": "20210720",
                        "values": [
                            {
                                "types": [
                                    {
                                        "type": "avg",
                                        "unit": "",
                                        "value": "29.55"
                                    }
                                ],
                                "code": "bright_value"
                            }
                        ]
                    },
                    {
                        "date": "20210719",
                        "values": [
                            {
                                "types": [
                                    {
                                        "type": "avg",
                                        "unit": "",
                                        "value": "55.06"
                                    }
                                ],
                                "code": "bright_value"
                            }
                        ]
                    }
                ]
            },
            {
                "device_id": "6c41f233a8812ba234zsza",
                "statistics_data": [
                    {
                        "date": "20210721",
                        "values": [
                            {
                                "types": [
                                    {
                                        "type": "avg",
                                        "unit": "",
                                        "value": "1.46"
                                    }
                                ],
                                "code": "bright_value"
                            }
                        ]
                    },
                    {
                        "date": "20210720",
                        "values": [
                            {
                                "types": [
                                    {
                                        "type": "avg",
                                        "unit": "",
                                        "value": "26.42"
                                    }
                                ],
                                "code": "bright_value"
                            }
                        ]
                    },
                    {
                        "date": "20210719",
                        "values": [
                            {
                                "types": [
                                    {
                                        "type": "avg",
                                        "unit": "",
                                        "value": "118.33"
                                    }
                                ],
                                "code": "bright_value"
                            }
                        ]
                    }
                ]
            }
        ],
        "asset_name": "办公室",
        "has_next": false
    },
    "t": 1626835082945,
    "success": true
}

错误码

参考错误码。

上一篇查询设备环境指标的告警数据

下一篇查询资产环境指标的实时数据