Updated on 2025-10-24 GMT+08:00

Obtaining Parameters of a Specified DB Instance

Description

This API is used to obtain information about parameters of a specified DB instance.

Constraints

This API applies only to DDS Community Edition.

URI

URI format
GET /v3/{project_id}/instances/{instance_id}/configurations
URI example
https://dds.ap-southeast-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/f0ba99dd8a8249838a6007042d76b07ain02/configurations?entity_id=827697ee2f6040bd9fcf65586e3f7218gr02

Request Parameters

Parameter description

**Table 1** Request parameters
Name	Type	IN	Mandatory	Description
X-Auth-Token	string	header	Yes	User token obtained from IAM. For details, see Authentication.
Content-Type	string	header	Yes	MIME type of the request body. You are advised to use the default value application/json. For APIs used to upload objects or images, the value can vary depending on the flow type.
project_id	string	path	Yes	Project ID of a tenant in a region. To obtain the project ID, see Obtaining a Project ID.
instance_id	string	path	Yes	Instance ID, which can be obtained by calling the API described in Querying Instances and Details. If you do not have an instance, call the API described in Creating a DB Instance to create one.

**Table 2** Query parameters
Parameter	Type	Mandatory	Description
entity_id	String	Yes	Instance ID, group ID, or node ID. You can call the API used for querying instances and details to obtain the value. If you do not have an instance, you can call the API used for creating an instance. If the DB instance type is cluster and the shard or config parameter template is obtained, the value is the group ID. If the parameter template of the mongos node is obtained, the value is the node ID. If the DB instance type is a replica set instance or a single node instance, the value is the instance ID.

Response Parameters

Parameter description

**Table 3** Response body parameters
Name	Type	Description
datastore_version	String	Database version.
datastore_name	String	Database type.
created	String	Creation time in the "yyyy-MM-ddTHH:mm:ssZ" format. T is the separator between the calendar and the 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 the calendar and the hourly notation of time. Z indicates the time zone offset.
parameters	Array of objects	Indicates the parameters defined by users based on the default parameter templates. For details, see Table 4.

**Table 4** Data structure description of the parameters field
Name	Type	Description
name	String	The parameter name.
value	String	Parameter value.
value_range	String	The 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.
restart_required	Boolean	Whether the instance needs to be restarted. If the value is true, restart is required. If the value is false, restart is not required.
readonly	Boolean	Whether the parameter group is read-only. If the value false, the parameter is not read-only. If the value is true, the parameter is read-only.
type	String	The parameter type. The value can be integer, string, boolean, float, or list.
description	String	The parameter description.

Example Responses

{ 
    "datastore_version" : "4.0", 
    "datastore_name" : "mongos", 
    "created" : "2017-01-01T10:00:00", 
    "updated" : "2017-01-01T10:00:00", 
    "parameters" : [ { 
      "name" : "cursorTimeoutMillis", 
      "value" : 600000, 
      "restart_required" : false, 
      "readonly" : false, 
      "description": "Specify the expiration time of idle cursors. DDS will delete idle cursors.",
      "value_range" : "600000-1000000" 
    } ] 
  }

Status Code

For more information, see Status Code.

Error Code

For more information, see Error Code.

Parent topic: Parameter Configuration