Streaming

rpk topic list

List topics, optionally listing specific topics. This command lists all topics that you have access to by default.

If specifying topics or regular expressions, this command can be used to know exactly what topics you would delete if using the same input to the delete command.

Alternatively, you can request specific topics to list, which can be used to check authentication errors (do you not have access to a topic you were expecting to see?), or to list all topics that match regular expressions.

The --regex or -r flag opts into parsing the input topics as regular expressions and listing any non-internal topic that matches any of expressions. The input expressions are wrapped with ^ and $ so that the expression must match the whole topic name.

Regular expressions cannot be used to match internal topics. Specifying both -i and -r will exit with failure.

Usage

rpk topic list [flags]

Aliases

rpk topic ls

Flags

Value Type Description

-d, --detailed

bool

Print per-partition information for topics.

--format

string

Output format (json,yaml,text,wide,help).

-i, --internal

bool

Include internal topics (those starting with __) in the output.

-r, --regex

bool

Filter topics using regular expressions. Expressions are automatically anchored with ^ and $, so they must match the full topic name.

Global flags

Value Type Description

--config

string

Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml.

-X, --config-opt

stringArray

Override rpk configuration settings; -X help for detail or -X list for terser detail.

--ignore-profile

bool

Ignore rpk.yaml and redpanda.yaml; use default settings.

--profile

string

rpk profile to use.

-v, --verbose

bool

Enable verbose logging.