Fehlermeldungen

Diese Seite listet die Fehlermeldungen und Codes auf, denen Personen und Integrationen am häufigsten begegnen, gruppiert nach dem Ort ihres Auftretens, mit Bedeutung und Abhilfe. Meldungen werden so zitiert, wie Hermetry sie anzeigt. Codes in code font sind stabil und können sicher in Ihrer eigenen Fehlerbehandlung verwendet werden; Meldungstexte können sich ändern. Für einen hier nicht aufgeführten Fehler durchsuchen Sie den Abschnitt der Funktion oder lesen Sie Hilfe erhalten.

Tarifgrenzen

Eine Tarifgrenze liefert 403 mit details.key, das die Grenze benennt, details.limit mit ihrem Wert und details.current mit Ihrer Anzahl.

details.key oder Meldung	Grenze	Abhilfe
max_devices, „Die Geräteobergrenze dieses Kontos ist erreicht.“	Geräte (43, 77 oder 403 je nach Tarif)	Nicht genutzte Geräte löschen (Beispielgeräte, isolierte Geräte) oder den Tarif wechseln
„Ihr Tarif erlaubt n Flows: m sind in Verwendung, und diese Bereitstellung fügt k hinzu.“	Flows oder Skriptblöcke	Flows löschen oder zusammenführen; siehe Flow-Grenzen
„Ihr Tarif erlaubt {limit} Kameras mit Live-Ansicht, und {current} von {limit} sind belegt.“	Kameras mit Live-Ansicht (12)	Live-Ansicht bei einer Kamera ausschalten, die Sie nicht beobachten
Kamerarminuten aufgebraucht	Monatliche Kamerarminuten (10.000)	Auf den nächsten Monat warten oder ein Nutzungspaket buchen
„Das Datenvolumen für Panels in diesem Monat ist aufgebraucht.“	Router-Datenvolumen für Panels (10 GiB im Monat)	Auf den nächsten Monat warten
key_limit (im Lauf eines Flows)	Telemetrie-Schlüssel (250, 400 oder 2.050)	Nicht benötigte Schlüssel entfernen, bevor Sie Telemetrie speichern
FEATURE_NOT_AVAILABLE	Ihr Tarif enthält die Funktion nicht	Meine Module aufrufen

Das monatliche IoT-Nachrichtenkontingent erzeugt nie einen Fehler: Geräte senden auch darüber hinaus weiter. Siehe Grenzen und Kontingente.

REST-API

Status und code	Bedeutung	Abhilfe
400 VALIDATION_ERROR, „Validation error“ mit issues	Ein Feld verletzt eine Regel	issues[].path und message lesen
400 „Malformed request body“	Der Textkörper ist kein gültiges JSON	Das JSON korrigieren
401 UNAUTHORIZED, „Invalid or expired API key.“	Ein Tippfehler, ein abgelaufener oder widerrufener Schlüssel oder der Schlüssel einer anderen Organisation	Den Schlüssel und die tenantId im Pfad prüfen
403 „API key does not have the required permission.“	Dem Schlüssel fehlt die Berechtigung der Route	Die Modulberechtigungen des Schlüssels bearbeiten
403 „You are not permitted to perform this action“	Der Inhaber des Schlüssels hat die Berechtigung nicht mehr	Rolle, Gruppen und Zugriffsrichtlinien des Inhabers prüfen
403 „This API key may not be used from the current IP address.“	Die IP-Positivliste des Schlüssels oder der Organisation	Aus einem erlaubten Netz aufrufen
403 TENANT_IP_NOT_ALLOWED	Die IP-Zugriffslisten der Organisation lehnen die Adresse ab	Ein erlaubtes Netz verwenden
403 TENANT_SUSPENDED, TENANT_INACTIVE	Die Organisation ist nicht aktiv	Einen Inhaber fragen
404 NOT_FOUND	Nicht gefunden oder für Sie nicht sichtbar	ID und Berechtigungen prüfen
409 CONFLICT	Ein Duplikat, ein verwendeter Datensatz, ein Zustand, der die Aktion verbietet, oder eine gleichzeitige Änderung	Erneut lesen, dann entscheiden
412, 428	If-Match ist veraltet oder fehlt	Erneut lesen und mit der neuen Version senden
413	Textkörper oder Datei zu groß	Weniger senden
429 RATE_LIMIT_EXCEEDED, „Too many requests. Please try again later.“	Das Limit je Adresse (120 pro Minute)	Retry-After abwarten
429 „API key rate limit exceeded. Please slow down.“	Das Limit je Schlüssel (standardmäßig 1.000 pro Minute)	Aufrufe verteilen
429 „Your plan’s API rate limit has been reached…“	Die Tarifgrenze der Organisation	Aufrufe verteilen oder den Tarif wechseln
503 TENANT_READ_ONLY, „This workspace is read-only while it is being moved. Please try again later.“	Die Organisation wird gerade umgezogen	Nach Retry-After (300 s) erneut versuchen; Lesezugriffe funktionieren

