Help Center/ GeminiDB/ API Reference/ APIs v3/ Parameter Configuration/ Modifying Parameters in a Parameter Template
Updated on 2025-09-23 GMT+08:00
View PDF

Modifying Parameters in a Parameter Template

Function

This API is used to modify parameters in a specified parameter template, including parameter names, descriptions, and values.

Constraints

This API supports the following instance types:
  • GeminiDB Cassandra
  • GeminiDB Influx

The modified parameter template name must be different from the name of any existing or default parameter template.

Default parameter templates cannot be modified.

For configuration item values, you can enter system-defined parameters that allow for modification.

URI

PUT /v3/{project_id}/configurations/{config_id}

Table 1 URI parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID of a tenant in a region. To obtain this value, see Obtaining a Project ID.

config_id

Yes

String

Parameter template ID.

Request Parameters

Table 2 Request header parameter

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token.
Table 3 Request body parameters

Parameter

Mandatory

Type

Description

name

No

String

Parameter template name. It can include a maximum of 64 characters and can contain only uppercase letters, lowercase letters, digits, hyphens (-), underscores (_), and periods (.).

description

No

String

Parameter template description. It can include a maximum of 256 characters and cannot contain the following special characters: >!<"&'= The value is left blank by default.

values

No

Map<String,String>

Parameter values defined by users based on a default parameter template. If this parameter is not specified, no parameter values are to be changed.

Response Parameters

Status code: 200

No response parameters

Example Request

  • URI example 
    PUT https://gaussdb-nosql.eu-west-101.myhuaweicloud.eu/v3/375d8d8fad1f43039e23d3b6c0f60a19/configurations/e02e76567ae04662a2753492b77f965bpr06
  • Modifying Parameters in a Parameter Template

    At least one parameter in the request body must be specified. Otherwise, the request cannot be delivered.

    {
  "name" : "configuration_test",
  "description" : "configuration_test",
  "values" : {
    "concurrent_reads" : "64"
  }
}

Example Response

None

Status Codes

See Status Codes.

Error Codes

See Error Codes.

Parent topic: Parameter Configuration