evtctxdrop

Bulk-deletes all event contexts for the specified topic. Using the all=t option deletes all event contexts regardless of topic.

Command properties

Item	Description
Command type	Transforming
Required permission	None
License usage	N/A
Parallel execution	Not supported
Distributed execution	Not supported

Syntax

evtctxdrop {topic=STR | all=BOOL}

Options

topic=STR: Topic name of the event contexts to delete. Required when all=t is not specified.
all=BOOL: When set to t, bulk-deletes all event contexts for all topics.

Error codes

Parse errors

Error code	Message	Description
missing-evtctxdrop-topic	-	The `topic` option is missing and `all=t` is not specified

Runtime errors

N/A

Description

The evtctxdrop command bulk-deletes all event contexts for the specified topic from the in-memory store. Unlike the evtctxdel command, which deletes individual event contexts based on conditions, the evtctxdrop command removes all event contexts for a topic at once.

Using the all=t option deletes all event contexts regardless of topic. Use this option with caution, as it also deletes event contexts belonging to other rules that are currently running.

This command performs the deletion asynchronously and waits until the deletion is complete.

Examples

Bulk-delete event contexts for a specific topic
```
evtctxdrop topic=login_fail
```
Deletes all event contexts for the login_fail topic.
Delete all event contexts
```
evtctxdrop all=t
```
Bulk-deletes all event contexts for all topics.