查询数据库列表-九游平台

功能介绍

查询指定实例中的数据库。

• 调用接口前，您需要了解api 。

调试

您可以在中调试该接口。

接口约束

• 实例在异常或冻结状态下不能执行该操作。
• 不支持查询只读实例的数据库列表。

uri

• uri格式

  get /v3/{project_id}/instances/{instance_id}/database/detail?page={page}&limit={limit}&db-name={db-name}&recover_model={recover_model}

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一region下的项目id。 获取方法请参见。
  instance_id	是	实例id。
  page	是	分页页码，从1开始。
  limit	是	每页数据条数。取值范围[1, 100]。
  db-name	否	数据库名。当指定该参数时，page和limit参数需要传入但不生效。
  recover_model	否	数据库恢复健康模式。取值： full：完整模式。 simple：简单模式。 bulk_logged：大容量日志恢复模式。

请求消息

• 请求参数

  无。

• uri样例

  get https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/a8abe84a41364097be7c233c39275087in04/database/detail?page=1&limit=10&db-name=testdb1

响应消息

• 正常响应要素说明

  表2 要素说明

  名称	参数类型	说明
  databases	array of objects	列表中每个元素表示一个数据库。 详情请参见表3。
  total_count	integer	数据库总数。

  表3 databases元素结构说明

  名称	参数类型	说明
  name	string	数据库名称。
  character_set	string	数据库使用的字符集，例如chinese_prc_ci_as等。
  state	string	数据库状态。取值如下： creating：表示创建中。 running：表示使用中。 deleting：表示删除中。 notexists：表示不存在。

• 正常响应样例

  {
      "databases": [
          {
              "name": "master",
              "character_set": "chinese_prc_ci_as",
              "state": "running"
          },
          {
              "name": "msdb",
              "character_set": "chinese_prc_ci_as",
              "state": "running"
          },
          {
              "name": "model",
              "character_set": "chinese_prc_ci_as",
              "state": "running"
          },
          {
              "name": "tempdb",
              "character_set": "chinese_prc_ci_as",
              "state": "running"
          },
          {
              "name": "rdsadmin",
              "character_set": "chinese_prc_ci_as",
              "state": "running"
          },
          {
              "name": "rds-test",
              "character_set": "chinese_prc_ci_as",
              "state": "running"
          }
      ],
      "total_count": 6
  }

• 异常响应

  请参见。

状态码

• 正常

  200

• 异常

  请参见。

错误码

请参见。