更新时间:2025-08-30 GMT+08:00

查询实例参数配置

功能介绍

查询实例参数配置信息。

接口约束

该接口支持如下数据库实例:
  • GeminiDB Cassandra
  • GeminiDB Mongo
  • GeminiDB Influx经典部署模式实例
  • GeminiDB Redis经典部署模式实例

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

instance_id

String

参数解释:

实例ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

datastore_version_name

String

参数解释:

数据库版本名称。

取值范围:

不涉及。

datastore_name

String

参数解释:

数据库名称。

取值范围:

不涉及。

created

String

参数解释:

创建时间。

约束限制:

格式为"yyyy-MM-ddTHH:mm:ssZ",

其中,T指某个时间的开始;Z指时区偏移量。

取值范围:

不涉及。

updated

String

参数解释:

更新时间。

约束限制:

格式为"yyyy-MM-ddTHH:mm:ssZ",

其中,T指某个时间的开始;Z指时区偏移量。

取值范围:

不涉及。

id

String

参数解释:

参数模板ID。

取值范围:

不涉及。

mode

String

参数解释:

数据库实例类型。

取值范围:

  • GeminiDB Cassandra集群类型为"Cluster"。
  • GeminiDB Cassandra经典部署模式实例为"Cluster"。
  • GeminiDB Cassandra云原生部署模式实例为"CloudNativeCluster"。
  • GeminiDB Mongo副本集类型为"ReplicaSet"。
  • GeminiDB Mongo集群类型为"Sharding"。
  • GeminiDB Influx经典部署模式实例为"Cluster"。
  • GeminiDB Influx经典部署模式单节点类型为"InfluxdbSingle"。
  • GeminiDB Redis经典部署模式实例为“Cluster”。
  • GeminiDB Redis经典部署模式主备类型为“Replication”。

configuration_parameters

Array of ConfigurationParameterResult objects

参数解释:

参数对象,用户基于默认参数模板自定义的参数配置。

表4 ConfigurationParameterResult

参数

参数类型

描述

name

String

参数解释:

参数名称。

取值范围:

不涉及。

value

String

参数解释:

参数值。

取值范围:

不涉及。

restart_required

Boolean

参数解释:

是否需要重启。

取值范围:

  • 取值为“false”,不需要重启。
  • 取值为“true”,需要重启。

readonly

Boolean

参数解释:

是否只读。

取值范围:

  • 取值为“false”,非只读参数。
  • 取值为“true”,只读参数。

value_range

String

参数解释:

参数值范围。示例:Integer类型取值范围为0~1、Boolean类型取值为“true”或“false”。

取值范围:

不涉及。

type

String

参数解释:

参数类型。

取值范围:

取值为“string”、“integer”、“boolean”、“list”或“float”。

description

String

参数解释:

参数描述。

取值范围:

不涉及。

请求示例

URI样例
GET https://gaussdb-nosql.ap-southeast-1.myhuaweicloud.com/v3/375d8d8fad1f43039e23d3b6c0f60a19/instances/9136fd2a9fcd405ea4674276ce36dae8in02/configurations  

响应示例

状态码: 200

Success

{
  "datastore_version_name" : "3.11",
  "datastore_name" : "cassandra",
  "created" : "2020-03-21 11:40:44",
  "updated" : "2020-03-21 11:40:44",
  "id": "9ad6bc82146e4043a50c963ab3bf09adpr06",
  "mode": "Cluster",
  "configuration_parameters" : [ {
    "name" : "concurrent_reads",
    "value" : "64",
    "restart_required" : true,
    "readonly" : true,
    "value_range" : "4-512",
    "type" : "integer",
    "description" : "Number of concurrent read threads."
  } ]
}

状态码

请参见状态码

错误码

请参见错误码