Häufige Hermetry-Fehlermeldungen und Codes – Planlimits, API, Geräteanmeldungen, gespeicherte Daten, Befehle, Flows, Alarme, Anmeldung – und was zu tun ist.
Diese Seite listet die Fehlermeldungen und Codes auf, denen Nutzer und Integrationen am häufigsten begegnen, gruppiert nach ihrem Auftreten, 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; Sätze können sich ändern. Für einen hier nicht aufgeführten Fehler suchen Sie im Abschnitt der jeweiligen Funktion oder lesen Sie Hilfe erhalten.
Plan-Limits
Ein Plan-Limit beantwortet 403 mit details.key, das das Limit benennt, details.limit mit seinem Wert und details.current mit Ihrer Anzahl.
details.key oder Meldung
Limit
Abhilfe
max_devices, „Das Gerätelimit dieses Kontos ist erreicht.“
Geräte (43, 77 oder 403 je nach Tarif)
Ungenutzte Geräte löschen (Beispielgeräte, in Quarantäne befindliche) oder den Plan ändern
„Ihr Plan 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-Limits
„Ihr Plan erlaubt 12 Kameras mit Live-Ansicht, und 12 von 12 sind belegt.“
Kameras mit Live-Ansicht (12)
Live-Ansicht bei einer Kamera ausschalten, die Sie nicht beobachten
Kameraminuten aufgebraucht
Monatliche Kameraminuten (10.000)
Auf den nächsten Monat warten oder ein Nutzungspaket buchen
„Das Datenkontingent des Routers für diesen Monat ist aufgebraucht.“
Mobilfunkdaten des Routers (10 GiB im Monat)
Auf den nächsten Monat warten
key_limit (im Lauf eines Flows)
Telemetrieschlüssel (250, 400 oder 2.050)
Nicht benötigte Schlüssel entfernen, bevor Sie Telemetrie speichern wählen
FEATURE_NOT_AVAILABLE
Ihr Plan enthält die Funktion nicht
Meine Module ansehen
Das monatliche IoT-Nachrichtenkontingent erzeugt nie einen Fehler: Geräte senden auch darüber hinaus weiter. Siehe Limits und Kontingente.
REST-API
Status und code
Bedeutung
Abhilfe
400VALIDATION_ERROR, „Validation error“ mit issues
Ein Feld verletzt eine Regel
issues[].path und message lesen
400 „Fehlerhafter Anfrage-Body“
Der Text ist kein gültiges JSON
JSON korrigieren
401UNAUTHORIZED, „Ungültiger oder abgelaufener API-Schlüssel.“
Ein Tippfehler, ein abgelaufener oder widerrufener Schlüssel oder der Schlüssel einer anderen Organisation
Schlüssel und die tenantId im Pfad prüfen
403 „Der API-Schlüssel hat nicht die erforderliche Berechtigung.“
Dem Schlüssel fehlt die Berechtigung der Route
Die Modulberechtigungen des Schlüssels bearbeiten
403 „Sie sind nicht berechtigt, diese Aktion auszuführen.“
Der Inhaber des Schlüssels hat die Berechtigung nicht mehr
Rolle, Gruppen und Zugriffsrichtlinien des Inhabers prüfen
403 „Dieser API-Schlüssel darf von der aktuellen IP-Adresse nicht verwendet werden.“
Die IP-Erlaubnisliste des Schlüssels oder der Organisation
Aus einem erlaubten Netz aufrufen
403TENANT_IP_NOT_ALLOWED
Die IP-Zugriffslisten der Organisation lehnen die Adresse ab
Ein erlaubtes Netz verwenden
403TENANT_SUSPENDED, TENANT_INACTIVE
Die Organisation ist nicht aktiv
Einen Inhaber fragen
404NOT_FOUND
Nicht gefunden oder für Sie nicht sichtbar
ID und Berechtigungen prüfen
409CONFLICT
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
Text oder Datei zu groß
Weniger senden
429RATE_LIMIT_EXCEEDED, „Zu viele Anfragen. Bitte versuchen Sie es später erneut.“
Das Limit pro Adresse (120 pro Minute)
Retry-After abwarten
429 „Ratenlimit des API-Schlüssels überschritten. Bitte reduzieren Sie die Anfragefrequenz.“
Das Limit pro Schlüssel (standardmäßig 1.000 pro Minute)
Aufrufe verteilen
429 „Das API-Ratenlimit Ihres Tarifs wurde erreicht…“
Das Plan-Limit der Organisation
Aufrufe verteilen oder den Plan ändern
503TENANT_READ_ONLY, „Dieser Workspace ist während der Verschiebung schreibgeschützt. Bitte versuchen Sie es später erneut.“
Die Organisation wird gerade umgezogen
Nach Retry-After (300 s) erneut versuchen; Lesezugriffe funktionieren
Ein Downlink-Topic, ein Gateway-Topic von einem Nicht-Gateway oder Provisionierung außerhalb einer Provisionierungssitzung
Das richtige Topic für das Gerät verwenden
tls_required (HTTP 403)
Eine Befehlsabfrage per einfachem HTTP, die das Profil nicht erlaubt
HTTPS verwenden
child_limit, device_limit
Ein Gateway-Kind über dem Kind-Limit des Gateways oder dem Geräte-Limit des Plans
Den Wert Max. Kinder eines Gateways des Profils erhöhen oder Geräte freigeben
child_rate_limited
Ein Gateway-Kind über seinen eigenen Rate-Limits
Die Rate des Kindes 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 Epoch-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 für Rohdaten
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 sich nicht auf ein Gerät bezieht
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 hat sein Kontingent ausgeschöpft