调用ListDataSources接口,查询DataWorks数据源列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListDataSources |
系统规定参数。取值:ListDataSources。 |
ProjectId | Long | 是 | 1 |
数据源所在的DataWorks工作空间ID。您可以通过ListProjects接口获取工作空间ID。 |
Name | String | 否 | test |
查询的数据源名称。 |
DataSourceType | String | 否 | rds |
数据源的类型。常用的类型如下:
|
SubType | String | 否 | mysql |
数据源的子类型。仅当DataSourceType参数配置为RDS时,该参数生效。 当DataSourceType参数配置为RDS时,该参数可以配置为mysql、sqlserver或postgresql。 |
Status | String | 否 | ENABLED |
数据源的状态。取值如下:
|
EnvType | Integer | 否 | 1 |
数据源所属的环境,包括0(开发环境)和1(生产环境)。 |
PageSize | Integer | 否 | 10 |
每页显示的条数,默认为10条,最大为100条。 |
PageNumber | Integer | 否 | 1 |
分页查询的页码。取值为大于等于1的正整数。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
HttpStatusCode | Integer | 200 |
HTTP状态码。 |
RequestId | String | 0bc14115159376359**** |
请求ID。 |
Success | Boolean | true |
请求是否成功。 |
Data | Object |
数据源的查询结果。 |
|
PageNumber | Integer | 1 |
页码。 |
PageSize | Integer | 20 |
每页显示的条数,默认为10条,最大为100条。 |
TotalCount | Integer | 233 |
数据源的总数。 |
DataSources | Array of DataSources |
数据源列表。 |
|
Status | Integer | 1 |
数据源的状态。取值如下:
|
ProjectId | Integer | 123 |
数据源关联的工作空间ID。 |
SubType | String | mysql |
数据源的子类型。仅当DataSourceType参数配置为RDS时,该参数生效。 当DataSourceType参数配置为RDS时,该参数可以配置为mysql、sqlserver或postgresql。 |
GmtModified | String | Mar 17, 2021 4:09:32 PM |
修改数据源的时间。时间格式示例为Mar 17, 2021 4:09:32 PM。 |
EnvType | Integer | 1 |
数据源所在的环境。取值如下:
|
ConnectStatus | Integer | 1 |
数据源的状态。取值如下:
|
Sequence | Integer | 300 |
排序字段。数据源按此字段从大到小排序。 |
Description | String | a connection |
数据源的描述信息。 |
DataSourceType | String | rds |
数据源的类型。常用类型如下:
|
GmtCreate | String | Mar 17, 2021 4:09:32 PM |
创建数据源的时间。时间格式示例为Mar 17, 2021 4:09:32 PM。 |
DefaultEngine | Boolean | false |
数据源关联的引擎是否为同类型数据源选用的默认引擎。 |
Shared | Boolean | false |
是否为共享的数据源。 |
Operator | String | 193543050**** |
最近一次修改数据源的阿里云用户ID。 |
Name | String | abc |
数据源的名称。 |
Content | String | {“pubEndpoint”:”http://service.cn.maxcompute.aliyun.com/api”,”accessId”:”TMP.3KecGjvzy3i8MYfn2BGHgF7EHGyBFZcHm7GgngrABVRyvvKQrfF5kskR36xP361C3dqwbGo7SGYptAeGyiTwHXqLaBUvYC”,”securityToken”:null,”endpoint”:”http://service.cn.maxcompute.aliyun-inc.com/api”,”accessKey”:”***”,”name”:”PRE_PROJECT_A_engine”,”project”:”PRE_PROJECT_A”,”vpcEndpoint”:”http://service.cn.maxcompute.aliyun-inc.com/api”,”region”:”cn-shanghai”,”authType”:”2″} |
数据连接串的相关信息。格式为JSON格式。常用的数据源对应的连接串样例如下:
|
Id | Long | 1 |
数据源ID。 |
BindingCalcEngineId | Long | 123 |
数据源关联的计算引擎ID。 |
TenantId | Long | 1234567 |
租户ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=ListDataSources
&Name=test
&ProjectId=1
&RegionId=cn-shanghai
&
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
0bc14115159376359****
200
233
20
1
1
193543050****
1
mysql
a connection
123
123
Mar 17, 2021 4:09:32 PM
300
false
1
abc
false
1234567
Mar 17, 2021 4:09:32 PM
{"pubEndpoint":"http://service.cn.maxcompute.aliyun.com/api","accessId":"TMP.3KecGjvzy3i8MYfn2BGHgF7EHGyBFZcHm7GgngrABVRyvvKQrfF5kskR36xP361C3dqwbGo7SGYptAeGyiTwHXqLaBUvYC","securityToken":null,"endpoint":"http://service.cn.maxcompute.aliyun-inc.com/api","accessKey":"***","name":"PRE_PROJECT_A_engine","project":"PRE_PROJECT_A","vpcEndpoint":"http://service.cn.maxcompute.aliyun-inc.com/api","region":"cn-shanghai","authType":"2"}
rds
1
true
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "0bc14115159376359****",
"HttpStatusCode" : 200,
"Data" : {
"TotalCount" : 233,
"PageSize" : 20,
"PageNumber" : 1,
"DataSources" : {
"Status" : 1,
"Operator" : "193543050****",
"ConnectStatus" : 1,
"SubType" : "mysql",
"Description" : "a connection",
"BindingCalcEngineId" : 123,
"ProjectId" : 123,
"GmtModified" : "Mar 17, 2021 4:09:32 PM",
"Sequence" : 300,
"Shared" : false,
"EnvType" : 1,
"Name" : "abc",
"DefaultEngine" : false,
"TenantId" : 1234567,
"GmtCreate" : "Mar 17, 2021 4:09:32 PM",
"Content" : "{\"pubEndpoint\":\"http://service.cn.maxcompute.aliyun.com/api\",\"accessId\":\"TMP.3KecGjvzy3i8MYfn2BGHgF7EHGyBFZcHm7GgngrABVRyvvKQrfF5kskR36xP361C3dqwbGo7SGYptAeGyiTwHXqLaBUvYC\",\"securityToken\":null,\"endpoint\":\"http://service.cn.maxcompute.aliyun-inc.com/api\",\"accessKey\":\"***\",\"name\":\"PRE_PROJECT_A_engine\",\"project\":\"PRE_PROJECT_A\",\"vpcEndpoint\":\"http://service.cn.maxcompute.aliyun-inc.com/api\",\"region\":\"cn-shanghai\",\"authType\":\"2\"}",
"DataSourceType" : "rds",
"Id" : 1
}
},
"Success" : true
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | Invalid.Tenant.ConnectionNotExists | The connection does not exist. | 数据源不存在。 |
400 | Invalid.Tenant.ProjectNotExists | The project does not exist. | 项目不存在。 |
400 | Invalid.Tenant.UserNotInProject | The user is not in the project. | 用户不在项目中。 |
403 | Invalid.Tenant.UserIsNotProjectOwnerOrAdmin | The user is not a project administrator or owner. | 用户不是项目负责人或者项目管理员。 |
403 | Invalid.Tenant.UserNotInTenant | The user is not in tenant. | 用户不在租户中。 |
访问错误中心查看更多错误码。
内容没看懂? 不太想学习?想快速解决? 有偿解决: 联系专家
阿里云企业补贴进行中: 马上申请
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利:同意关联,立享优惠
转转请注明出处:https://www.yunxiaoer.com/170997.html