81 lines
2.9 KiB
Markdown
81 lines
2.9 KiB
Markdown
|
|
The `influxdb3 delete trigger` command deletes a processing engine trigger.
|
|
|
|
## Usage
|
|
|
|
<!--pytest.mark.skip-->
|
|
|
|
```bash
|
|
# Syntax
|
|
influxdb3 delete trigger [OPTIONS] --database <DATABASE_NAME> <TRIGGER_NAME>
|
|
```
|
|
|
|
## Arguments
|
|
|
|
- **TRIGGER_NAME**: The name of the trigger to delete.
|
|
|
|
## Options
|
|
|
|
<!--docs:exclude
|
|
--trigger-name: internal variable, use positional <TRIGGER_NAME>
|
|
-->
|
|
|
|
| Option | | Description |
|
|
| :----- | :---------------- | :--------------------------------------------------------------------------------------- |
|
|
| `-H` | `--host` | Host URL of the running {{< product-name >}} server (default is `http://127.0.0.1:8181`) |
|
|
| `-d` | `--database` | _({{< req >}})_ Name of the database to operate on |
|
|
| | `--token` | _({{< req >}})_ Authentication token |
|
|
| | `--force` | Force delete even if the trigger is active |
|
|
| | `--tls-ca` | Path to a custom TLS certificate authority (for self-signed or internal certificates) |
|
|
| | `--tls-no-verify` | Disable TLS certificate verification (**Not recommended in production**, useful for self-signed certificates) |
|
|
| `-h` | `--help` | Print help information |
|
|
| | `--help-all` | Print detailed help information |
|
|
|
|
### Option environment variables
|
|
|
|
You can use the following environment variables to set command options:
|
|
|
|
| Environment Variable | Option |
|
|
| :------------------------ | :---------------- |
|
|
| `INFLUXDB3_HOST_URL` | `--host` |
|
|
| `INFLUXDB3_DATABASE_NAME` | `--database` |
|
|
| `INFLUXDB3_AUTH_TOKEN` | `--token` |
|
|
| `INFLUXDB3_TLS_NO_VERIFY` | `--tls-no-verify` |
|
|
|
|
## Examples
|
|
|
|
- [Delete a trigger](#delete-a-trigger)
|
|
- [Force delete an active trigger](#force-delete-an-active-trigger)
|
|
|
|
In the examples below, replace the following:
|
|
|
|
- {{% code-placeholder-key %}}`DATABASE_NAME`{{% /code-placeholder-key %}}:
|
|
Database name
|
|
- {{% code-placeholder-key %}}`AUTH_TOKEN`{{% /code-placeholder-key %}}:
|
|
Authentication token
|
|
- {{% code-placeholder-key %}}`TRIGGER_NAME`{{% /code-placeholder-key %}}:
|
|
Name of the trigger to delete
|
|
|
|
### Delete a trigger
|
|
|
|
<!--pytest.mark.skip-->
|
|
|
|
```bash { placeholders="AUTH_TOKEN|DATABASE_NAME|TRIGGER_NAME" }
|
|
influxdb3 delete trigger \
|
|
--database DATABASE_NAME \
|
|
--token AUTH_TOKEN \
|
|
TRIGGER_NAME
|
|
```
|
|
|
|
### Force delete an active trigger
|
|
|
|
<!--pytest.mark.skip-->
|
|
|
|
```bash { placeholders="AUTH_TOKEN|DATABASE_NAME|TRIGGER_NAME" }
|
|
influxdb3 delete trigger \
|
|
--force \
|
|
--database DATABASE_NAME \
|
|
--token AUTH_TOKEN \
|
|
TRIGGER_NAME
|
|
```
|