冷站功率滚动预测

功能介绍

冷站功率滚动预测

URI

POST /v1/iotfm/energy-eff/cold-sites/{site_id}/powers-rolling-prediction

表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，只允许字母、数字的组合。

表3 请求Body参数
参数	是否必选	参数类型	描述
start_time	是	String	参数说明: '开始时间，格式为："yyyy-MM-dd''T''HH:mm:ss.SSS''Z''"。'
end_time	是	String	参数说明: '结束时间，格式为："yyyy-MM-dd''T''HH:mm:ss.SSS''Z''"。'
algorithm_source_feature	否	String	参数说明: 算法来源特性（算法功能）。取值范围: ModelArts算法可以取下列枚举值： coldsite_allocation_optimization：冷站分配调优算法

响应参数

状态码：200

表4 响应Header参数
参数	参数类型	描述
X-Request-Id	String	This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname.

表5 响应Body参数
参数	参数类型	描述
add_times	Array of Coordinate objects	参数说明: 加机坐标列表。取值范围: 数组长度不超过48。
sub_times	Array of Coordinate objects	参数说明: 减机坐标列表。取值范围: 数组长度不超过48。
all_day_times	Array of strings	参数说明: 当日功率时间戳取值范围: 数组长度为48。
real_power_list	Array of numbers	参数说明: 冷站实际功率列表。取值范围: 数组长度为48。
predict_power_list	Array of numbers	参数说明: 冷站预测功率列表取值范围: 数组长度为48。
current_time_index	Integer	参数说明: 当前时间点横坐标下标取值范围: 最大值48
rate_power	Number	参数说明: 冷站额定功率

表6 Coordinate
参数	参数类型	描述
abscissa	String	参数说明: 横坐标，值为时间戳
ordinate	Number	参数说明: 纵坐标，值为冷机预测功率

状态码：400

表7 响应Header参数
参数	参数类型	描述
X-Request-Id	String	This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname.

表8 响应Body参数
参数	参数类型	描述
error_code	String	参数说明：错误码。取值范围：长度8-36。
error_msg	String	参数说明：错误描述。取值范围：长度2-512。

请求示例

查询当日冷站功率响应体

GET https://{endpoint}/v1/iotfm/energy-eff/cold-sites/26087212bc75410c9ad77163410c9ad77163/powers-rolling-prediction

{
  "start_time" : "2022-12-25T16:00:00.000Z",
  "end_time" : "2022-12-26T15:59:59.000Z"
}