mqtt-servers

MQTT brokers and the topics subscribed on them.

📄️List the configured MQTT brokers

Returns all MQTT brokers configured for the current tenant, including their topics.

📄️Add an MQTT broker

Creates a new MQTT broker for the current tenant. The name must not already be in use. The running bridge picks the broker up and connects to it without a restart.

📄️Try connection settings against a broker

Opens a connection with the given settings and closes it again. Answers whether the broker was reachable and what it said, without storing anything.

📄️One MQTT broker

Returns the broker with its connection settings and subscribed topics. The password is never part of the answer.

📄️Change an MQTT broker

Updates the broker. Omitting the password keeps the stored one. The bridge applies the change on its next poll, reconnecting if the connection settings changed.

📄️Remove an MQTT broker

Deletes the broker and the topics subscribed on it. The time series already written stay untouched.

📄️Subscribe a topic on this broker

Adds a topic filter to the broker. The running mqtt-client picks the subscription up at its next reconciliation, no restart needed. A filter that is already subscribed on this broker is answered 409 - the same messages would otherwise be written twice.

📄️Change a subscribed topic

Replaces the topic filter. The old subscription ends and the new one starts at the mqtt-client's next reconciliation; messages arriving in between are not buffered.

📄️Unsubscribe a topic

Removes the topic filter from the broker. Data already written under it stays; only the subscription ends.