查询指定数据源
功能介绍
根据数据源ID查询数据源。
URI
GET /v2/{project_id}/fdi/instances/{instance_id}/datasources/{datasource_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目的ID,获取方式请参见API参考的“附录 > 获取项目ID”章节。 最小长度:1 最大长度:64 |
instance_id |
是 |
String |
实例ID。 最小长度:1 最大长度:64 |
datasource_id |
是 |
String |
数据源ID。 最小长度:1 最大长度:64 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
datasource_id |
String |
数据源ID。 最小长度:4 最大长度:64 |
datasource_name |
String |
数据源名称。 最小长度:4 最大长度:255 |
datasource_type |
String |
数据源类型。
最小长度:1 最大长度:32 |
vpc_id |
String |
数据源所属虚拟私有云VPC ID。 最小长度:4 最大长度:64 |
app_id |
String |
数据源所属应用ID。 最小长度:4 最大长度:255 |
app_name |
String |
数据源所属应用名称。 最小长度:4 最大长度:255 |
instance_id |
String |
数据源所属实例ID。 最小长度:4 最大长度:255 |
create_time |
Long |
数据源创建时间。 最小值:0 最大值:99999999999999999 |
update_time |
Long |
数据源修改时间。 最小值:0 最大值:99999999999999999 |
custom_plugin_id |
String |
数据源所属连接器ID。 最小长度:0 最大长度:64 |
content |
Content object |
数据源详细信息。 |
description |
String |
数据源描述。 最小长度:4 最大长度:2147483647 |
app_permission |
Array of strings |
集成应用权限信息。
数组长度:0 - 4 |
参数 |
参数类型 |
描述 |
---|---|---|
gauss100_version |
String |
gauss100的版本号。 数据源类型为gauss100的时候必填
最小长度:1 最大长度:64 |
host |
String |
主机IP地址。
最小长度:4 最大长度:255 |
port |
String |
端口,端口号为0到65535。
最小长度:1 最大长度:65535 |
database_name |
String |
数据库名称。
最小长度:1 最大长度:2147483647 |
redis_database |
String |
REDIS数据源类型配置,数据库编号,纯数字编码。 最小长度:1 最大长度:1000 |
user_name |
String |
访问服务的用户名。
最小长度:1 最大长度:255 |
password |
String |
访问服务的密码。
最小长度:4 最大长度:2147483647 |
mode |
String |
数据源连接模式,有三种:default (默认模式)、professional (专业模式)、multiAddress (多地址)。
最小长度:4 最大长度:255 |
cdc_mode |
String |
cdc模式,只有组合任务使用。 最小长度:4 最大长度:10 |
multi_oracle_address |
Array of MultiOracleAddress objects |
ORACLE集群地址,当“mode”为“multiAddress”时需要配置。 数组长度:1 - 100 |
oracle_service_name |
String |
ORACLE集群服务名。 最小长度:4 最大长度:64 |
ftp_connect_mode |
String |
访问FTP服务的连接模式。
最小长度:4 最大长度:2147483647 |
ftp_protocol |
String |
访问FTP服务协议类型。
最小长度:4 最大长度:2147483647 |
address |
String |
地址。
最小长度:0 最大长度:256 |
ak |
String |
Access Key ID。 数据源为OBS,DIS类型时需要配置。 最小长度:0 最大长度:256 |
sk |
String |
Secret Access Key。 数据源为OBS,DIS类型时需要配置。 最小长度:0 最大长度:256 |
bucket_name |
String |
桶名称,数据源为OBS时需要配置。 最小长度:0 最大长度:256 |
https |
Boolean |
是否使用https, 数据源为OBS时需要配置,一般默认使用。 |
url |
String |
连接字符串,访问url。
最小长度:0 最大长度:256 |
api_method |
String |
访问API请求方式。
最小长度:0 最大长度:10 |
auth_method |
String |
访问WEBSOCKET服务的认证方式。
最小长度:0 最大长度:256 |
api_auth_detail |
ApiAuthDetail object |
API鉴权详细字段。 |
broker |
String |
KAFKA、MQS、ACTIVEMQ的服务器地址,多个IP:PORT,使用","分隔。 最小长度:0 最大长度:256 |
ssl |
Boolean |
是否开启SSL认证。 连接MQS内网地址时,若MQS开启了SSL,请选择“是”。 |
ssl_enable |
Boolean |
是否开启SSL认证。
|
ssl_username |
String |
SSL用户名/应用Key。 数据源为KAFKA或者MQS时,且开启SSL认证时需要配置。 最小长度:0 最大长度:256 |
ssl_password |
String |
SSL密码/应用Secret。 数据源为KAFKA或者MQS时,且开启SSL认证时需要配置。 最小长度:0 最大长度:256 |
acl_enable |
Boolean |
是否开启ACL认证。
|
mq_type |
String |
IMF数据源消息队列类型。
最小长度:0 最大长度:10 |
mongodb_auth_source |
String |
MONGODB认证源。 最小长度:0 最大长度:60 |
mongodb_cluster_enable |
Boolean |
MONGODB集群模式。
|
mongodb_replica_set |
String |
MONGODB副本集。 当MONGODB为非集群模式时配置。 最小长度:0 最大长度:256 |
encoding |
String |
编码格式。
最小长度:0 最大长度:10 |
mysql_timeout |
Integer |
MYSQL连接超时时间(秒)。 最小值:1 最大值:20000 |
trust_store_password |
String |
公钥库密码。 数据源类型为ACTIVEMQ、ARTEMISMQ、RABBITMQ、IBMMQ且开启SSL认证时需要配置。 最小长度:0 最大长度:256 |
trust_store |
String |
公钥库文件。 数据源类型为ACTIVEMQ、ARTEMISMQ、RABBITMQ、IBMMQ且开启SSL认证时需要配置。 最小长度:0 最大长度:1024 |
trust_store_file_type |
String |
公钥库文件类型。 数据源类型为ACTIVEMQ、ARTEMISMQ、RABBITMQ、IBMMQ且开启SSL认证时需要配置。 最小长度:0 最大长度:10 |
ssl_auth_method |
String |
SSL鉴权方式。 数据源类型为ACTIVEMQ、ARTEMISMQ且开启SSL认证时需要配置。
最小长度:0 最大长度:10 |
key_store |
String |
私钥库文件内容。 数据源类型为ACTIVEMQ、ARTEMISMQ,开启SSL认证并且认证方式是two-way时需要配置。 最小长度:0 最大长度:1024 |
key_store_file_type |
String |
私钥库文件类型。 数据源类型为ACTIVEMQ、ARTEMISMQ,开启SSL认证并且认证方式是two-way时需要配置。 最小长度:0 最大长度:10 |
key_store_password |
String |
私钥库密码。 数据源类型为ACTIVEMQ、ARTEMISMQ,开启SSL认证并且认证方式是two-way时需要配置。 最小长度:0 最大长度:256 |
key_store_key_password |
String |
私钥库私钥密码。 数据源类型为ACTIVEMQ、ARTEMISMQ,开启SSL认证并且认证方式是two-way时需要配置。 最小长度:0 最大长度:256 |
dis_tunnel_name |
String |
DIS通道名称。 最小长度:0 最大长度:256 |
dis_data_type |
String |
DIS数据类别。 包含:JSON。 最小长度:0 最大长度:256 |
dis_setting_type |
String |
DIS配置类别。
最小长度:0 最大长度:256 |
dis_endpoint |
String |
DIS Endpoint,当setting_type为senior时填写。 最小长度:0 最大长度:256 |
dis_region |
String |
DIS Region,当setting_type为senior时填写。 最小长度:0 最大长度:256 |
dis_source_project_id |
String |
DIS源端项目ID,当setting_type为senior时填写。 最小长度:0 最大长度:256 |
hl7_position |
String |
HL7数据源方向。
最小长度:0 最大长度:256 |
hl7_whitelist_enable |
Boolean |
HL7是否开启白名单设置。 |
hl7_whitelist |
String |
HL7白名单。允许同步数据到源端HL7的服务器地址,当HL7为源端(position为source)并且开启白名单设置(open_whitelist为true)时填写。 最小长度:0 最大长度:256 |
ldap_security_auth_type |
String |
LDAP安全认证类型。 最小长度:0 最大长度:256 |
rabbitmq_virtual_host |
String |
RabbitMQ虚拟主机。 最小长度:0 最大长度:256 |
rabbitmq_ssl_protocol |
String |
RABBITMQ SSL认证协议。 包含:TLS。 最小长度:0 最大长度:10 |
rocketmq_namesrv_addr |
String |
IMF数据源RocketMQ连接地址,mq_type为RocketMQ时填写,多个地址以‘,’分隔。 最小长度:0 最大长度:256 |
namesrv_addr |
String |
ROMA 20.0 MQS连接地址。 最小长度:0 最大长度:256 |
app_id |
String |
ROMA 20.0 MQS APP Key 最小长度:0 最大长度:256 |
app_secret |
String |
ROMA 20.0 APP Secret 最小长度:0 最大长度:256 |
sap_client |
String |
SAP客户端号。 最小长度:0 最大长度:10 |
sap_sysnr |
String |
SAP实例编号。 最小长度:0 最大长度:256 |
snmp_network_protocol |
String |
SNMP网络协议。
最小长度:0 最大长度:10 |
snmp_version |
Integer |
SNMP版本号。 最小值:0 最大值:3 |
snmp_community |
String |
SNMP团体名,用于访问SNMP管理代理的身份认证,相当于访问密码。 最小长度:0 最大长度:256 |
ibmmq_ccs_id |
String |
IBMMQ字符集标识。 最小长度:0 最大长度:65535 |
ibmmq_queue_manager |
String |
IBMMQ队列管理器。 最小长度:0 最大长度:256 |
ibmmq_channel |
String |
IBMMQ通道名称。 最小长度:0 最大长度:256 |
ibmmq_cipher_suite |
String |
IBMMQ密钥算法套件。 最小长度:0 最大长度:256 |
hdfs_path |
String |
HDFS URL,数据源为MRSHIVE、MRSHDFS类型时配置。 最小长度:0 最大长度:256 |
principal_name |
String |
机机交互用户名,数据源为MRSHIVE、MRSHDFS、MRSHBASE、MRSKAFKA、MRSREDIS类型时配置。 最小长度:0 最大长度:256 |
config_file_name |
String |
用户认证文件,文件获取方式参见API参考的“附录 > 获取数据源配置文件”章节。
最小长度:0 最大长度:256 |
config_file_content |
String |
用户认证文件内容,config_file_name对应的文件内容BASE64编码。 数据源为MRSHIVE、MRSHDFS、MRSHBASE、MRSKAFKA、MRSREDIS、MRSCLICKHOUSE类型时配置。 最小长度:0 最大长度:256 |
connection_instance_id |
String |
连接器实例ID,连接器发布后对应的实例ID。 最小长度:0 最大长度:256 |
connector_params |
Object |
连接器对应的数据源参数,值按实际填写。 |
参数 |
参数类型 |
描述 |
---|---|---|
oracle_address |
String |
ORACLE地址。 最小长度:1 最大长度:64 |
oracle_port |
String |
ORACLE端口。 最小长度:1 最大长度:10 |
参数 |
参数类型 |
描述 |
---|---|---|
auth_method |
String |
访问API服务的认证方式。
最小长度:0 最大长度:256 |
app_auth_type |
String |
访问API服务的APP认证方式,认证方式为(apiGateway)时填写。
最小长度:0 最大长度:2000 |
user_name |
String |
访问API服务的用户名。
最小长度:4 最大长度:2000 |
password |
String |
访问API服务的密码。 认证方式为(liHe、huaweiNetworkManagement、basicauth、secret、md5、hmac)时填写。 最小长度:4 最大长度:2000 |
app_key |
String |
访问API服务的AppKey。 认证方式为(apiGateway)时填写。 最小长度:0 最大长度:256 |
app_secret |
String |
访问API服务的AppSecret。 认证方式为(apiGateway)时填写。 最小长度:0 最大长度:256 |
secret |
String |
访问API服务的Secret。 认证方式为(keyTop、hikVision、secret、hamc、md5)时填写。 最小长度:0 最大长度:256 |
alt_ip |
String |
访问API服务的备用IP。 认证方式为(huaweiNetworkManagement)时填写。 最小长度:0 最大长度:256 |
access_token_url |
String |
访问API服务的AccessTokenUrl。 认证方式为(liHe、oauth2.0 huaweiNetworkManagement)时填写。 最小长度:0 最大长度:256 |
client_id |
String |
访问API服务的客户端标识。 认证方式为oauth2.0时填写。 最小长度:0 最大长度:256 |
client_id_key |
String |
访问API服务的客户端传参标识key。 认证方式为oauth2.0时填写,不填写默认为client_id。 缺省值:client_id 最小长度:0 最大长度:256 |
client_secret |
String |
访问API服务的客户端密钥。 认证方式为oauth2.0时填写。 最小长度:0 最大长度:256 |
client_secret_key |
String |
访问API服务的客户端密钥key。 认证方式为oauth2.0时填写,不填写默认为client_secret。 缺省值:client_secret 最小长度:0 最大长度:256 |
scope |
String |
访问API服务的Scope。 认证方式为(liHe、oauth2.0)时填写。 最小长度:0 最大长度:256 |
authorization |
String |
访问API服务的Authorization。 认证方式为(liHe)时填写。 最小长度:0 最大长度:256 |
grant_type |
String |
访问API服务的授权类型。
最小长度:0 最大长度:256 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 最小长度:8 最大长度:36 |
error_msg |
String |
错误描述。 最小长度:2 最大长度:512 |
detail |
String |
描述详情。 最小长度:2 最大长度:512 |
状态码: 404
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 最小长度:8 最大长度:36 |
error_msg |
String |
错误描述。 最小长度:2 最大长度:512 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 最小长度:8 最大长度:36 |
error_msg |
String |
错误描述。 最小长度:2 最大长度:512 |
请求示例
查询指定数据源详情
https://{{ServerHost}}/v2/c53626012ba84727b938ca8bf03108ef/fdi/instances/fae7ff6c-8e07-4cf8-9e67-589cab2f017c/datasources/acb3b4049bb643e39ca12a87a735b34d
响应示例
状态码: 200
OK
{ "datasource_id" : "acd5502992254b3ab2dfd5b6900159db", "datasource_name" : "TY_KAFKA", "datasource_type" : "KAFKA", "content" : { "project_id" : "c53626012ba84727b938ca8bf03108ef", "type" : "KAFKA", "instance_id" : "05173009-2e5f-4773-8303-8e05cc9c9302", "broker" : "10.01.01.01:9092", "ssl_username" : "1", "ssl_password" : "******", "ssl_enable" : true }, "create_time" : 1616784907101, "update_time" : 1619650507230, "app_id" : "141bbdf5-131e-4111-898d-5a6292a2113b", "app_name" : "app-zhe", "instance_id" : "05173009-2e5f-4773-8303-8e05cc9c9302", "remark" : "No change.", "app_permission" : [ "read", "access", "delete", "modify" ] }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Error response |
404 |
Not Found |
500 |
Internal Server Error |
错误码
请参见错误码。