更新时间:2025-08-19 GMT+08:00
分享

查询冷站列表

功能介绍

查询冷站列表

URI

GET /v1/iotfm/energy-eff/cold-sites

表1 Query参数

参数

是否必选

参数类型

描述

limit

Integer

参数说明:分页查询时每页显示的记录数。

取值范围:默认值为10,取值范围为1-50的整数。

marker

String

参数说明:上一次分页查询结果中最后一条记录的ID,在上一次分页查询时由物联网平台返回获得。分页查询时物联网平台是按marker也就是记录ID降序查询的,越新的数据记录ID也会越大。若填写marker,则本次只查询记录ID小于marker的数据记录。若不填写,则从记录ID最大也就是最新的一条数据开始查询。如果需要依次查询所有数据,则每次查询时必须填写上一次查询响应中的marker值。

取值范围:长度固定24,只允许大小写字母、数组的组合。

offset

Integer

参数说明:表示从marker后偏移offset条记录开始查询。当offset为0时,表示从marker后第一条记录开始输出。限制offset最大值是出于API性能考虑,您可以搭配marker使用该参数实现翻页,例如每页50条记录,1-11页内都可以直接使用offset跳转到指定页,但到11页后,由于offset限制为500,您需要使用第11页返回的marker作为下次查询的marker,以实现翻页到12-22页。

取值范围:默认为0,取值范围为0-500的整数。

site_id

String

冷站ID

site_name

String

冷站名称

calendar_id

String

日历ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数说明:用户Token。通过调用 生成Token 接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。

X-Instance-Id

String

参数说明:实例ID。通过访问智能设施云平台界面后获取,智能设施云平台资源均为实例级隔离,所有业务接口必须填写正确的实例ID才能被成功调用。

取值范围:长度8-36,只允许大小写字母、数字和-字符的组合。

X-Root-Zone-Id

String

参数说明:项目ID。

取值范围:长度不超过24,只允许字母、数字的组合。

响应参数

状态码:200

表3 响应Header参数

参数

参数类型

描述

X-Request-Id

String

This field is the request ID number for task tracking.

Format is request_uuid-timestamp-hostname.

表4 响应Body参数

参数

参数类型

描述

cold_sites

Array of QueryColdSiteBaseRsp objects

冷站列表

page

Page object

查询批量分页结构体,定义了分页页码、每页记录数、记录总数、该页记录的最大ID。

表5 QueryColdSiteBaseRsp

参数

参数类型

描述

site_name

String

冷站名称。长度不超过64,只允许中文、字母、数字、以及_-等字符的组合。

site_description

String

冷站描述。长度不超过256,只允许中文、字母、数字、以及_-等字符的组合。

site_id

String

冷站ID。长度不超过36,只允许字母、数字、以及_-等字符的组合。

zone_id

String

区域ID

calendar_id

String

日历ID

config

ColdSiteConfig object

冷站配置。

init_algorithm_status

String

默认算法初始化状态

表6 ColdSiteConfig

参数

参数类型

描述

cold_system_type

String

冷站类型。办公园区-含机房(24小时)-WORK_PARK_24; 产业园区-INDUSTRY_PARK; 办公园区-不含机房-WORK_PARK

min_running_cop

Number

最小运行COP。

cooling_water_min_supply_temp

Number

冷却水最低供水温度。

cooling_water_max_supply_temp

Number

冷却水最高供水温度。

chiller_power_critical_value

Number

大小冷机功率临界值。

season_model_config

SeasonModelConfig object

季节模式配置。

morning_peak_time_config

MorningPeakTimeConfig object

早高峰时间配置

eff_calc_config

ColdSiteEffCalcConfig object

冷站节能计算参数。

chilled_water_pressure_threshold

ThresholdConfig object

冷冻水总管压力阈值

chilled_water_temp_threshold

ThresholdConfig object

冷冻水总管温度阈值

scop_threshold

ThresholdConfig object

SCOP阈值

表7 SeasonModelConfig

参数

参数类型

描述

judge_condition

String

判断条件。加权温度-weightedTemp; 平均温度-averageTemp; 湿球温度-wetBulbTemp

weighted_temp

Integer

干球温度占比。范围[1-100],正整数。

seasons

Map<String,SeasonItem>

季节数组。

key为季节编码,value为温度范围

key的取值范围:冬季-WINTER; 过渡季-TRANSITION; 夏季-SUMMER

表8 SeasonItem

参数

参数类型

描述

min_value

Number

最低温度。范围[-100-100],保留1位小数。

max_value

Number

最高温度。范围[-100-100],保留1位小数。

表9 MorningPeakTimeConfig

参数

参数类型

描述

start_time

String

开始时间,格式为:"HH:mm:ss"。

end_time

String

结束时间,格式为:"HH:mm:ss"。

表10 ColdSiteEffCalcConfig

参数

参数类型

描述

eff_calc_start_time

String

参数说明:节能计算开始时间。

取值范围:格式为:"yyyy-MM-dd''T''HH:mm:ss.SSS''Z''"。

eff_calc_base_values

EffCalcBaseValues object

计算节能率的基准值列表

表11 EffCalcBaseValues

参数

参数类型

描述

jan

Double

一月份节能率基准值

feb

Double

二月份节能率基准值

mar

Double

三月份节能率基准值

apr

Double

四月份节能率基准值

may

Double

五月份节能率基准值

jun

Double

六月份节能率基准值

jul

Double

七月份节能率基准值

aug

Double

八月份节能率基准值

sep

Double

九月份节能率基准值

oct

Double

十月份节能率基准值

nov

Double

十一月份节能率基准值

dec

Double

十二月份节能率基准值

表12 ThresholdConfig

参数

参数类型

描述

operator

String

参数说明:冷站阈值比较符。

value

String

冷站阈值

表13 Page

参数

参数类型

描述

count

Long

参数说明:本次分页查询结果中,获取的记录总数。

marker

String

参数说明:本次分页查询结果中最后一条记录的ID,可在下一次分页查询时使用。

取值范围:长度0-64。

状态码:400

表14 响应Header参数

参数

参数类型

描述

X-Request-Id

String

This field is the request ID number for task tracking.

Format is request_uuid-timestamp-hostname.

表15 响应Body参数

参数

参数类型

描述

error_code

String

参数说明:错误码。

取值范围:长度8-36。

error_msg

String

参数说明:错误描述。

取值范围:长度2-512。

请求示例

响应示例

状态码

状态码

描述

200

查询冷站列表响应体

400

Error response

相关文档