# 查询操作记录列表 #### 功能介绍 查询操作记录列表 #### URI GET /v1/iotfm/energy-eff/operate-records 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | marker | 否 | String | **参数说明**：上一次分页查询结果中最后一条记录的ID，在上一次分页查询时由物联网平台返回获得。分页查询时物联网平台是按marker也就是记录ID降序查询的，越新的数据记录ID也会越大。若填写marker，则本次只查询记录ID小于marker的数据记录。若不填写，则从记录ID最大也就是最新的一条数据开始查询。如果需要依次查询所有数据，则每次查询时必须填写上一次查询响应中的marker值。 **取值范围**：长度固定24，只允许大小写字母、数组的组合。 缺省值：**ffffffffffffffffffffffff** 最小长度：**24** 最大长度：**24** | | limit | 否 | Integer | **参数说明**：分页查询时每页显示的记录数。 **取值范围**：默认值为10，取值范围为1-50的整数。 最小值：**1** 最大值：**50** 缺省值：**10** | | 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的整数。 最小值：**0** 最大值：**500** 缺省值：**0** | | cold_site_id | 是 | String | 冷站ID | | start_time | 否 | String | 开始时间，格式为："yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"。 | | end_time | 否 | String | 结束时间，格式为："yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数说明** ：用户Token。通过调用 [生成Token](https://support.huaweicloud.com/api-ocsmartcampus/ocsmartcampus_06_0008.html) 接口获取，接口返回的响应消息头中"X-Subject-Token"就是需要获取的用户Token。 **取值范围**：长度1-32768。 最小长度：**1** 最大长度：**32768** | | X-Instance-Id | 是 | String | **参数说明**：实例ID。通过访问智能设施云平台界面后获取，智能设施云平台资源均为实例级隔离，所有业务接口必须填写正确的实例ID才能被成功调用。 **取值范围**：长度8-36，只允许大小写字母、数字和-字符的组合。 最小长度：**8** 最大长度：**36** | | X-Root-Zone-Id | 否 | String | **参数说明**：根区域ID。 **取值范围**：长度1-24，只允许大小写字母、数字的组合。 最小长度：**1** 最大长度：**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参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | operate_records | Array of [OperateRecordRspDTO] objects | 查询节能规则列表 数组长度：**0 - 50** | | page | [Page] object | 查询批量分页结构体，定义了分页页码、每页记录数、记录总数、该页记录的最大ID。 | 表5OperateRecordRspDTO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | instance_id | String | 实例ID 最小长度：**1** 最大长度：**36** | | root_zone_id | String | 空间ID 最小长度：**1** 最大长度：**36** | | cold_site_id | String | 冷站ID 最小长度：**1** 最大长度：**36** | | is_match_advice | Boolean | 是否关联操作建议 | | advice_id | String | 规则ID 最小长度：**1** 最大长度：**36** | | operate_type | String | 规则名称 最小长度：**0** 最大长度：**128** | | before_value | Array of [DataItem] objects | 指令操作前的值 数组长度：**0 - 256** | | after_value | Array of [DataItem] objects | 指令操作后的值 数组长度：**0 - 256** | | description | String | 规则消息/操作类型 最小长度：**0** 最大长度：**64** | | create_time | String | 创建时间，格式为："yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"。 | 表6DataItem | 参数 | 参数类型 | 描述 | |:---|:---|:---| | data_type | String | 数据类型(LARGE_CHILLER_COUNT\|SMALL_CHILLER_COUNT) 最小长度：**0** 最大长度：**64** 枚举值： - **LARGE_CHILLER_COUNT** - **SMALL_CHILLER_COUNT** | | data_value | Number | 数据值 最小值：**-100.0** 最大值：**100.0** | 表7Page | 参数 | 参数类型 | 描述 | |:---|:---|:---| | count | Long | **参数说明**：本次分页查询结果中，获取的记录总数。 最小值：**0** 最大值：**9223372036854775807** | | marker | String | **参数说明**：本次分页查询结果中最后一条记录的ID，可在下一次分页查询时使用。 **取值范围**：长度0-64。 最小长度：**0** 最大长度：**64** | **状态码： 400** 表8响应Header参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | X-Request-Id | String | This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname. | 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数说明**：错误码。 **取值范围**：长度8-36。 最小长度：**8** 最大长度：**36** | | error_msg | String | **参数说明**：错误描述。 **取值范围**：长度2-512。 最小长度：**2** 最大长度：**512** | #### 请求示例 无 #### 响应示例 无 #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询节能规则列表响应体 | | 400 | Error response | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ocsmartcampus/ocsmartcampus_06_0198.html)。