文档首页/ 云数据库 GaussDB(for MySQL)/ API参考/ API（即将下线）/ 实例管理/ 批量查询实例详情
更新时间：2024-04-01 GMT+08:00
在线调试
CLI示例
查看PDF
分享

批量查询实例详情

功能介绍

批量查询实例详情。

该接口计划于2025-03-31下线。

URI

GET /v3/{project_id}/instances/details

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一Region下的project ID。

获取方法请参见获取项目ID。
表2 Query参数

参数

是否必选

参数类型

描述

instance_ids

是

String

实例ID。最多同时输入20个实例ID，用英文逗号分隔。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取。

请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

X-Language

否

String

请求语言类型。默认en-us。

取值范围：

  • en-us
  • zh-cn

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

instances

Array of MysqlInstanceInfoDetail objects

实例详情。
表5 MysqlInstanceInfoDetail

参数

参数类型

描述

id

String

实例ID。

name

String

创建的实例名称。

project_id

String

租户在某一Region下的project ID。

status

String

实例状态。

取值范围：

  • BUILD：实例正在创建。
  • ACTIVE：实例正常。
  • FAILED：实例创建失败。
  • FROZEN：实例冻结。
  • MODIFYING：实例正在扩容。
  • REBOOTING：实例正在重启。
  • RESTORING：实例正在恢复。
  • SWITCHOVER：实例正在主备切换。
  • MIGRATING：实例正在迁移。
  • BACKING UP：实例正在进行备份。
  • MODIFYING DATABASE PORT：实例正在修改数据库端口。
  • STORAGE FULL：实例磁盘空间满。

port

String

数据库端口号。

alias

String

实例备注

type

String

实例类型，取值为“Cluster”。

charge_info

MysqlInstanceChargeInfo object

计费类型信息，支持包年包月和按需，默认为按需。

node_count

Integer

节点个数。

datastore

MysqlDatastoreWithKernelVersion object

数据库信息。

backup_used_space

Double

备份空间使用大小，单位为GB。

created

String

创建时间，格式为"yyyy-mm-ddThh:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。

说明：

创建时返回值为空，数据库实例创建成功后该值不为空。

updated

String

更新时间，格式与"created"字段对应格式完全相同。

说明：

创建时返回值为空，数据库实例创建成功后该值不为空。

private_write_ips

Array of strings

实例的写内网IP。

private_dns_names

Array of strings

实例内网域名列表。实例创建成功后，需要手动申请内网域名，否则查询内网域名为空。

public_ips

String

实例的公网IP。

db_user_name

String

默认用户名。

vpc_id

String

虚拟私有云ID。

subnet_id

String

子网的网络ID信息。

security_group_id

String

安全组ID。

configuration_id

String

实例创建的模板ID，或者应用到实例的最新参数组模板ID。

backup_strategy

MysqlBackupStrategy object

自动备份策略。

nodes

Array of MysqlInstanceNodeInfo objects

节点信息。

enterprise_project_id

String

企业项目ID。

time_zone

String

时区。

az_mode

String

可用区模式。

取值范围：

  • single：单可用区。
  • multi：多可用区。

master_az_code

String

主可用区。

maintenance_window

String

可维护时间窗，为UTC时间。

tags

Array of MysqlTags objects

实例标签。

dedicated_resource_id

String

专属资源池ID，只有数据库实例属于专属资源池才会返回该参数。

proxies

Array of MysqlProxyInfo objects

数据库代理信息。
表6 MysqlInstanceChargeInfo

参数

参数类型

描述

charge_mode

String

计费模式。

order_id

String

订单号。
表7 MysqlDatastoreWithKernelVersion

参数

参数类型

描述

type

String

数据库引擎，仅支持gaussdb-mysql。

version

String

数据库版本。

数据库支持的详细版本信息，可通过查询数据库引擎的版本获取。

kernel_version

String

数据库内核版本。
表8 MysqlBackupStrategy

参数

参数类型

描述

start_time

String

自动备份开始时间段。自动备份将在该时间一个小时内触发。

取值范围：非空，格式必须为hh:mm-HH:MM且有效，当前时间指UTC时间。

  1. HH取值必须比hh大1。
  2. mm和MM取值必须相同，且取值必须为00。

keep_days

String

自动备份保留天数，取值范围：1-732
表9 MysqlInstanceNodeInfo

参数

参数类型

描述

id

String

实例ID。

name

String

节点名称。

type

String

节点类型。

取值范围：

  • master：主节点。
  • slave：只读节点。

status

String

节点状态。

port

Integer

数据库端口号。

private_read_ips

Array of strings

节点的读内网地址。

volume

MysqlInstanceNodeVolumeInfo object

存储盘信息。

az_code

String

可用区。

region_code

String

实例所在的区域。

created

String

创建时间，格式为"yyyy-mm-ddThh:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。

说明：

创建时返回值为空，数据库实例创建成功后该值不为空。

updated

String

更新时间，格式与"created"字段对应格式完全相同。

说明：

创建时返回值为空，数据库实例创建成功后该值不为空。

flavor_id

String

规格ID。

flavor_ref

String

规格码。

max_connections

String

允许的最大连接数。

