Function

This API is used to modify instance configurations.

URI

PUT /v2/{project_id}/instances/{instance_id}/configs

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain it, see Obtaining a Project ID.
instance_id	Yes	String	Instance ID.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
kafka_configs	No	Array of ModifyInstanceConfig objects	Configurations to be modified.

**Table 3** ModifyInstanceConfig
Parameter	Mandatory	Type	Description
name	No	String	Names of configurations to be modified.
value	No	String	New value of the modified configuration.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
job_id	String	Configuration modification task ID.
dynamic_config	Integer	Number of dynamic configuration parameters to be modified.
static_config	Integer	Number of static configuration parameters to be modified.

Example Requests

Modifying the threshold for idle connection timeout and the log deletion interval.

PUT https://{endpoint}/v2/{project_id}/instances/{instance_id}/configs

{
  "kafka_configs" : [ {
    "name" : "connections.max.idle.ms",
    "value" : "500000"
  }, {
    "name" : "log.retention.hours",
    "value" : "66"
  } ]
}

Example Responses

Status code: 200

Configuration modified.

{
  "job_id" : "8abfa7b38ba79a20018ba9afc550576a",
  "dynamic_config" : 0,
  "static_config" : 2
}

Status Codes

Status Code	Description
200	Configuration modified.

Error Codes

See Error Codes.

Modifying Instance Configurations