华为云首页 用户手册

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

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

时间：2024-10-23 09:53:40
云数据库 GAUSSDB

URI

GET https://{Endpoint}/v3.1/{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

String

是

参数解释：

租户在某一Region下的项目ID。

获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

id

String

否

参数解释：

实例ID，此参数是用户创建实例的唯一标识，用于查询某一实例的列表。

约束限制：

“*”为系统保留字符，如果id是以“*”起始，表示按照*后面的值模糊匹配，否则，按照id精确匹配查询。不能只传入“*”。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

name

String

否

参数解释：

实例名称，可按照实例名称查询实例列表。

约束限制：

“*”为系统保留字符，如果name是以“*”起始，表示按照*后面的值模糊匹配，否则，按照name精确匹配查询。不能只传入“*”。

取值范围：

实例名称长度在4个到64个字符之间，必须以字母开头，可以包含字母、数字、中划线或下划线，不能包含其他特殊字符。

默认取值：

不涉及。

type

String

否

参数解释：

实例类型，可按照实例类型查询实例列表。

约束限制：

不涉及。

取值范围：

  • Enterprise（区分大小写），对应分布式实例（独立部署）。
  • Centralization_standard（区分大小写），对应主备版实例。

默认取值：

不涉及。

datastore_type

String

否

参数解释：

数据库类型，不区分大小写，可按照数据库类型查询实例列表。

约束限制：

不涉及

取值范围：

GaussDB

默认取值：

不涉及。

vpc_id

String

否

参数解释：

虚拟私有云ID。可按照实例所在虚拟私有云查询实例列表。获取方法如下。

  • 方法1：登录虚拟私有云服务的控制台界面，在虚拟私有云的详情页面查找VPC ID。
  • 方法2：通过虚拟私有云服务的API接口查询，具体操作可参考查询VPC列表。

约束限制：

不涉及。

取值范围：

符合UUID形式。

默认取值：

不涉及。

subnet_id

String

否

参数解释：

子网的网络ID信息。可按照实例所在子网的网络ID查询实例列表。获取方法如下。

  • 方法1：登录虚拟私有云服务的控制台界面，单击VPC下的子网，进入子网详情页面，查找网络ID。
  • 方法2：通过虚拟私有云服务的API接口查询，具体操作可参考查询子网列表。

约束限制：

不涉及。

取值范围：

符合UUID形式。

默认取值：

不涉及。

offset

Integer

否

参数解释：

索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。

约束限制：

必须为数字，不能为负数。

取值范围：

[0, 2^31-1]

默认取值：

默认为0偏移0条数据，表示从第一条数据开始查询）。

limit

Integer

否

参数解释：

查询记录数。

约束限制：

不涉及。

取值范围：

[1, 100]

默认取值：

默认为100。

tags

String

否

参数解释：

  • {key}表示标签键。
  • {value}表示标签值。

可根据实例标签键值查询实例列表。

约束限制：

如果同时使用多个标签键值对进行查询，中间使用逗号分隔开，最多包含20组。

取值范围：

  • {key}最大长度127个unicode字符。key不能为空或者空字符串，不能为空格，使用之前先trim前后半角空格。不能包含+/?#&=,%特殊字符。
  • {value}可以为空。最大长度255个unicode字符，使用之前先trim 前后半角空格。不能包含+/?#&=,%特殊字符。如果value为空，则表示any_value（查询任意value）。

默认取值：

不涉及。

charge_mode

String

否

参数解释：

计费模式。可按照计费模式查询实例列表。

约束限制：

不涉及。

取值范围：

  • postPaid：后付费，即按需付费。
  • prePaid：预付费，即 包年/包月。

默认取值：

不涉及。
support.huaweicloud.com/api-gaussdb/gaussdb_api_021.html

华为云11.11 2核1G 2M 云服务器

29元/年

立即注册 领万元上云礼券

抽奖赢11111元免单

续费同价 L实例 2核2G 4M

98元/年

热门域名 1元 随心购

1元/年

看了此文的人还看了
CDN加速 GaussDB 文字转换成语音 免费的服务器 如何创建网站 域名网站购买 私有云桌面 云主机哪个好 域名怎么备案 手机云电脑 SSL证书申请 云点播服务器 免费OCR是什么 电脑云桌面 域名备案怎么弄 语音转文字 文字图片识别 云桌面是什么 网址安全检测 网站建设搭建 国外CDN加速 SSL免费证书申请 短信批量发送 图片OCR识别 云数据库MySQL 个人域名购买 录音转文字 扫描图片识别文字 OCR图片识别 行驶证识别 虚拟电话号码 电话呼叫中心软件 怎么制作一个网站 Email注册网站 华为VNC 图像文字识别 企业网站制作 个人网站搭建 华为云计算 免费租用云托管 云桌面云服务器 ocr文字识别免费版 HTTPS证书申请 图片文字识别转换 国外域名注册商 使用免费虚拟主机 云电脑主机多少钱 鲲鹏云手机 短信验证码平台 OCR图片文字识别 SSL证书是什么 申请企业邮箱步骤 免费的企业用邮箱 云免流搭建教程 域名价格
热门活动
云数据库 GAUSSDB-查询数据库实例列表（v3.1）:URI

搜索反馈

您搜索到想要的结果了吗?

是的 没有

意见反馈

0/200

提交 取消

提交成功！非常感谢您的反馈，我们会继续努力做到更好 反馈提交失败！请稍后重试！
产品专区
推荐文章
更多内容
云硬盘存储EVS Web应用防火墙 人机语音识别 云计算入门 云数据库选择 HDC大会 华为云计算 响应式建站是什么 智慧班牌系统