# 测试连接器创建参数 - testConnector
#### 功能介绍
本接口用于测试连接器创建参数。
- 测试mysql连接器时需上传驱动文件，详见应用示例
- 该接口需将请求body转换为json字符串，详见请求示例
- 可校验连接器账户密码、网络连通性。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-tics/tics_05_0025.html)。
#### URI
POST /v1/agents/connectors/test
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                     |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用接口获取用户Token接口获取。          |
| X-Language   | 是    | String | 根据自己偏好的语言来获取不同语言的返回内容，zh-cn或者en_us     |
| Content-Type | 是    | String | 消息体的类型（格式），必选，此接口为multipart/form-data。 |
   
表2请求Body参数 
| 参数             | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|
| name           | 是    | String | 连接器名称                                                                                                                                                                                                                                                                                                                                                                                                       |
| connector_id   | 否    | String | 连接器id，长度32，更新连接器时必填                                                                                                                                                                                                                                                                                                                                                                                         |
| connector_type | 是    | String | 连接器类型，主要分为多方安全计算连接器和可信联邦学习连接器。 多方安全计算连接器 MRS， RDS_MYSQL， DWS， JDBC， MYSQL， ORACLE， 可信联邦学习连接器 LOCAL |
| auth_type      | 是    | String | 认证类型 1.PWD----密码 2.AK_SK----访问密钥与私有访问密钥                                                                                                                                                                                                                                                                                                   |
| ext_info       | 是    | String | json格式存放键值对形式配置信息                                                                                                                                                                                                                                                                                                                                                                                           |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数 | 参数类型   | 描述 |
|:---|:---|:---|
| -  | String | -- |
   
**状态码：500**
表4响应Body参数 
| 参数 | 参数类型   | 描述 |
|:---|:---|:---|
| -  | String | -- |
   
#### 请求示例
- 测试连接器(MRS)
  ```
  post https://x.x.x.x:12345/v1/agents/connectors
  data_connector: {"connector_type":"MRS","name":"hive","ext_info":"{"master_node_ip":"*.*.*.*","cluster_id":"cee282ae-fcaf-46ad-a145-9e5198f710a9","user_name":"***","password":"***"}","auth_type":"PWD"}
  ```
  
- 测试连接器(RDS)
  ```
  post https://x.x.x.x:12345/v1/agents/connectors
  data_connector: {"connector_type":"RDS_MYSQL","name":"rds2","ext_info":"{"rds":"ea20335038f54ecaafb83e6c26a4d856in01","jdbc_url":"jdbc:mysql://*.*.*.*:3306","driver_name":"mysql-connector-java-8.0.20.jar","properties":"","user_name":"***","password":"***"}","auth_type":"PWD"}
  ```
  
- 测试连接器(MySql)
  ```
  post https://x.x.x.x:12345/v1/agents/connectors
  data_connector: {"connector_type":"MYSQL","name":"mysql2","ext_info":"{"user_name":"***","password":"***","jdbc_url":"jdbc:mysql://*.*.*.*:3306","driver_name":"mysql-connector-java-8.0.20.jar","properties":""}","auth_type":"PWD"}
  ```
  
- 测试连接器(DWS)
  ```
  post https://x.x.x.x:12345/v1/agents/connectors
  data_connector: {"connector_type":"DWS","name":"dws","ext_info":"{"dws":"c07f71b6-f004-482f-b414-4124eca1f82c","jdbc_url":"jdbc:postgresql://*.*.*.*:8000/postgres","driver_name":"dws-jdbc-1.7.1.jar","properties":"","user_name":"postgres","password":"***"}","auth_type":"PWD"}
  ```
  
- 测试连接器(ORACLE)
  ```
  post https://x.x.x.x:12345/v1/agents/connectors
  data_connector: {"connector_type":"ORACLE","name":"oracle","ext_info":"{"database_name":"test","database_ip":"*.*.*.*","database_port":"8080","user_name":"tics","password":"***"}","auth_type":"PWD"}
  ```
  
 
#### 响应示例
**状态码：200**
连接器连接测试成功
```
true
```
**状态码：500**
内部服务器错误
```
{
  "error_code" : "TICS_AGENT.10000012",
  "error_msg" : "测试连接失败，请检查参数或上传文件权限"
}
```
#### 状态码
| 状态码 | 描述        |
|:---|:---|
| 200 | 连接器连接测试成功 |
| 401 | 操作无权限     |
| 500 | 内部服务器错误   |