Obtaining Parameters of a Specified Parameter Template

Function

This API is used to obtain information about parameters of a specified parameter template.

Constraints

This API supports GeminiDB Cassandra instances.

URI

GET https://{Endpoint}/v3/{project_id}/configurations/{config_id}

Table 1 Path 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 parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token.

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

id

String

Parameter template ID.

name

String

Parameter template name.

description

String

Parameter template description.

datastore_version_name

String

Database version name.

datastore_name

String

Database name.

created

String

Creation time in the yyyy-MM-ddTHH:mm:ssZ format.

T is the separator between calendar and hourly notation of time. Z indicates the time zone offset.

updated

String

Update time in the yyyy-MM-ddTHH:mm:ssZ format.

T is the separator between calendar and hourly notation of time. Z indicates the time zone offset.

configuration_parameters

Array of ConfigurationParameterResult objects

Parameters defined by users based on a default parameter template.

Table 4 ConfigurationParameterResult

Parameter

Type

Description

name

String

Parameter name.

value

String

Parameter value.

restart_required

Boolean

Whether the instance needs to be restarted. The value can be:

  • false, indicating that the instance does not need to be restarted.

  • true, indicating that the instance needs to be restarted.

readonly

Boolean

Whether the parameter is read-only. The value can be:

  • false, indicating that the parameter is not read-only.

  • true, indicating that the parameter is read-only.

value_range

String

Value range. For example, the value of the Integer type ranges from 0 to 1, and the value of the Boolean type is true or false.

type

String

Parameter type. The value can be string, integer, boolean, list, or float.

description

String

Parameter description.

Example Requests

URI example

GET https://{Endpoint}/v3/375d8d8fad1f43039e23d3b6c0f60a19/configurations/e02e76567ae04662a2753492b77f965bpr06

Example Responses

Status code: 200

Success

{
  "id" : "07fc12a8e0e94df7a3fcf53d0b5e1605pr06",
  "name" : "default-cassandra-3.11",
  "datastore_version_name" : "3.11",
  "datastore_name" : "cassandra",
  "description" : "Default parameter group for cassandra 3.11",
  "created" : "2020-03-21T04:40:51+0800",
  "updated" : "2020-03-21T04:40:51+0800",
  "configuration_parameters" : [ {
    "name" : "concurrent_reads",
    "value" : "64",
    "restart_required" : true,
    "readonly" : true,
    "value_range" : "4-512",
    "type" : "integer",
    "description" : "Number of concurrent read threads."
  } ]
}

Status Codes

For details, see Status Codes.

Error Codes

For details, see Error Codes.