文档首页/ 云数据库 GeminiDB/ API参考/ API v3（推荐）/ 参数配置/ 创建参数模板
更新时间：2025-09-16 GMT+08:00
查看PDF
分享

创建参数模板

功能介绍

创建参数模板信息，包含参数模板名称、描述、数据库版本信息、参数值。

接口约束

该接口支持如下数据库实例：

  • GeminiDB Cassandra
  • GeminiDB Mongo
  • GeminiDB Influx经典部署模式实例
  • GeminiDB Redis经典部署模式实例

创建参数模板名称“name”不能与默认参数模板或已有参数模板的名称重复。

values只能传入系统定义的，可修改的参数，其他情况则忽略不处理。

URI

POST /v3/{project_id}/configurations

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表3 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

参数解释：

参数模板名称。

约束限制：

最长64个字符，只允许大写字母、小写字母、数字、和“-_.”特殊字符。

取值范围：

不涉及。

默认取值：

不涉及。

description

否

String

参数解释：

参数模板描述。

约束限制：

最长256个字符，不支持>!<"&'=特殊字符。

不涉及。

取值范围：

不涉及。

默认取值：

空。

values

否

Map<String,String>

参数解释：

参数值对象，用户基于默认参数模板自定义的参数值。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

默认不修改参数值。

datastore

是

ConfigurationDatastoreOption object

参数解释：

数据库对象。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表4 ConfigurationDatastoreOption

参数

是否必选

参数类型

描述

type

是

String

参数解释：

数据库类型。

约束限制：

不涉及。

取值范围：

  • GeminiDB Cassandra实例取值为“cassandra”。
  • GeminiDB Mongo实例取值为"mongodb"。
  • GeminiDB Influx实例取值为"influxdb"。
  • GeminiDB Redis实例取值为"redis"。
  • GeminiDB DynamoDB实例取值为"dynamodb"。
  • GeminiDB HBase实例取值为"hbase"。

默认取值：

不涉及。

version

是

String

参数解释：

数据库版本。

约束限制：

不涉及。

取值范围：

  • GeminiDB Cassandra实例支持3.11版本，取值为“3.11”。
  • GeminiDB Mongo实例支持4.0版本，取值为"4.0"。
  • GeminiDB Influx实例支持1.8版本，取值"1.8"。
  • GeminiDB Redis实例支持5.0版本，取值"5.0"。

默认取值：

不涉及。

mode

否

String

参数解释：

数据库实例类型。

约束限制：

当创建支持GeminiDB Mongo、GeminiDB Cassandra云原生部署模式实例的参数模板， 该参数必选。

取值范围：

  • GeminiDB Mongo副本集实例取值为"ReplicaSet"。
  • GeminiDB Influx 单节点实例取值为"InfluxdbSingle"。
  • GeminiDB Cassandra云原生部署模式实例取值为"CloudNativeCluster"。

默认取值：

不传该参数，对GeminiDB Cassandra实例默认创建支持经典部署模式实例的参数模板。

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

configuration

ConfigurationResult object

参数解释：

参数模板信息。

取值范围：

不涉及
表6 ConfigurationResult

参数

参数类型

描述

id

String

参数解释：

参数模板ID。

取值范围：

不涉及

name

String

参数解释：

参数模板名称。

取值范围：

不涉及

datastore_version_name

String

参数解释：

数据库版本名称。

取值范围：

不涉及

datastore_name

String

参数解释：

数据库名称。

取值范围：

不涉及

description

String

参数解释：

参数模板描述。

取值范围：

不涉及

created

String

参数解释：

创建时间。

取值范围：

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

updated

String

参数解释：

更新时间。

取值范围：

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

mode

String

参数解释：

数据库实例类型。

取值范围：

  • GeminiDB Mongo 副本集实例取值为"ReplicaSet"。
  • GeminiDB Influx 单节点实例取值为"InfluxdbSingle"。
  • GeminiDB Cassandra云原生部署模式实例取值为"CloudNativeCluster"。

请求示例

  • URI样例 
    POST https://gaussdb-nosql.ap-southeast-1.myhuaweicloud.com/v3/375d8d8fad1f43039e23d3b6c0f60a19/configurations
  • 创建Cassandra参数模板 
    {
  "name" : "configuration_test",
  "description" : "configuration_test",
  "values" : {
    "max_connections" : "10",
    "autocommit" : "OFF"
  },
  "datastore" : {
    "type" : "cassandra",
    "version" : "3.11"
  }
}

响应示例

状态码： 200

Success

{
  "configuration" : {
    "id" : "463b4b58d0e84e2b95605dea4552fdpr06",
    "name" : "configuration_test",
    "datastore_version_name" : "3.11",
    "datastore_name" : "cassandra",
    "description" : "configuration_test",
    "created" : "2020-03-09T08:27:56+0800",
    "updated" : "2020-03-09T08:27:56+0800"
  }
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 参数配置