更新时间:2024-11-21 GMT+08:00
分享

测试连接器创建参数

功能介绍

本接口用于测试连接器创建参数。

- 测试mysql连接器时需上传驱动文件,详见应用示例

- 该接口需将请求body转换为json字符串,详见请求示例

- 可校验连接器账户密码、网络连通性。

调用方法

请参见如何调用API

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

连接器类型

1.MRS--MapReduce连接器

2.JDBC--JAVA数据库连接器

3.MYSQL--MySQL连接器

4.DWS--高斯数据库连接器

5.ORACLE--ORACLE连接器

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

内部服务器错误

相关文档