tencent cloud

Managing the Namespace

PDF
Focus Mode
Font Size
Last updated: 2025-12-24 14:59:00
During the use of namespaces, you may need to perform management operations such as modifying namespace configurations or deleting unnecessary namespaces. This document describes the operation steps for managing namespaces through the console.

Modifying a Namespace

Once a namespace is created, its name cannot be modified. Only its configuration information can be modified. To update the configurations, follow the steps below:
1. On the Namespace list page, click Edit in the operation column to go to the Edit page.
Parameter
Description
Message TTL
Expiration time for unconsumed messages. If not acknowledged within the timeout period, the message will be skipped. It ranges from 60 seconds to 15 days.
Message Retention Policy
Persistent retention: Messages are persistently stored regardless of whether they have been consumed, based on the maximum retention period and storage space. Once the limit is reached, messages will be deleted based on the generation time in ascending order.
Maximum retention period: Messages are deleted after this period, calculated from when the message is produced to the topic. The retention policy applies only to acknowledged messages and does not affect unacknowledged messages. Unacknowledged messages are eligible for cleanup only after the Time to Live (TTL) expires. It ranges from 60 seconds to 15 days.
Maximum storage space: When the total size of all messages in the namespace reaches this limit, older messages are deleted in chronological order (from oldest to latest) based on their generation time. The minimum value is 10 GB. The configured capacity is allocated from the cluster's storage resources.
Consume-and-delete: Messages are asynchronously cleaned up within a certain period after being successfully acknowledged, saving storage space. If a topic has no subscriptions, this asynchronous cleanup applies immediately to newly generated messages.
Auto-Create Subscriptions
After enabling this feature, clients can auto-create subscriptions.
Description
Fill in the namespace description, which cannot exceed 128 characters.
2. Modify the namespace configuration information, then click Save to complete the modification.

Deleting a Namespace

Note
The namespace cannot be deleted if there are topics within it.
Permissions cannot be deleted if the role assigned the permissions in any namespace still exists.
It cannot be deleted when associated with a Virtual Private Cloud (VPC).
To delete the created namespace, follow the steps below:
1. On the Namespace list page, click Delete in the operation column.
2. In the displayed dialog box, click Delete to delete the namespace.


Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback