Skip to content

danube-admin: Topics Commands

The danube-admin-cli tool provides commands to manage and view information about topics in your Danube cluster. Below is the documentation for the commands related to topics.

Commands

danube-admin-cli topics list NAMESPACE

Get the list of topics in a specified namespace.

Usage:

danube-admin-cli topics list NAMESPACE

Description:

This command retrieves and displays all topics within a specified namespace. Replace NAMESPACE with the name of the namespace you want to query.

Example Output:

Topic: topic1
Topic: topic2
Topic: topic3

danube-admin-cli topics create TOPIC

Create a non-partitioned topic.

Usage:

danube-admin-cli topics create TOPIC

Description:

This command creates a new non-partitioned topic with the specified name. Replace TOPIC with the desired name for the new topic.

Example Output:

Topic Created: true

danube-admin-cli topics delete TOPIC

Delete a specified topic.

Usage:

danube-admin-cli topics delete TOPIC

Description:

This command deletes the specified topic. Replace TOPIC with the name of the topic you want to delete.

Example Output:

Topic Deleted: true

danube-admin-cli topics subscriptions TOPIC

Get the list of subscriptions on a specified topic.

Usage:

danube-admin-cli topics subscriptions TOPIC

Description:

This command retrieves and displays all subscriptions associated with a specified topic. Replace TOPIC with the name of the topic you want to query.

Example Output:

Subscriptions: [subscription1, subscription2]

danube-admin-cli topics unsubscribe --subscription SUBSCRIPTION TOPIC

Delete a subscription from a topic.

Usage:

danube-admin-cli topics unsubscribe --subscription SUBSCRIPTION TOPIC

Description:

This command deletes a subscription from a specified topic. Replace SUBSCRIPTION with the name of the subscription and TOPIC with the name of the topic.

Example Output:

Unsubscribed: true

Error Handling

If there is an issue with connecting to the cluster or processing the request, the CLI will output an error message. Ensure your Danube cluster is running and accessible, and check your network connectivity.

Examples

Here are a few example commands for quick reference:

  • List topics in a namespace:
danube-admin-cli topics list my-namespace
  • Create a topic:
danube-admin-cli topics create my-topic
  • Delete a topic:
danube-admin-cli topics delete my-topic
  • Unsubscribe from a topic:
danube-admin-cli topics unsubscribe --subscription my-subscription my-topic
  • List subscriptions for a topic:
danube-admin-cli topics subscriptions my-topic
  • Create a new subscription for a topic:
danube-admin-cli topics create-subscription --subscription my-subscription my-topic

For more detailed information or help with the danube-admin-cli, you can use the --help flag with any command.

Example:

danube-admin-cli topics --help