华为云首页用户手册

云数据库 GAUSSDB-查询数据库实例列表（v3.2）:URI

云数据库 GAUSSDB-查询数据库实例列表（v3.2）:URI

时间：2024-12-31 09:12:41

云数据库 GAUSSDB

URI

GET https://{Endpoint}/v3.2/{project_id}/instances?id={id}&name={name}&type={type}&datastore_type={datastore_type}&vpc_id={vpc_id}&subnet_id={subnet_id}&offset={offset}&limit={limit}

表1 参数说明
名称	是否必选	说明
project_id	是	参数解释：租户在某一Region下的项目ID。获取方法请参见获取项目ID。约束限制：不涉及。取值范围：只能由英文字母、数字组成，且长度为32个字符。默认取值：不涉及。

表2 Query参数
参数	是否必选	参数类型	描述
id	否	String	实例ID。 “”为系统保留字符，如果iID是以“”起始，表示按照后面的值模糊匹配，否则，按照ID精确匹配查询。不能只传入“”。
name	否	String	实例名称。 “”为系统保留字符，如果name是以“”起始，表示按照后面的值模糊匹配，否则，按照name精确匹配查询。不能只传入“”。
type	否	String	按照实例类型查询，取值区分大小写。取值范围： Enterprise（区分大小写），对应分布式实例（独立部署）。 Centralization_standard（区分大小写），对应主备版实例。
datastore_type	否	String	数据库类型，支持“ GaussDB ”，区分大小写。
vpc_id	否	String	虚拟私有云ID。方法1：登录虚拟私有云服务的控制台界面，在虚拟私有云的详情页面查找VPC ID。方法2：通过虚拟私有云服务的API接口查询，具体操作可参考查询VPC列表。
subnet_id	否	String	子网的网络ID信息。方法1：登录虚拟私有云服务的控制台界面，单击VPC下的子网，进入子网详情页面，查找网络ID。方法2：通过虚拟私有云服务的API接口查询，具体操作可参考查询子网列表。
offset	否	Integer	索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。
limit	否	Integer	查询记录数。默认为100，不能为负数，最小值为1，最大值为100
tags	否	Array	根据实例标签键值对进行查询。 {key}表示标签键，不可以为空或重复。最大长度127个unicode字符。key不能为空或者空字符串，不能为空格，使用之前先trim前后半角空格。不能包含+/?#&=,%特殊字符。 {value}表示标签值，可以为空。最大长度255个unicode字符，使用之前先trim 前后半角空格。不能包含+/?#&=,%特殊字符。如果value为空，则表示any_value（查询任意value）。如果同时使用多个标签键值对进行查询，中间使用逗号分隔开，最多包含10组。
charge_mode	否	String	计费模式。取值范围： postPaid：后付费，即按需付费。 prePaid：预付费，即包年/包月。

上一篇：云数据库 GAUSSDB-查询数据库实例列表（v3.2）:响应参数

下一篇：云数据库 GAUSSDB-创建数据库实例（v3.1）:响应示例

新客秒杀 2核2G 3M L实例

68元/年

普惠上云领千元上云礼券

立即前往

企业专享 X实例 4核8G 5M

888元/年

热门域名 1元随心购

1元/年起

云数据库 GAUSSDB-查询数据库实例列表（v3.2）:URI

意见反馈

0/200

提交成功！非常感谢您的反馈，我们会继续努力做到更好反馈提交失败！请稍后重试！

推荐文章

解决方案
相关专题