Help Center/ Distributed Message Service for Kafka/ API Reference/ APIs V2 (Recommended)/ Lifecycle Management/ Modifying Instance Configurations
Updated on 2026-03-16 GMT+08:00
View PDF

Modifying Instance Configurations

Function

This API is used to modify instance configurations.

Calling Method

For details, see Calling APIs.

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

List of Kafka 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.

Parent Topic: Lifecycle Management