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

查询单个冷站信息

功能介绍

查询单个冷站信息

URI

GET /v1/iotfm/energy-eff/cold-sites/{site_id}

表1 路径参数

参数

是否必选

参数类型

描述

site_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参数

参数

参数类型

描述

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

默认算法初始化状态

devices

Map<String,Array<String>>

冷站中包含的设备。

表5 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阈值

表6 SeasonModelConfig

参数

参数类型

描述

judge_condition

String

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

weighted_temp

Integer

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

seasons

Map<String,SeasonItem>

季节数组。

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

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

表7 SeasonItem

参数

参数类型

描述

min_value

Number

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

max_value

Number

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

表8 MorningPeakTimeConfig

参数

参数类型

描述

start_time

String

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

end_time

String

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

表9 ColdSiteEffCalcConfig

参数

参数类型

描述

eff_calc_start_time

String

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

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

eff_calc_base_values

EffCalcBaseValues object

计算节能率的基准值列表

表10 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

十二月份节能率基准值

表11 ThresholdConfig

参数

参数类型

描述

operator

String

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

value

String

冷站阈值

状态码:400

表12 响应Header参数

参数

参数类型

描述

X-Request-Id

String

This field is the request ID number for task tracking.

Format is request_uuid-timestamp-hostname.

表13 响应Body参数

参数

参数类型

描述

error_code

String

参数说明:错误码。

取值范围:长度8-36。

error_msg

String

参数说明:错误描述。

取值范围:长度2-512。

请求示例

响应示例

状态码

状态码

描述

200

查询单个冷站响应体

400

Error response

相关文档