doc-exports/docs/ddm/api-ref/en-us_topic_0000002510482745.html

Modifying Parameters of an Instance (a V3 API)

Function

This API is used to modify parameters of a DDM instance.

Constraints

• This API is to be removed soon, so it is not recommended.
• Use the latest API. For details, see Modifying Parameters of an Instance (a V3.1 API).

URI

PUT /v3.1/{project_id}/instances/{instance_id}/configurations

Table 1 URI parameters

Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID of a tenant in a region For how to obtain a project ID, see Obtaining a Project ID.
instance_id	Yes	String	DDM instance ID

Request Parameters

Table 2 Request header parameters

Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. It can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token.
Content-Type	Yes	String	MIME type of the request body. Value range: application/json application/json;charset=utf-8

Table 3 Request body parameters

Parameter	Mandatory	Type	Description
values	Yes	Map<String,String>	Parameter values defined by users based on a default parameter template. key: parameter name. If a parameter name is left empty, its value is not to be changed. value: indicates the parameter value.

Example Request

Changing the value of long_query_time to 2. The value indicates that the query is considered as a slow query if its execution duration is greater than or equal to 2 seconds.

PUT https://ddm.eu-de.otc.t-systems.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/1f5c9fd6cd984056ba89c8c87cc03278in09/configurations

{
  "values" : {
    "long_query_time" : "2"
  }
}

Response

• Normal response

  Table 4 Response body parameters

  Parameter	Type	Description
  need_restart	Boolean	Whether the instance needs to be restarted

• Normal response example

  {
    "need_restart": false
  }

• Abnormal response

  For details, see Abnormal Request Results.

Status Codes

• Normal

  200

• Abnormal

  For details, see Status Codes.

Error Codes

For details, see Error Codes.

Parent topic: Parameter Management