
# 创建评估项目
#### 功能介绍
创建评估项目。评估项目分2个阶段：采集、评估。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=UGO&api=CreateEvaluationProject)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
POST /v1/{project_id}/evaluation-projects
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                              |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户在某一Region下的Project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ugo/ugo_05_0025.html)。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 从IAM服务获取的用户Token。 |
   
表3请求Body参数 
| 参数                      | 是否必选 | 参数类型                                               | 描述                                                                                                                                    |
|:---|:---|:---|:---|
| evaluation_project_name | 是    | String                                             | 评估项目名称。长度为5-50个字符，以英文字母开头，英文字母或数字结束，允许包含下划线和中划线。不允许重复。 最小长度：**5** 最大长度：**50** |
| source_db_info          | 是    | [表4] object   | 源库信息。                                                                                                                                 |
| schemas_info            | 是    | [表5] object     | 源库中的schema信息。                                                                                                                         |
| objects_type_info       | 是    | [表6] object | 源库中的对象类型信息。                                                                                                                           |
   
 表4SourceDBInfo 
| 参数                | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| connection_string | 是    | String | 连接字符串。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| user_name         | 是    | String | 用户名。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| password          | 是    | String | 用户密码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| source_db_type    | 是    | String | 数据库类型。 **枚举值：** - Oracle  - MySQL  - GoldenDB  - PostgreSQL  - Microsoft SQL Server  - Informix  - MariaDB  - openGauss  - DDM                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| source_db_version | 是    | String | 数据库版本。 注意： 该字段的值是数据库类型source_db_type对应的版本。 源数据库版本。 枚举值： - Oracle： 10g、11g、12c、18c、19c、21c   - MySQL 5.5、5.6、5.7、8.0     - Microsoft SQL Server： 2012、2014、2016、2017、2019、2022     - Informix: 11、12     - MariaDB： 10.6     - openGauss： 1.0、2.0、3.0、4.0、5.0、6.0、7.0    |
   
 表5SchemaInfo 
| 参数                    | 是否必选 | 参数类型             | 描述                                               |
|:---|:---|:---|:---|
| is_select_all_schemas | 是    | Boolean          | 是否选择全部schema。                                    |
| schemas_list          | 否    | Array of strings | 需要评估的源库schema列表。is_select_all_schemas为false时，必填。 |
   
 表6ObjectTypeInfo 
| 参数                         | 是否必选 | 参数类型             | 描述                                                   |
|:---|:---|:---|:---|
| is_select_all_objects_type | 是    | Boolean          | 是否选择全部object类型。取值为true时，不包含USER。                     |
| objects_type_list          | 否    | Array of strings | 需要评估的object类型列表。is_select_all_objects_type为false时必填。 |
   
#### 响应参数
无
#### 请求示例
创建名为best_UGO，源库为Oracle-11g，采集全部schema和全部支持的数据类型的评估项目。
```
POST https://{endpoint}/v1/0ac6eb2c8000d2ee2fd9c006dededbe6/evaluation-projects 
 
{ 
  "evaluation_project_name" : "best_UGO", 
  "source_db_info" : { 
    "user_name" : "ugo", 
    "password" : "Ugo@123", 
    "connection_string" : "100.xx.xxx.xxx:1521:ORCL", 
    "source_db_type" : "ORACLE", 
    "source_db_version" : "11g" 
  }, 
  "schemas_info" : { 
    "is_select_all_schemas" : true, 
    "schemas_list" : [ ] 
  }, 
  "objects_type_info" : { 
    "is_select_all_objects_type" : true, 
    "objects_type_list" : [ ] 
  } 
}
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述    |
|:---|:---|
| 201 | 请求成功。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ugo/ugo_05_0024.html)。
