# 查询大数据资产列表 - ListBigdata
#### 功能介绍
功能介绍：查询大数据资产列表
#### 调用方法
请参见[如何调用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/asset/bigdata
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释：** 项目ID。可参考获取项目ID获取。 **约束限制：** 不涉及 **取值范围：** 以IAM服务接口返回值为准，字符长度32-32。 **默认取值：** 不涉及 |
   
表2Query参数 
| 参数               | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|
| type             | 否    | String | **参数解释：** 大数据类型 **约束限制：** 不涉及 **取值范围：** - Elasticsearch-Elasticsearch搜索引擎   - DLI-数据湖探索   - Hive-Hive数据仓库   - HBase-HBase数据库   - MRS_HIVE-MRS Hive数据仓库   - ALL-全部   - LTS-日志服务   - HIVE_ONLY-仅Hive   - JUST_BIG_DATA-仅大数据    **默认取值：** JUST_BIG_DATA |
| owner_account_id | 否    | String | **参数解释：** 拥有者账号ID **约束限制：** 不涉及 **取值范围：** 1到256个字符 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。通过调用IAM服务查询用户Token接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 不涉及 **取值范围：** IAM服务查询用户Token接口为准 **默认取值：** 不涉及 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数          | 参数类型                                                                       | 描述                                                                                                                         |
|:---|:---|:---|
| total       | Integer                                                                    | **参数解释：** 总记录数 **取值范围：** 不涉及  |
| datasources | Array of [BigdataResponse] objects | **参数解释：** 数据源列表 **取值范围：** 不涉及 |
   
 表5BigdataResponse 
| 参数                        | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|
| id                        | String  | **参数解释：** 资源ID，唯一标识 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ds_type                   | String  | **参数解释：** 数据源类型 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ds_address                | String  | **参数解释：** 数据源IP地址 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ds_port                   | Integer | **参数解释：** 数据源端口 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ds_name                   | String  | **参数解释：** 数据源名称 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ds_user                   | String  | **参数解释：** 数据源用户名 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ds_authorized             | String  | **参数解释：** 数据源授权状态 **取值范围：** - CHECKING-检查中   - SUCCESS-成功   - ACTIVE-激活   - FAILED-失败                                                                                                                                                                           |
| ds_version                | String  | **参数解释：** 数据源版本 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| region                    | String  | **参数解释：** 区域 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ins_type                  | String  | **参数解释：** 来源类型 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ins_id                    | String  | **参数解释：** 子网ID **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ins_name                  | String  | **参数解释：** 资产名称 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| asset_name                | String  | **参数解释：** 资产名称 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| create_time               | Long    | **参数解释：** 创建时间 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| authorize_fail_reason     | String  | **参数解释：** 授权错误原因 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| vpc_id                    | String  | **参数解释：** 虚拟私有云ID **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| subnet_id                 | String  | **参数解释：** 子网ID **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| security_group_id         | String  | **参数解释：** 安全组ID **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| source_type               | String  | **参数解释：** 来源类型 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| authorized                | Boolean | **参数解释：** 是否已授权 **取值范围：** true-是，false-否                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| default                   | Boolean | **参数解释：** 是否默认 **取值范围：** true-是，false-否                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| account_name              | String  | **参数解释：** 大数据响应名称 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| owner_account_id          | String  | **参数解释：** 拥有者账号ID **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| owner_project_id          | String  | **参数解释：** 大数据响应ID **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| metadata_task_name        | String  | **参数解释：** 元数据任务名称 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| metadata_task_status      | String  | **参数解释：** 元数据任务状态 **取值范围：** - SCHEDULED-已调度   - PROCESSING-处理中   - PARTIAL-部分完成   - FINISHED-已完成   - FAILED-失败    |
| metadata_task_create_time | Long    | **参数解释：** 元数据任务创建时间 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   
#### 请求示例
查询大数据资产列表
```
/v1/2b31ed520xxxxxxebedb6e57xxxxxxxx/sdg/asset/bigdata
```
#### 响应示例
**状态码：200**
```
{
  "total" : 2,
  "datasources" : [ {
    "id" : "0cfd1d3e-2c4a-4d1f-8e2b-9a3c4d5e6f70",
    "ds_type" : "MYSQL",
    "ds_address" : "192.168.1.100",
    "ds_port" : 3306,
    "ds_name" : "mysql-datasource-01",
    "ds_user" : "asset-admin",
    "ds_authorized" : "SUCCESS",
    "ds_version" : "1.0.0",
    "region" : "cn-north-4",
    "ins_type" : "RDS",
    "ins_id" : "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "ins_name" : "rds-instance-01",
    "asset_name" : "asset-db-01",
    "create_time" : 1700000000000,
    "authorize_fail_reason" : "asset-value-01",
    "vpc_id" : "f7e6d5c4-b3a2-1908-7f6e-5d4c3b2a1908",
    "subnet_id" : "3a7b8c9d-0e1f-2a3b-4c5d-6e7f8a9b0c1d",
    "security_group_id" : "826314dd-1b5b-4037-b976-5f9b7a17df46",
    "source_type" : "DATABASE",
    "authorized" : true,
    "default" : true,
    "account_name" : "account-resource-01",
    "owner_account_id" : "0cfd1d3e-2c4a-4d1f-8e2b-9a3c4d5e6f70",
    "owner_project_id" : "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "metadata_task_name" : "metadata_task-resource-01",
    "metadata_task_status" : "FINISHED",
    "metadata_task_create_time" : 1700000000000
  }, {
    "id" : "1d0e2e4f-3d5b-5e2f-9f3c-0b4d5e6f7a81",
    "ds_type" : "POSTGRESQL",
    "ds_address" : "192.168.1.101",
    "ds_port" : 5432,
    "ds_name" : "pg-datasource-02",
    "ds_user" : "asset-admin",
    "ds_authorized" : "SUCCESS",
    "ds_version" : "1.0.0",
    "region" : "cn-north-4",
    "ins_type" : "RDS",
    "ins_id" : "b2c3d4e5-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
    "ins_name" : "rds-instance-02",
    "asset_name" : "asset-db-02",
    "create_time" : 1700000001000,
    "authorize_fail_reason" : "asset-value-02",
    "vpc_id" : "e8f7c6d5-c4b3-a219-8f7e-6d5c4b3a2191",
    "subnet_id" : "4b8c9d0e-1f2a-3b4c-5d6e-7f8a9b0c1d2e",
    "security_group_id" : "937425ee-2c6c-5148-c087-6f0c8b28ef57",
    "source_type" : "DATABASE",
    "authorized" : true,
    "default" : false,
    "account_name" : "account-resource-02",
    "owner_account_id" : "1d0e2e4f-3d5b-5e2f-9f3c-0b4d5e6f7a81",
    "owner_project_id" : "b2c3d4e5-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
    "metadata_task_name" : "metadata_task-resource-02",
    "metadata_task_status" : "FINISHED",
    "metadata_task_create_time" : 1700000001000
  } ]
}
```
#### 状态码
| 状态码 | 描述    |
|:---|:---|
| 200 | 请求已成功 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dsc/ErrorCode.html)。
