stream topic delete
Deletes the specified topic from the specified stream.
The deletion of the topic and the messages is immediate. However, the command also starts a background process for the purging the topic and messages to reclaim disk space.
If
the parameter -autocreate
for the stream is set to true
, a
topic with the same name is created if a producer writes a message to a topic of the same
name. For example, if you delete the topic Topic_A
and then a producer
writes a message to the topic Topic_A
, HPE Ezmeral Data Fabric Streams creates a topic
that is named Topic_A
. Aside from the name, the new topic
Topic_A
shares nothing with the deleted topic
Topic_A
.
Permissions Required
To run this command, your user ID must have the following permissions:readAce
andwriteAce
on the volumelookupdir
on directories in the pathtopicperm
permission on the stream
NOTE
The mapr
user is not treated as a
superuser. HPE Ezmeral Data Fabric Streams does not allow the
mapr
user to run this command unless that user is given the relevant
permission or permissions with access-control expressions.Syntax
CLI |
|
REST | http[s]://<host>:<port>/rest/stream/topic/delete?path=<path>&topic=<name> |
Parameters
Parameter | Description |
---|---|
path |
The path and name of the stream from which to delete the topic. |
topic |
The name of the topic to delete. |