# 获取数据源列表 - ListDatasources
#### 功能介绍
功能介绍：查询已添加的异常数据源审计实例列表，支持按类型筛选并分页返回，返回数据源ID、名称、类型、创建时间、审计条件、运行状态等。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dsc/dsc_02_0008.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dsc/dsc_02_0031.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
GET /v1/{project_id}/sdg/risk/datasource
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释：** 项目ID。可参考获取项目ID获取。 **约束限制：** 满足正则匹配"\^\[a-z0-9\]{32}$"，即32位小写字母和数字组合。 **取值范围：** 以IAM服务接口返回值为准，由数字和字母组成，长度为32个字符。 **默认取值：** 不涉及 |
   
表2Query参数 
| 参数   | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| 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等） **取值范围：** 不涉及 |
   
 表5ExceptionDatasource 
| 参数          | 参数类型             | 描述                                                                                                                                                                           |
|:---|:---|:---|
| 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 | 查询成功 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dsc/ErrorCode.html)。
