文档首页/ 数据安全中心 DSC/ API参考/ API/ 资产发现与管理/ 资产中心查询数据库实例下的数据库 - ShowDatabaseInstancesDatabases
更新时间：2026-10-09 GMT+08:00
在线调试
CLI示例
查看PDF
分享

资产中心查询数据库实例下的数据库 - ShowDatabaseInstancesDatabases

功能介绍

功能介绍：资产中心查询数据库实例下的数据库

调用方法

请参见如何调用API。

授权信息

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

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

URI

GET /v1/{project_id}/asset-center/database/instances/{instance_id}/databases

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

以IAM服务接口返回值为准，字符长度32-32。

默认取值：

不涉及

instance_id

是

String

参数解释：

子网ID

约束限制：

不涉及

取值范围：

1到64个字符

默认取值：

不涉及
表2 Query参数

参数

是否必选

参数类型

描述

type

是

String

参数解释：

数据库类型

约束限制：

不涉及

取值范围：

1到256个字符

默认取值：

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

IAM服务查询用户Token接口为准

默认取值：

不涉及

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

total

Integer

参数解释：

总记录数

取值范围：

不涉及

databases

Array of DBResponse objects

参数解释：

数据库

取值范围：

不涉及
表5 DBResponse

参数

参数类型

描述

id

String

参数解释：

资源ID，唯一标识

取值范围：

不涉及

db_type

String

参数解释：

数据库类型

取值范围：

不涉及

db_address

String

参数解释：

数据库地址

取值范围：

不涉及

db_port

Integer

参数解释：

数据库端口

取值范围：

不涉及

db_name

String

参数解释：

数据库名称

取值范围：

不涉及

db_user

String

参数解释：

数据库用户

取值范围：

不涉及

auth_type

String

参数解释：

只读用户、读写用户

取值范围：

  • READONLY-只读

  • READWRITE-读写

db_authorized

String

参数解释：

数据库已授权

取值范围：

  • CHECKING-检查中

  • SUCCESS-成功

  • ACTIVE-运行中

  • FAILED-失败

db_version

String

参数解释：

数据库版本

取值范围：

不涉及

region

String

参数解释：

区域

取值范围：

不涉及

ins_type

String

参数解释：

数据库响应类型

取值范围：

不涉及

ins_id

String

参数解释：

数据库响应ID

取值范围：

不涉及

ins_name

String

参数解释：

资产名称

取值范围：

不涉及

asset_name

String

参数解释：

资产名称

取值范围：

不涉及

create_time

Long

参数解释：

创建时间

取值范围：

不涉及

authorize_fail_reason

String

参数解释：

授权失败原因

取值范围：

不涉及

service_name

String

参数解释：

数据库响应名称

取值范围：

不涉及

authorized

Boolean

参数解释：

是否已授权

取值范围：

true-是，false-否

default

Boolean

参数解释：

是否默认

取值范围：

true-是，false-否

vpc_ids

Array of strings

参数解释：

VPC ID列表

取值范围：

不涉及

sid

String

参数解释：

会话ID

取值范围：

不涉及

subnet_ids

Array of strings

参数解释：

子网ID列表

取值范围：

不涉及

account_name

String

参数解释：

数据库响应名称

取值范围：

不涉及

owner_account_id

String

参数解释：

拥有者账号ID

取值范围：

不涉及

owner_project_id

String

参数解释：

数据库响应ID

取值范围：

不涉及

cidr

String

参数解释：

CIDR网段

取值范围：

不涉及

cidr_ipv6

String

参数解释：

IPv6无类别域际路由（CIDR）

取值范围：

不涉及

metadata_task_name

String

参数解释：

元数据任务名称

取值范围：

不涉及

metadata_task_status

String

参数解释：

元数据任务状态

取值范围：

  • SCHEDULED-已调度

  • PROCESSING-处理中

  • PARTIAL-部分完成

  • FINISHED-已完成

  • FAILED-失败

metadata_task_create_time

Long

参数解释：

元数据任务创建时间

取值范围：

不涉及

请求示例

资产中心查询数据库实例下的数据库

/v1/2b31ed520xxxxxxebedb6e57xxxxxxxx/asset-center/database/instances/xxxx-xxxx-xxxx-xxxx/databases

响应示例

状态码：200

{
  "total" : 1,
  "databases" : [ {
    "id" : "f7e6d5c4-b3a2-1908-7f6e-5d4c3b2a1908",
    "db_type" : "MySQL",
    "db_address" : "192.168.1.100",
    "db_port" : 3306,
    "db_name" : "asset-db-01",
    "db_user" : "asset-admin",
    "auth_type" : "READWRITE",
    "db_authorized" : "SUCCESS",
    "db_version" : "1.0.0",
    "region" : "cn-north-4",
    "ins_type" : "RDS",
    "ins_id" : "3a7b8c9d-0e1f-2a3b-4c5d-6e7f8a9b0c1d",
    "ins_name" : "rds-instance-01",
    "asset_name" : "asset-db-01",
    "create_time" : 1700000000000,
    "authorize_fail_reason" : "asset-value-01",
    "service_name" : "service-resource-01",
    "authorized" : true,
    "default" : true,
    "vpc_ids" : [ "826314dd-1b5b-4037-b976-5f9b7a17df46", "0cfd1d3e-2c4a-4d1f-8e2b-9a3c4d5e6f70" ],
    "sid" : "asset-value-01",
    "subnet_ids" : [ "0cfd1d3e-2c4a-4d1f-8e2b-9a3c4d5e6f70", "0cfd1d3e-2c4a-4d1f-8e2b-9a3c4d5e6f70" ],
    "account_name" : "account-resource-01",
    "owner_account_id" : "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "owner_project_id" : "f7e6d5c4-b3a2-1908-7f6e-5d4c3b2a1908",
    "cidr" : "asset-value-01",
    "cidr_ipv6" : "asset-value-01",
    "metadata_task_name" : "metadata_task-resource-01",
    "metadata_task_status" : "FINISHED",
    "metadata_task_create_time" : 1700000000000
  } ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码。

父主题： 资产发现与管理

相关文档