Siehe Fehler und Ratenbegrenzungen.

Geräteanmeldungen und Nachrichten

Code	Bedeutung	Abhilfe
CONNACK 1	MQTT-Version nicht unterstützt	MQTT 3.1.1 verwenden
CONNACK 2	Client-ID abgelehnt	1 bis 64 Zeichen aus A–Z a–z 0–9 . _ : -
CONNACK 3	Server nicht verfügbar oder die Adresse ist nach fehlgeschlagenen Anmeldungen kurz gesperrt	Mit Jitter zurückhalten; Gerät mit falschen Zugangsdaten korrigieren
CONNACK 4	Benutzername oder Passwort falsch	Zugangsdaten prüfen oder rotieren
CONNACK 5	Nicht autorisiert; der Grund steht auf der Registerkarte Protokoll des Geräts	Siehe Ein Gerät verbindet sich nicht
unknown_reserved_topic	An ein unbekanntes Topic unter v1/ veröffentlicht	Ein dokumentiertes Topic verwenden
forbidden_topic	Ein Downlink-Topic, ein Gateway-Topic von einem Nicht-Gateway oder Provisionierung außerhalb einer Provisionierungssitzung	Das passende Topic für das Gerät verwenden
tls_required (HTTP 403)	Eine Befehlsabfrage über unverschlüsseltes HTTP, die das Profil nicht erlaubt	HTTPS verwenden
child_limit, device_limit	Ein Gateway-Untergerät über der Untergeräte-Grenze des Gateways oder der Geräte-Grenze des Tarifs	Das Maximum an Untergeräten eines Gateways des Profils erhöhen oder Geräte freigeben
child_rate_limited	Ein Gateway-Untergerät über seinen eigenen Ratenbegrenzungen	Die Rate des Untergeräts senken

Gespeicherte Daten

Code	Bedeutung
key_invalid, key_too_long, key_reserved	Der Schlüssel verletzt eine Schlüsselregel: Zeichen, 64 Zeichen oder ein reserviertes Präfix (_, fw_, current_fw_, cfg.)
string_too_long, value_too_large	Text über 1.024 Zeichen; JSON über 4 KiB; eine Zahl, die nicht endlich ist
bad_form	Kein Format, das der Speicher lesen kann, oder mehr als 1.000 Messpunkte in einer Nachricht
bad_ts	Ein Zeitstempel, der nicht in Epochen-Millisekunden angegeben ist, zu weit in der Zukunft liegt (standardmäßig 10 Minuten) oder älter ist, als die Einstellungen erlauben
too_old	Älter, als Ihre Aufbewahrungsklasse Rohdaten behält
no_values	Im Datensatz konnte nichts gespeichert werden
not_a_device	Ein Telemetrie speichern in einem Flow, der durch einen Zeitplan, einen Inject, ein Ereignis oder einen Webhook gestartet wurde und nicht ein Gerät betrifft
range_too_large (History-API, 400)	Mehr als 10.000 Intervalle im Zeitfenster

Siehe Daten kommen nicht an.

Befehle

Grund	Bedeutung
bad_params	Die Parameter passen nicht zum Befehl
wait_too_long	Ein synchroner Aufruf wartet höchstens 30 s; wait: false verwenden
confirm_required, confirm_text_mismatch	Ein Befehl mit hoher Auswirkung braucht confirm: true, oder der eingegebene Text ist falsch
method_refused	Werksreset, Kopplung, Vergessen des WLAN und Vergessen der Cloud werden nie gesendet
rpc_method_reserved	Die Methode gehört zu einem anderen Modul
rpc_not_supported_by_profile	Das Profil verwendet nur die Legacy-Topics
device_not_active	Das Gerät ist deaktiviert oder isoliert
not_cancellable	Nur ein eingereihter oder gesendeter Befehl kann abgebrochen werden
device_rate_limited, „Too many commands to this device; try again in a minute.“	Mehr als 10 Befehle pro Minute an ein Gerät

Siehe Befehle erreichen das Gerät nicht.

Flows

Code oder Meldung	Bedeutung
circuit_open	Die ausgehenden Aufrufe eines Blocks sind wiederholt fehlgeschlagen und werden pausiert; er erholt sich von selbst
ssrf_blocked	Die Adresse ist privat, steht nicht auf den erlaubten Hosts des Endpunkts oder verlässt den Basispfad
timeout, memory, blocked (Skript)	Das Skript hat mehr als seine CPU-Zeit (standardmäßig 50 ms) oder 32 MiB verbraucht; nach drei Abbrüchen in Folge wird es 60 Sekunden gesperrt
script_unavailable, host_busy	Der Skriptdienst ist nicht erreichbar oder ausgelastet; später erneut versuchen
queue_full	Ein Block hält zu viele Nachrichten oder Schlüssel
flow_cycle	Flows lösen sich gegenseitig in einem Kreislauf aus
„Diese Blöcke senden Nachrichten in einer Schleife, die nie wartet“	Ein Zyklus ohne wartenden Block in einem Flow
no_recipients, too_many_recipients, members_unavailable, invalid_attachment, notify_failed, limit	Notify-Fehler: niemand zum Benachrichtigen, nach den Rollen mehr als 20 Empfänger, Mitglieder konnten nicht gelesen werden, ein fehlerhafter Anhang, alle Zustellungen fehlgeschlagen, jeder Kanal ohne Kontingent

Siehe Fehlerbehebung bei Flows.

Alarme und Regeln

Meldung	Abhilfe
„Ein Schlüssel benennt einen Telemetrie-Schlüssel: keine Leerzeichen und keine Zahl.“	Den Wert in Value eintragen, nicht in Key
„Eine andere Regel dieses Profils hat diesen Typ.“	Pro Profil einen eindeutigen Typ verwenden
„Zwischen 10 Sekunden und 7 Tagen.“	Die Offline-Verzögerung liegt außerhalb des Bereichs
„Eine Stummschaltung darf höchstens 90 Tage dauern.“	Ein früheres Ende wählen
„Sonnenaufgang und Sonnenuntergang benötigen den Standort des Orts: zuerst am Ort festlegen.“	Breiten- und Längengrad am Asset festlegen
„Höchstens 20 Aktionen, einschließlich derer in choices.“	Die Regel der Rules-Karte aufteilen
„Dieser Gerätetyp hat keinen solchen Befehl.“	Den Befehl zum Katalog des Profils hinzufügen

Profile, Assets und Boards

Meldung	Abhilfe
„Noch in Verwendung durch …: zuerst verschieben oder entfernen.“	Ein Profil, das noch von Geräten, Alarmregeln oder Befehlen verwendet wird, kann nicht gelöscht werden
„zuerst ein anderes Profil als Standard festlegen“	Das Standardprofil kann nicht gelöscht werden
„Ein Asset mit untergeordneten Assets kann nicht gelöscht werden.“	Zuerst die untergeordneten Assets löschen oder verschieben
„Diese Datei ist kein Dashboard-Paket, das diese Version versteht.“	Eine aus einem Dashboard exportierte Board-Datei importieren
„Nichts in diesem Paket kann hier importiert werden.“	Zuerst die Module oder Widgets installieren, die das Board benötigt

Anmeldung

Meldung	Abhilfe
„Dieses Konto ist nach zu vielen fehlgeschlagenen Anmeldversuchen gesperrt. Versuchen Sie es später erneut oder setzen Sie Ihr Passwort zurück.“	Warten oder Passwort zurücksetzen
„Zu viele falsche Codes. Bitte warten Sie einige Minuten und versuchen Sie es erneut.“	Warten
„Diese Organisation verlangt eine Zwei-Faktor-Bestätigung. Melden Sie sich erneut an und schließen Sie sie ab.“	Einen Passkey hinzufügen und sich damit anmelden
„Dieses Konto ist aus Sicherheitsgründen gesperrt…“	Support kontaktieren

Siehe Probleme bei der Anmeldung.

Kameras und Router-Panels

Meldung oder Code	Abhilfe
„Das Bild wurde zu oft angefragt. Warten Sie einen Moment und versuchen Sie es erneut.“	Mehr als 24 Live-Link-Anfragen pro Minute für eine Kamera
„Auf dieser Installation werden gerade zu viele Kameras beobachtet. Versuchen Sie es in einem Moment erneut.“	Die Kapazität der Installation; erneut versuchen
ttl_idle, ttl_hard, lte_cap, no_dial … (Panel-Sitzung Ended because)	Siehe Grenzen und Prüfung des Fernzugriffs

Verwandt

• Grenzen und Kontingente
• Fehler und Ratenbegrenzungen
• Hilfe erhalten