vcpus

String

CPU核数。

ram

String

内存大小，单位为GB。

need_restart

Boolean

是否需要重启使修改的参数生效。

priority

Integer

主备倒换优先级。
表10 MysqlInstanceNodeVolumeInfo

参数

参数类型

描述

type

String

磁盘类型。

used

String

已使用磁盘大小，单位GB。

size

Long

包周期购买的存储空间大小，单位GB。
表11 MysqlTags

参数

参数类型

描述

key

String

标签键。最大长度36个unicode字符。 key不能为空或者空字符串，不能为空格。 字符集：A-Z，a-z ，0-9，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。

value

String

标签值。最大长度43个unicode字符。 可以为空字符串。 字符集：A-Z，a-z ，0-9，‘.’，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。
表12 MysqlProxyInfo

参数

参数类型

描述

pool_id

String

数据库代理实例ID。

name

String

数据库代理实例名称。

address

String

数据库代理读写分离地址。

状态码： 400

表13 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

状态码： 500

表14 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

请求示例

批量查询实例信息。

GET https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/instances/details?instance_ids=436aaafb689c4250a9a5bb33cb271e8cin07,d738399de028480fabb2b8120d4e01a4in07

响应示例

状态码： 200

Success.

{
  "instances" : [ {
    "id" : "d738399de028480fabb2b8120d4e01a4in07",
    "name" : "gaussdb-mysql-instance01",
    "alias" : "",
    "status" : "ACTIVE",
    "project_id" : "3cedfc54-b105-4652-a4e0-847b11576628",
    "enterprise_project_id" : 0,
    "type" : "Cluster",
    "charge_info" : {
      "charge_mode" : "postPaid",
      "order_id" : ""
    },
    "node_count" : 2,
    "datastore" : {
      "type" : "gaussdb-mysql",
      "version" : "8.0",
      "kernel_version" : "2.0.29.1"
    },
    "created" : "2022-07-14T16:26:58+0800",
    "updated" : "2022-07-18T14:20:33+0800",
    "public_ips" : [ "10.154.219.187" ],
    "private_write_ips" : [ "192.168.0.142" ],
    "private_dns_names" : [ "11684a0e59e94bceba7880d58cfb07b5in07.internal.cn-xianhz-1.gaussdbformysql.myhuaweicloud.com" ],
    "db_user_name" : "root",
    "port" : 3306,
    "vpc_id" : "3cedfc54-b105-4652-a4e0-847b11576b58",
    "subnet_id" : "c1cfa53c-65d3-431e-8552-326bf310c7ad",
    "security_group_id" : "fc577a1a-f202-424a-977f-24faec3fdd55",
    "backup_strategy" : {
      "start_time" : "19:00-20:00",
      "keep_days" : 7
    },
    "nodes" : [ {
      "id" : "799a0f2fa49a4151bf9f7063c1fbba36no07",
      "name" : "gauss-d616-lb07_node01",
      "type" : "master",
      "status" : "ACTIVE",
      "port" : 3306,
      "private_read_ips" : [ "192.168.0.163" ],
      "volume" : {
        "type" : "POOL",
        "used" : 0.07
      },
      "az_code" : "az1xahz",
      "region_code" : "cn-xianhz-1",
      "flavor_id" : "3169caaf-6c2f-41d5-aadd-c8fc3d83597e",
      "flavor_ref" : "gaussdb.mysql.xlarge.x86.4",
      "max_connections" : 1500,
      "vcpus" : 4,
      "ram" : 16,
      "need_restart" : false,
      "priority" : 1,
      "created" : "2022-07-14T16:26:58+0800",
      "updated" : "2022-07-18T09:24:18+0800"
    }, {
      "id" : "799a0f2fa49a4151bf9f7063c1fbba35no07",
      "name" : "gauss-d616-lb07_node02",
      "type" : "slave",
      "status" : "ACTIVE",
      "port" : 3306,
      "private_read_ips" : [ "192.168.0.162" ],
      "volume" : {
        "type" : "POOL",
        "used" : 0.07
      },
      "az_code" : "az1xahz",
      "region_code" : "cn-xianhz-1",
      "flavor_id" : "3169caaf-6c2f-41d5-aadd-c8fc3d83597e",
      "flavor_ref" : "gaussdb.mysql.xlarge.x86.4",
      "max_connections" : 1500,
      "vcpus" :4,
      "ram" : 16,
      "need_restart" : false,
      "priority" : 1,
      "created" : "2022-07-14T16:26:58+0800",
      "updated" : "2022-07-18T09:36:18+0800"
    } ],
    "time_zone" : "UTC+08:00",
    "backup_used_space" : 0.24,
    "az_mode" : "single",
    "master_az_code" : "az1",
    "maintenance_window" : "18:00-22:00",
    "tags" : [ ],
    "configuration_id" : "53570e0de54e40c5a15f331aa5sd2176pr07",
    "dedicated_resource_id" : "",
    "proxies" : [ {
      "pool_id" : "dab1cfc5150c4d1ca0e8c6596bfc0d8cpo01",
      "address" : "192.168.10.76",
      "name" : "proxy-name"
    } ]
  } ]
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 实例管理