文档首页/ 数据安全中心 DSC/ API参考/ API/ 风险评估/ 获取数据源列表 - ListDatasources
更新时间:2026-10-20 GMT+08:00
分享

获取数据源列表 - ListDatasources

功能介绍

功能介绍:查询已添加的异常数据源审计实例列表,支持按类型筛选并分页返回,返回数据源ID、名称、类型、创建时间、审计条件、运行状态等。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v1/{project_id}/sdg/risk/datasource

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID。可参考获取项目ID获取。

约束限制:

满足正则匹配"^[a-z0-9]{32}$",即32位小写字母和数字组合。

取值范围:

以IAM服务接口返回值为准,由数字和字母组成,长度为32个字符。

默认取值:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

size

否

Integer

参数解释:

每页返回的数据源记录数量,单位为条(分页每页返回的记录数量)

约束限制:

不涉及

取值范围:

不涉及

默认取值:

10

page

否

Integer

参数解释:

分页页码,表示当前请求获取数据源列表的页码,从0开始

约束限制:

不涉及

取值范围:

不涉及

默认取值:

0

type

否

String

参数解释:

数据源类型,用于指定查询的数据源类别(如OBS、DBSS、DLP等),可按指定类型进行过滤

约束限制:

最大长度65535字符

取值范围:

不涉及

默认取值:

%(表示查询所有数据源类型)

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token。通过调用IAM服务查询用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

total

Integer

参数解释:

总记录数

取值范围:

不涉及

datasource

Array of ExceptionDatasource objects

参数解释:

异常数据源列表,数组中的每个元素为一个ExceptionDatasource对象,包含异常数据源的详细信息(如id、name、type、status、message等)

取值范围:

不涉及

表5 ExceptionDatasource

参数

参数类型

描述

id

String

参数解释:

资源ID,唯一标识

取值范围:

不涉及

name

String

参数解释:

异常数据源名称

取值范围:

不涉及

type

String

参数解释:

异常数据源类型

取值范围:

不涉及

create_time

Long

参数解释:

创建时间,为Unix时间戳,单位为毫秒,表示该异常数据源的创建时间点

取值范围:

不涉及

condition

Array of strings

参数解释:

查询条件列表,数组中的每个元素为一个查询条件字符串,用于描述该异常数据源的审计过滤条件

取值范围:

不涉及

status

String

参数解释:

操作结果状态

取值范围:

不涉及

message

String

参数解释:

操作结果消息,用于描述异常数据源的运行状态信息或异常情况说明

取值范围:

不涉及

请求示例

获取异常数据源审计实例列表

/v1/2b31ed520aabbccddeedb6e5712345678/sdg/risk/datasource?size=10&page=0&type=RDS

响应示例

状态码:200

{
  "total" : 2,
  "datasource" : [ {
    "id" : "ds-0b02392f3d0042bd8f80376485d9b7d8",
    "name" : "finance-rds-instance",
    "type" : "RDS",
    "create_time" : 1787306400000,
    "condition" : [ "SELECT * FROM sensitive_data", "UPDATE accounts SET balance" ],
    "status" : "RUNNING",
    "message" : "数据源审计正常运行"
  }, {
    "id" : "ds-0b02392f3d0042bd8f80376485d9b7d8",
    "name" : "finance-obs-bucket",
    "type" : "OBS",
    "create_time" : 1787306400000,
    "condition" : [ "SELECT * FROM sensitive_data", "UPDATE accounts SET balance" ],
    "status" : "RUNNING",
    "message" : "数据源审计正常运行"
  } ]
}

状态码

状态码

描述

200

查询成功

错误码

请参见错误码。

相关文档