ListDataSources - 获取数据源列表

根据数据源业务信息,查询符合的数据源列表。

接口说明

  1. 需要购买 DataWorks 基础版及以上版本才能使用。
  2. 需要在 DataWorks 项目空间中具有如下至少一种角色:
  • 租户所有者、空间管理员、部署、开发、访客、项目所有者、运维、模型设计师、安全管理员、数据分析师、开发平台管理员、数据治理管理员

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
dataworks:ListDataSourcesget
*全部资源
*

请求参数

名称类型必填描述示例值
ProjectIdlong

DataWorks 工作空间的 ID。您可以登录 DataWorks 控制台,进入工作空间配置页面获取工作空间 ID。

该参数用来确定本次 API 调用操作使用的 DataWorks 工作空间。

17820
Namestring

数据源名称,基于此名称做模糊查询。

test
Typesarray

数据源类型查询过滤,可以配置多个类型查询过滤。

string

数据源的类型。

mysql
EnvTypestring

数据源环境类型,枚举值:

  • Dev:开发环境
  • Prod:生产环境
Prod
PageNumberinteger

查询第几页,默认值为 1 表示第一页。

1
PageSizeinteger

分页大小,默认值为 10,最大值 100。

10
SortBystring

数据源列表排序字段,支持名称、创建时间、数据源 ID 排序

  • CreateTime:创建时间
  • Id:数据源 ID
  • Name:数据源名称

默认值:CreateTime

CreateTime
Orderstring

数据源列表排序方向,枚举值:

  • Desc:倒序
  • Asc:正序

默认值:Desc

Desc
Tagsstring

数据源可以打标签,基于标签做数据源查询过滤:

  • 多个值之间是“且”的关系,比如["tag1", "tag2", "tag3"]底层查询同时有这 3 个标签打标的数据源列表。
  • 不传递,或者传递为空表示不作 tag 过滤,查询最多支持 10 个标签。
["tag1", "tag2", "tag3"]

返回参数

名称类型描述示例值
object

返回结果。

RequestIdstring

请求 ID。用于定位日志,排查问题。

7BE1433F-6D55-5D86-9344-CA6F7DD19B13
PagingInfoobject

分页信息。

TotalCountlong

总条数。

131
PageSizelong

页大小。

10
PageNumberlong

页码。

1
DataSourcesarray<object>

数据源列表,每一个元素是一个数据源组,包含开发环境(如有)和生产环境的信息。

array<DataSource>object

数据源组信息,包含开发环境(如有)和生产环境的数据源。开发环境和生产环境的数据源具有相同的数据源名称和数据源类型,不相同的数据源 ID。

Namestring

数据源的名称。

test
Typestring

数据源类型。

mysql
DataSourcearray<object>

数据源列表,每个元素是单个数据源信息,具有唯一的数据源 ID。

DataSourceobject

单条数据源信息。

Idlong

数据源 ID,数据源的唯一标识符。

16035
ConnectionPropertiesany

数据源的具体连接配置信息,包括连接地址、访问身份、环境信息等。数据源环境 envType 信息是此对象的成员属性,包括

  • Dev(开发环境)
  • Prod(生产环境)

不同类型的数据源在不同的配置模式(ConnectionPropertiesMode)下具有不同的属性信息规范,请参考数据源连接信息 ConnectionProperties

{ "envType": "Prod", "regionId": "cn-beijing", "instanceId": "hgprecn-cn-x0r3oun4k001", "database": "testdb", "securityProtocol": "authTypeNone", "authType": "Executor", "authIdentity": "1107550004253538" }
ConnectionPropertiesModestring

数据源添加的类别,不同 type 下会有不同的子类型,对应有不同的参数约束,场景举例:

  • InstanceMode 实例模式。
  • UrlMode 连接串模式。
UrlMode
Descriptionstring

数据源的描述信息。

test
CreateTimelong

数据源的创建时间(时间戳)。

1648711113000
CreateUserstring

数据源的创建者 ID。

1624387842781448
ModifyTimelong

数据源的最近修改时间(时间戳)。

1648711113000
ModifyUserstring

数据源的修改者 ID。

1624387842781448
QualifiedNamestring

数据源的业务唯一键,以 holo 举例格式是${tenantOwnerId}:${regionId}:${type}:${instanceId}:${database}

1648711121000:cn-beijing:odps:yongxunQA_beijing_standard

示例

正常返回示例

JSON格式

{
  "RequestId": "7BE1433F-6D55-5D86-9344-CA6F7DD19B13",
  "PagingInfo": {
    "TotalCount": 131,
    "PageSize": 10,
    "PageNumber": 1,
    "DataSources": [
      {
        "Name": "test",
        "Type": "mysql",
        "DataSource": [
          {
            "Id": 16035,
            "ConnectionProperties": "{\n\t\"envType\": \"Prod\",\n\t\"regionId\": \"cn-beijing\",\n    \"instanceId\": \"hgprecn-cn-x0r3oun4k001\",\n    \"database\": \"testdb\",\n    \"securityProtocol\": \"authTypeNone\",\n    \"authType\": \"Executor\",\n    \"authIdentity\": \"1107550004253538\"\n}",
            "ConnectionPropertiesMode": "UrlMode",
            "Description": "test ",
            "CreateTime": 1648711113000,
            "CreateUser": "1624387842781448",
            "ModifyTime": 1648711113000,
            "ModifyUser": "1624387842781448",
            "QualifiedName": "1648711121000:cn-beijing:odps:yongxunQA_beijing_standard"
          }
        ]
      }
    ]
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
暂无变更历史