# 预览kill会话任务 - PreviewSessionForKillProcessTask #### 功能介绍 预览kill会话任务。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-das/das_01_0130.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | das:clouddba:listProcess | list | instance | - | - | - | #### URI POST /v3/{project_id}/instances/{instance_id}/auto-flow/preview-session-for-kill-process-task 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 租户在某一Region下的项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-das/das_01_0036.html)。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，且长度为32个字符。 **默认取值：** 不涉及。 | | instance_id | 是 | String | **参数解释：** 实例ID，实例的唯一标识。可通过查看实例列表或者实例详情获取实例ID信息。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，且长度为36个字符。 **默认取值：** 不涉及。 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | user | 否 | String | **参数解释：** 数据库用户。 **取值范围：** 不涉及。 | | host | 否 | String | **参数解释：** 数据库主机。 **取值范围：** 不涉及。 | | db | 否 | String | **参数解释：** 数据库名称。 **取值范围：** 不涉及。 | | command | 否 | String | **参数解释：** 命令类型。 **取值范围：** - Change user - Close stmt - Connect - Connect Out - Create DB - Daemon - Debug - Delayed insert - Drop DB - Error - Execute - Fetch - Field List - Init DB - Kill - Long Data - Ping - Prepare - Processlist - Query - Quit - Refresh - Reset stmt - Set option - Shutdown - Sleep - Statistics - Table Dump - Time | | time | 是 | Long | **参数解释：** 会话执行时间。 **取值范围：** 不涉及。 | | info | 否 | String | **参数解释：** SQL信息。 **取值范围：** 不涉及。 | | task_duration | 是 | Long | **参数解释：** 任务持续时间。 **取值范围：** 不涉及。 | | task_type | 是 | String | **参数解释：** 任务类型。 **取值范围：** - auto：定时关闭 - manual：手动关闭 | #### 响应参数 **状态码： 200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | processes | Array of [表4] objects | **参数解释：** SQL限流信息列表。数组长度：0 - 200 | | data_sync_time | Long | **参数解释：** 数据同步的时间。 **取值范围：** 不涉及。 | | total_count | Integer | **参数解释：** 会话总数。 **取值范围：** 不涉及。 | 表4ProcessSessionInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Long | **参数解释：** 会话ID。 **取值范围：** 不涉及。 | | user | String | **参数解释：** 数据库用户。 **取值范围：** 不涉及。 | | host | String | **参数解释：** 数据库主机。 **取值范围：** 不涉及。 | | db | String | **参数解释：** 数据库名称。 **取值范围：** 不涉及。 | | command | String | **参数解释：** 命令类型。 **取值范围：** - Change user - Close stmt - Connect - Connect Out - Create DB - Daemon - Debug - Delayed insert - Drop DB - Error - Execute - Fetch - Field List - Init DB - Kill - Long Data - Ping - Prepare - Processlist - Query - Quit - Refresh - Reset stmt - Set option - Shutdown - Sleep - Statistics - Table Dump - Time | | sql_info | String | **参数解释：** SQL信息。 **取值范围：** 不涉及。 | | state_duration | Long | **参数解释：** 当前状态持续时间。 **取值范围：** 不涉及。 | | state | String | **参数解释：** 当前状态。 **取值范围：** 不涉及。 | #### 请求示例 ``` POST https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/bcfa975193f1402fa11a6d4fd6baf5fbin01/auto-flow/preview-session-for-kill-process-task { "user": "root", "host": "100.%", "db": "cds", "command": "Query", "info": "select~from~das", "task_duration": 10, "task_type": "auto", "time": 5 } ``` #### 响应示例 **状态码： 200** Success. ``` { "data_sync_time": 1766655104, "total_count": 1, "processes": [ { "id": 34850917, "user": "root", "host": "100.79.0.247:59474", "db": "cds", "state": "User sleep", "command": "Query", "sql_info": "SELECT sleep(49599)\nLIMIT 0, 50", "state_duration": 7 } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | Success. | | 400 | Client error. | | 500 | Server error. | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-das/das_01_0035.html)。