Help Center/ Distributed Message Service for Kafka/ User Guide/ Configuring Topics/ Managing Topics/ Modifying Kafka Topic Configurations
Updated on 2025-08-21 GMT+08:00
View PDF
Share

Modifying Kafka Topic Configurations

This section describes how to modify configurations in Table 1 of a Kafka topic on the console.

Modifying Synchronous Replication, Synchronous Flushing, Message Timestamp, Max. Message Size, or Description does not require an instance restart.

Table 1 Kafka topic configuration parameters

Parameter

Description

Partitions

Number of partitions in a topic. For details about how to change, see Changing Kafka Partition Quantity.

Aging Time (h)

Maximum message retention. For details about how to change, see Changing Kafka Message Retention Period.

Replicas

Number of replicas of each topic partition. To modify it, see Modifying Kafka Topic Replicas.

Synchronous Replication

A message is returned to the client only after the message creation request has been received and the message has been acknowledged by all replicas.

Synchronous Flushing
  • Enabled: A message is immediately flushed to disk once it is created, bringing higher reliability.
  • Disabled: A message is stored in the memory instead of being immediately flushed to disk once created.

Message Timestamp
Timestamp type of a message. Options:
  • CreateTime: time when the producer created the message.
  • LogAppendTime: time when the broker appended the message to the log.

Max. Message Size

Maximum size of messages to be processed in batches. If message compression is enabled, this parameter indicates the size after compression.

If this value is increased and the consumer version is earlier than 0.10.2, the consumers' fetch size must also be increased so that they can obtain the latest value.

Description

Topic description.

Notes and Constraints

  • If there is only one replica, Synchronous Replication cannot be enabled.
  • After enabling synchronous replication, set acks to all or –1 on the client. Otherwise, this function will not take effect.
  • A maximum of 50 topics can be modified in a batch at a time.

Procedure

One or more topics can be modified on the Kafka console. To modify topics in batches, their descriptions cannot be modified.

  1. Log in to the Kafka console.
  2. Click in the upper left corner to select the region where your instance is located.
  3. Click the desired instance to go to the instance details page.
  4. In the navigation pane, choose Instance > Topics.
  5. Modify topic configurations in either of the following ways:

    • Select one or more topics and click Edit Topic above the topic list.
    • In the row containing the desired topic, click Edit.

  6. In the Edit Topic dialog box, change configurations and click OK.

    View the reconfiguration on the Topics page.

  1. Log in to the Kafka console.
  2. Click in the upper left corner to select the region where your instance is located.
  3. Click the desired instance to go to the instance details page.
  4. In the navigation pane, choose Instance > Topics.
  5. Select the desired topics and click Batch Edit Topic on the upper left.
  6. In the Batch Operations area, select the items listed in Table 2. In the Preview Change area, view the unchanged and changed items. Click OK.

    Figure 1 Modifying topics in batches
    Table 2 Topic configuration parameters

    Parameter

    Description

    Synchronous Replication

    Select it and enable or disable this function.

    Synchronous Flushing

    Select it and enable or disable this function.

    Message Timestamp

    Select it and select CreateTime or LogAppendTime from the drop-down list box.

    Max. Message Size (bytes)

    Select it and enter a value.

    View the reconfiguration on the Topics page.

Related Document

To modify topic configurations by calling an API, see Modifying Topics of a Kafka Instance.

Parent Topic: Managing Topics