云数据库 GEMINIDB-查询实例列表和详情:URI

时间:2024-05-10 17:21:41

URI

GET https://{Endpoint}/v3/{project_id}/instances

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户在某一region下的project ID。获取方法请参见获取项目ID

表2 Query参数

参数

是否必选

参数类型

描述

id

String

实例ID。

如果id以“*”起始,表示按照“*”后面的值模糊匹配,否则,按照实际填写的id精确匹配查询。

name

String

实例名称。

如果name以“*”起始,表示按照“*”后面的值模糊匹配,否则,按照实际填写的name精确匹配查询。

说明:

如果实例名称中包含中文,暂时不支持通过中文模糊搜索。

datastore_type

String

数据库类型。

取值为“cassandra”,表示查询GeminiDB Cassandra数据库实例。

取值为“mongodb”,表示GeminiDB Mongo查询数据库实例。

取值为“influxdb”,表示查询GeminiDB Influx数据库实例。

取值为“redis”,表示查询GeminiDB Redis数据库实例。

如果不传该参数,表示查询所有数据库实例。

mode

String

实例类型。

取值为“Cluster”,表示GeminiDB CassandraGeminiDB InfluxGeminiDB Redis集群实例类型。

取值为“InfluxdbSingle”,表示GeminiDB Influx单节点实例类型。

取值为“ReplicaSet”,表示GeminiDB Mongo副本集实例类型。

如果不传datastore_type参数,自动忽略该参数设置。

vpc_id

String

虚拟私有云ID,获取方法如下:

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

subnet_id

String

子网的网络ID,获取方法如下:

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

offset

Integer

索引位置偏移量,表示从指定project ID下最新的实例创建时间开始,按时间的先后顺序偏移offset条数据后查询对应的实例信息。

取值大于或等于0。不传该参数时,查询偏移量默认为0,表示从最新的实例创建时间对应的实例开始查询。

limit

Integer

查询实例个数上限值。

取值范围:1~100。不传该参数时,默认查询前100条实例信息。

support.huaweicloud.com/api-nosql/nosql_05_0016.html