# 查询策略执行日志 - ListScalingPolicyExecuteLogs
#### 功能介绍
根据输入条件过滤查询策略执行的历史记录。查询结果分页显示。
- 可根据日志ID，伸缩资源类型，伸缩资源ID，策略执行类型，查询起始时间，查询截止时间，查询起始行号，查询记录数进行条件过滤查询。
- 若不加过滤条件默认查询最多20条策略执行日志信息。
 
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/AS/doc?api=ListScalingPolicyExecuteLogs)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-as/as_07_0200.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                              | 访问级别  | 资源类型（\*为必须）        | 条件键                                                                                                          | 别名                                   | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | as:scalingPolicy:listExecuteLogs | list | scalingPolicy\* | [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2) | as:policyExecuteLogs:list | -      |
     
  
 
#### URI
GET /autoscaling-api/v1/{project_id}/scaling_policy_execute_log/{scaling_policy_id}
![](https://support.huaweicloud.com/api-as/public_sys-resources/note_3.0-zh-cn.png)
可以在URI后面用'?'和'\&'添加不同的查询条件组合。支持参数说明中所有非必选参数过滤，请参考请求示例。
表1参数说明 
| 参数                   | 是否必选 | 参数类型     | 描述                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| project_id            | 是  | String  | 项目ID                                                                                                                                                                                                                                                                                                                                                          |
| scaling_policy_id    | 是    | String   | 伸缩策略ID                                                                                                                                                                                                                                                                                                                                                  |
| log_id               | 否     | String  | 策略执行日志ID                                                                                                                                                                                                                                                                                                                                                  |
| scaling_resource_type | 否    | String   | 伸缩资源类型 - 伸缩组：SCALING_GROUP  - 带宽：BANDWIDTH                                                                                                                                                               |
| scaling_resource_id   | 否    | String   | 伸缩资源ID                                                                                                                                                                                                                                                                                                                                                   |
| execute_type          | 否     | String  | 策略执行类型： - SCHEDULED：自动触发（定时）  - RECURRENCE：自动触发（周期）  - ALARM：自动触发（告警）  - MANUAL：手动触发   |
| start_time            | 否   | String   | 查询的起始时间，遵循UTC时间，格式是"yyyy-MM-ddThh:mm:ssZ"。                                                                                                                                                                                                                                                                                                                 |
| end_time              | 否    | String   | 查询的截止时间，遵循UTC时间，格式是"yyyy-MM-ddThh:mm:ssZ"。                                                                                                                                                                                                                                                                                                                 |
| start_number           | 否    | Integer  | 查询的起始行号，默认为0。最小值为0。                                                                                                                                                                                                                                                                                                                                           |
| limit                | 否   | Integer | 查询的记录条数，默认为20。取值范围为：0\~100。                                                                                                                                                                                                                                                                                                                                   |
   
#### 请求参数
无
#### 请求示例
查询ID为05545d3d-ccf9-4bca-ae4f-1e5e73ca0bf6的伸缩策略执行日志信息。
```
GET https://{Endpoint}/autoscaling-api/v1/edcb94a885a84ed3a3fdf8ea4d2741da/scaling_policy_execute_log/05545d3d-ccf9-4bca-ae4f-1e5e73ca0bf6
```
#### 响应参数
表2响应参数 
| 参数                           | 参数类型                                                                            | 描述                                                                                   |
|:---|:---|:---|
| total_number              | Integer                                                                        | 总记录数                                                                                 |
| start_number              | Integer                                                                         | 查询的起始行号                                                                              |
| limit                      | Integer                                                                          | 查询记录数                                                                               |
| scaling_policy_execute_log | Array of [scaling_policy_execute_log] objects | 伸缩策略执行日志列表。详情请见[表 scaling_policy_execute_log字段数据结构说明]。 |
   
 表3scaling_policy_execute_log字段数据结构说明 
| 参数                   | 参数类型                                                            | 描述                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|
| status                 | String                                                            | 策略执行状态： - SUCCESS：成功  - FAIL：失败  - EXECUTING：执行中                                                                                                                        |
| failed_reason          | String                                                           | 策略执行失败原因                                                                                                                                                                                                                                                                                                                                                                               |
| execute_type           | String                                                            | 策略执行类型： - SCHEDULE：自动触发（定时）  - RECURRENCE：自动触发（周期）  - ALARM：自动触发（告警）  - MANUAL：手动触发                                   |
| execute_time         | String                                                           | 策略执行时间，遵循UTC时间。                                                                                                                                                                                                                                                                                                                                                                       |
| id                   | String                                                            | 策略执行日志ID                                                                                                                                                                                                                                                                                                                                                                               |
| tenant_id             | String                                                             | 项目ID                                                                                                                                                                                                                                                                                                                                                                                  |
| scaling_policy_id     | String                                                             | 伸缩策略ID                                                                                                                                                                                                                                                                                                                                                                                |
| scaling_resource_type | String                                                           | 伸缩资源类型 - 伸缩组：SCALING_GROUP  - 带宽：BANDWIDTH                                                                                                                                                                                    |
| scaling_resource_id    | String                                                           | 伸缩资源ID                                                                                                                                                                                                                                                                                                                                                                               |
| old_value              | String                                                             | 伸缩原始值                                                                                                                                                                                                                                                                                                                                                                                  |
| desire_value          | String                                                            | 伸缩目标值                                                                                                                                                                                                                                                                                                                                                                                 |
| limit_value          | String                                                           | 操作限制 当scaling_resource_type为BANDWIDTH时，且operation不为SET时，limit_value生效，单位为Mbit/s。 此时， - 当operation为ADD时，limit_value表示最高带宽限制；  - 当operation为REDUCE时，limit_value表示最低带宽限制。   |
| type                 | String                                                           | 策略执行任务类型 - ADD：增加  - REMOVE：减少  - SET：设置为                                                                                                                                |
| job_records            | Array of [job_records] objects | 策略执行动作包含的具体任务。详情请见[表 job_records字段数据结构说明]。                                                                                                                                                                                                                                                                                                            |
| meta_data             | [meta_data] object               | 附加信息。详情请见[表 meta_data字段数据结构说明]。                                                                                                                                                                                                                                                                                                                      |
   
 表4job_records字段数据结构说明 
| 参数            | 参数类型    | 描述                                                                                                                                                                                 |
|:---|:---|:---|
| job_name     | String    | 任务名称                                                                                                                                                                              |
| record_type | String   | 记录类型 - API：接口调用类型  - MEG：消息类型   |
| record_time   | String   | 记录时间                                                                                                                                                                              |
| request     | String    | 请求体，仅当record_type为API时有效                                                                                                                                                          |
| response      | String  | 返回体，仅当record_type为API时有效                                                                                                                                                          |
| code          | String    | 返回码，仅当record_type为API时有效                                                                                                                                                         |
| message       | String | 消息，仅当record_type为MEG时有效                                                                                                                                                             |
| job_status  | String    | job执行状态： - SUCCESS：成功  - FAIL：失败      |
   
 表5meta_data字段数据结构说明 
| 参数                            | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|
| metadata_bandwidth_share_type | String | **参数解释：** 伸缩带宽策略中带宽对应的共享类型。 **取值范围：** - PER：独享型  - WHOLE：共享型   |
| metadata_eip_id              | String  | 伸缩带宽策略中带宽对应的EIP的ID。                                                                                                                                                                                                                                                                                                                                         |
| metadataeip_address            | String   | 伸缩带宽策略中带宽对应的EIP地址。                                                                                                                                                                                                                                                                                                                                           |
   
#### 响应示例
```
{
  "limit": 20,
  "scaling_policy_execute_log": [
    {
      "id": "b86e4175-30cb-4b1e-a332-83f9ee472c58",
      "status": "SUCCESS",
      "type": "REMOVE",
      "tenant_id": "0428982a1b8039f42f01c005edde7c0d",
      "scaling_resource_type": "SCALING_GROUP",
      "scaling_resource_id": "1f2d3e73-7ef6-40b3-a8fa-514b68eccaa7",
      "scaling_policy_id": "05545d3d-ccf9-4bca-ae4f-1e5e73ca0bf6",
      "old_value": "1",
      "desire_value": "0",
      "limit_value": "0",
      "execute_time": "2019-03-18T16:00:00Z",
      "execute_type": "RECURRENCE",
      "job_records": [
        {
          "message": "modify desire number of scaling group",
          "job_name": "ADJUST_VM_NUMBERS",
          "record_type": "MEG",
          "record_time": "2019-03-18T16:00:00Z",
          "job_status": "SUCCESS"
        }
      ]
    }
  ],
  "total_number": 1,
  "start_number": 0
}
```
#### 返回值
- 正常 200
  
- 异常
  
  | 返回值                             | 说明                          |
  |:---|:---|
  | 400 Bad Request                   | 服务器未能处理请求。                  |
  | 401 Unauthorized                | 被请求的页面需要用户名和密码。               |
  | 403 Forbidden                    | 对被请求的页面访问禁止。                 |
  | 404 Not Found                      | 服务器无法找到被请求的页面。                |
  | 405 Method Not Allowed           | 请求中指定的方法不被允许。               |
  | 406 Not Acceptable              | 服务器生成的响应无法被客户端所接受。            |
  | 407 Proxy Authentication Required | 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 |
  | 408 Request Timeout               | 请求超出了服务器的等待时间。               |
  | 409 Conflict                      | 由于冲突，请求无法被完成。               |
  | 500 Internal Server Error       | 请求未完成。服务异常。                   |
  | 501 Not Implemented              | 请求未完成。服务器不支持所请求的功能。          |
  | 502 Bad Gateway                  | 请求未完成。服务器从上游服务器收到一个无效的响应。    |
  | 503 Service Unavailable          | 请求未完成。系统暂时异常。               |
  | 504 Gateway Timeout               | 网关超时。                        |
     
  
 
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-as/as_07_0102.html)。
