# 创建全量SQL明细解析任务 - CreateTaskForParseAllSQLStatements
#### 功能介绍
创建全量SQL明细解析任务。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/DAS/doc?api=AddFullSqlTask)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-das/das_01_0130.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                      | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名                       | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | das:clouddba:listFullSql | list | instance    | -   | das:clouddba:fullSqlList | -      |
     
  
 
#### URI
POST /v3/{project_id}/instances/{instance_id}/full-sql/add-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参数 
| 参数             | 是否必选 | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| datastore_type | 是    | String           | **参数解释：** 数据库引擎类型。 **约束限制：** 不涉及。 **取值范围：** - mysql：云数据库 RDS for MySQL  - sqlserver：云数据库 RDS for SQL Server  - postgresql：云数据库 RDS for PostgreSQL  - taurus：云数据库 TaurusDB  - gaussdbv5：云数据库 GaussDB  - ddm：分布式数据库中间件 DDM   **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| node_id        | 否    | String           | **参数解释：** 节点ID，实例节点的唯一标识。可通过查看实例详情节点列表获取节点ID信息。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，且长度为36个字符。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| start_at       | 是    | Long             | **参数解释：** 开始时间。 **约束限制：** Unix timestamp，单位：毫秒。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| end_at         | 是    | Long             | **参数解释：** 结束时间。 **约束限制：** Unix timestamp，单位：毫秒。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| user_list      | 否    | Array of strings | **参数解释：** 用户名列表。 **约束限制：** 列表最大长度20。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| keyword_list   | 否    | Array of strings | **参数解释：** 关键字列表。 **约束限制：** 列表最大长度20。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| db_list        | 否    | Array of strings | **参数解释：** 数据库列表。 **约束限制：** 列表最大长度20。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| operation_list | 否    | Array of strings | **参数解释：** 操作类型列表。 - insert：插入  - delete：删除  - update：更新  - select：查询  - show：显示  - create：创建  - drop：丢弃/删除  - alter：修改  - set：设置  - replace：替换  - use：使用  - start：开始事务  - commit：提交事务  - rollback：回滚事务  - truncate：截断  - begin：开始事务  - call：调用存储过程   **约束限制：** 列表最大长度20。 |
| thread_id_list | 否    | Array of strings | **参数解释：** 线程ID列表。 **约束限制：** 列表最大长度20。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| status_list    | 否    | Array of strings | **参数解释：** 执行状态列表。 - 0：成功  - 1：失败   **约束限制：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数      | 参数类型 | 描述                                                                                                                   |
|:---|:---|:---|
| task_id | Long | **参数解释：** 任务ID。 **取值范围：** 不涉及。 |
   
#### 请求示例
```
POST https://das.cn-north-1.myhuaweicloud.com/v3/63be57f43e114de790a9735d1c5bc95d/instances/5c59fa7d6f09456b947f32922f9aeda1in01/full-sql/add-task
{
    "datastore_type": "mysql",
    "node_id": "09ab88b8a12340569ac056af284011d9no01",
    "start_at": 1742815900000,
    "end_at": 1742819500000,
    "user_list": [
        "a"
    ],
    "keyword_list": [
        "b"
    ],
    "db_list": [
        "c",
        "sdfssdff"
    ],
    "operation_list": [
        "select"
    ],
    "thread_id_list": [
        "1"
    ],
    "status_list": [
        "0"
    ]
}
```
#### 响应示例
**状态码： 200**
```
{
  "task_id": 1
}
```
#### 状态码
| 状态码 | 描述            |
|:---|:---|
| 200 | Success.      |
| 400 | Client error. |
| 500 | Server error. |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-das/das_01_0035.html)。