# 查询冷站列表 #### 功能介绍 查询冷站列表 #### URI GET /v1/iotfm/energy-eff/cold-sites 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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](https://support.huaweicloud.com/api-ocsmartcampus/ocsmartcampus_06_0008.html) 接口获取，接口返回的响应消息头中"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。 | 表5QueryColdSiteBaseRsp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 默认算法初始化状态 | 表6ColdSiteConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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阈值 | 表7SeasonModelConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | judge_condition | String | 判断条件。加权温度-weightedTemp; 平均温度-averageTemp; 湿球温度-wetBulbTemp | | weighted_temp | Integer | 干球温度占比。范围\[1-100\],正整数。 | | seasons | Map\ | 季节数组。 key为季节编码，value为温度范围 key的取值范围：冬季-WINTER; 过渡季-TRANSITION; 夏季-SUMMER | 表8SeasonItem | 参数 | 参数类型 | 描述 | |:---|:---|:---| | min_value | Number | 最低温度。范围\[-100-100\]，保留1位小数。 | | max_value | Number | 最高温度。范围\[-100-100\]，保留1位小数。 | 表9MorningPeakTimeConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | start_time | String | 开始时间，格式为："HH:mm:ss"。 | | end_time | String | 结束时间，格式为："HH:mm:ss"。 | 表10ColdSiteEffCalcConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | eff_calc_start_time | String | **参数说明**：节能计算开始时间。 **取值范围**：格式为："yyyy-MM-dd''T''HH:mm:ss.SSS''Z''"。 | | eff_calc_base_values | [EffCalcBaseValues] object | 计算节能率的基准值列表 | 表11EffCalcBaseValues | 参数 | 参数类型 | 描述 | |:---|:---|:---| | jan | Double | 一月份节能率基准值 | | feb | Double | 二月份节能率基准值 | | mar | Double | 三月份节能率基准值 | | apr | Double | 四月份节能率基准值 | | may | Double | 五月份节能率基准值 | | jun | Double | 六月份节能率基准值 | | jul | Double | 七月份节能率基准值 | | aug | Double | 八月份节能率基准值 | | sep | Double | 九月份节能率基准值 | | oct | Double | 十月份节能率基准值 | | nov | Double | 十一月份节能率基准值 | | dec | Double | 十二月份节能率基准值 | 表12ThresholdConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | operator | String | **参数说明**：冷站阈值比较符。 | | value | String | 冷站阈值 | 表13Page | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 |