Nouveau : le pare-feu IA surveille toute la plateforme et explique chaque incident en termes simples. Découvrez comment ça marche

Messages d’erreur

Messages d'erreur et codes courants de Hermetry : limites de forfait, API, connexions des appareils sous licence, données stockées, commandes, flux, alarmes, connexion – et que faire.

Cette page répertorie les messages d’erreur et les codes que les utilisateurs et les intégrations rencontrent le plus souvent, regroupés selon l’endroit où ils apparaissent, avec leur signification et la solution. Les messages sont cités tels que Hermetry les affiche. Les codes en code font sont stables et peuvent être utilisés sans risque dans votre propre gestion des erreurs ; les phrases peuvent changer. Pour une erreur non listée ici, recherchez dans la section de la fonctionnalité, ou consultez Obtenir de l’aide.

Limites du forfait

Une limite du forfait renvoie 403 avec details.key nommant la limite, details.limit sa valeur et details.current votre nombre.

details.key ou messageLimiteSolution
max_devices, « La limite d’appareils de ce compte est atteinte. »Appareils (43, 77 ou 403 selon le niveau)Supprimer les appareils inutilisés (appareils d’exemple, appareils en quarantaine) ou changer de forfait
« Votre forfait autorise n flux : m utilisés, et ce déploiement en ajoute k. »Flux ou blocs de scriptSupprimer ou fusionner des flux ; voir Limites des flux
« Votre forfait autorise 12 caméras avec visualisation en direct, et 12 sur 12 sont utilisées. »Caméras avec visualisation en direct (12)Désactiver la visualisation en direct sur une caméra que vous ne regardez pas
Minutes caméra épuiséesMinutes caméra mensuelles (10 000)Attendre le mois suivant, ou un pack de minutes supplémentaires
« Le quota mensuel de données du panneau est épuisé. »Données du panneau du routeur (10 GiB par mois)Attendre le mois suivant
key_limit (dans l’exécution d’un flux)Clés de télémétrie (250, 400 ou 2 050)Supprimer les clés inutiles avant Enregistrer la télémétrie
FEATURE_NOT_AVAILABLEVotre forfait ne comprend pas cette fonctionnalitéVoir Mes modules

Le quota mensuel de messages IoT ne produit jamais d’erreur : les appareils continuent d’envoyer au-delà. Voir Limites et quotas.

API REST

Statut et codeSignificationSolution
400 VALIDATION_ERROR, « Validation error » avec issuesUn champ ne respecte pas une règleLire issues[].path et message
400 « Corps de requête mal formé »Le corps n’est pas du JSON valideCorriger le JSON
401 UNAUTHORIZED, « Clé API invalide ou expirée. »Une faute de frappe, une clé expirée ou révoquée, ou la clé d’une autre organisationVérifier la clé et le tenantId dans le chemin
403 « La clé API ne dispose pas de l’autorisation requise. »La clé ne possède pas la permission de la routeModifier les Permissions du module de la clé
403 « Vous n’êtes pas autorisé à effectuer cette action »Le titulaire de la clé n’a plus la permissionVérifier le rôle, les groupes et les politiques d’accès du titulaire
403 « Cette clé d’API ne peut pas être utilisée depuis l’adresse IP actuelle. »La liste d’adresses IP autorisées de la clé ou de l’organisationAppeler depuis un réseau autorisé
403 TENANT_IP_NOT_ALLOWEDLes listes d’accès IP de l’organisation refusent l’adresseUtiliser un réseau autorisé
403 TENANT_SUSPENDED, TENANT_INACTIVEL’organisation n’est pas activeDemander à un propriétaire
404 NOT_FOUNDIntrouvable, ou non visible pour vousVérifier l’identifiant et les permissions
409 CONFLICTUn doublon, un enregistrement en cours d’utilisation, un état qui interdit l’action, ou une modification concurrenteRelire, puis décider
412, 428If-Match est périmé ou absentRelire puis renvoyer avec la nouvelle version
413Corps ou fichier trop volumineuxEnvoyer moins
429 RATE_LIMIT_EXCEEDED, « Trop de requêtes. Veuillez réessayer plus tard. »La limite par adresse (120 par minute)Attendre Retry-After
429 « Limite de débit de la clé API dépassée. Veuillez ralentir. »La limite par clé (1 000 par minute par défaut)Étaler les appels
429 « La limite de débit de l’API de votre offre a été atteinte… »La limite de forfait de l’organisationÉtaler les appels ou changer de forfait
503 TENANT_READ_ONLY, « Cet espace de travail est en lecture seule pendant son déplacement. Veuillez réessayer plus tard. »L’organisation est en cours de migrationRéessayer après Retry-After (300 s) ; les lectures fonctionnent

Voir Erreurs et limites de débit.

Connexions et messages des appareils

CodeSignificationSolution
CONNACK 1Version MQTT non prise en chargeUtiliser MQTT 3.1.1
CONNACK 2Identifiant client refuséDe 1 à 64 caractères parmi A–Z a–z 0–9 . _ : -
CONNACK 3Serveur indisponible, ou adresse brièvement bloquée après des connexions échouéesAttendre avec un délai aléatoire ; corriger l’appareil aux identifiants erronés
CONNACK 4Nom d’utilisateur ou mot de passe incorrectVérifier ou renouveler l’identifiant
CONNACK 5Non autorisé ; la raison figure dans l’onglet Journal de l’appareilVoir Un appareil ne se connecte pas
unknown_reserved_topicPublication sur un topic inconnu sous v1/Utiliser un topic documenté
forbidden_topicUn topic de liaison descendante, un topic de passerelle depuis un appareil qui n’en est pas une, ou un provisionnement hors session de provisionnementUtiliser le bon topic pour l’appareil
tls_required (HTTP 403)Une interrogation de commandes en HTTP simple que le profil n’autorise pasUtiliser HTTPS
child_limit, device_limitUn appareil enfant de passerelle au-delà de la limite d’enfants de la passerelle ou de la limite d’appareils du forfaitAugmenter Nombre max d’enfants d’une passerelle du profil, ou libérer des appareils
child_rate_limitedUn appareil enfant de passerelle au-delà de ses propres limites de débitRéduire le débit de l’enfant

Données stockées

CodeSignification
key_invalid, key_too_long, key_reservedLa clé enfreint une règle de clé : caractères, 64 caractères, ou un préfixe réservé (_, fw_, current_fw_, cfg.)
string_too_long, value_too_largeTexte de plus de 1 024 caractères ; JSON de plus de 4 KiB ; nombre non fini
bad_formForme que le stockage ne lit pas, ou plus de 1 000 points dans un message
bad_tsHorodatage non exprimé en millisecondes depuis l’époque, trop éloigné dans le futur (10 minutes par défaut) ou plus ancien que les réglages ne le permettent
too_oldPlus ancien que la durée de conservation de votre classe de rétention pour les données brutes
no_valuesRien dans l’enregistrement n’a pu être stocké
not_a_deviceUn Enregistrer la télémétrie dans un flux démarré par une planification, une injection, un événement ou un webhook, qui ne concerne pas un appareil
range_too_large (API d’historique, 400)Plus de 10 000 intervalles dans la fenêtre

Voir Les données n’arrivent pas.

Commandes

RaisonSignification
bad_paramsLes paramètres ne correspondent pas à la commande
wait_too_longUn appel synchrone attend au maximum 30 s ; utiliser wait: false
confirm_required, confirm_text_mismatchUne commande à fort impact exige confirm: true, ou le texte saisi est erroné
method_refusedLa réinitialisation d’usine, l’appairage, l’oubli du Wi-Fi et l’oubli du cloud ne sont jamais envoyés
rpc_method_reservedLa méthode appartient à un autre module
rpc_not_supported_by_profileLe profil n’utilise que les topics Legacy
device_not_activeL’appareil est désactivé ou en quarantaine
not_cancellableSeule une commande en file d’attente ou envoyée peut être annulée
device_rate_limited, « Trop de commandes envoyées à cet appareil ; réessayez dans une minute. »Plus de 10 commandes par minute vers un même appareil

Voir Les commandes n’atteignent pas l’appareil.

Flux

Code ou messageSignification
circuit_openLes appels sortants d’un bloc continuent d’échouer et sont suspendus ; il se rétablit de lui-même
ssrf_blockedL’adresse est privée, ne figure pas parmi les hôtes autorisés du point de terminaison, ou sort du chemin de base
timeout, memory, blocked (script)Le script a dépassé son temps CPU (50 ms par défaut) ou 32 MiB ; après trois arrêts d’affilée, il est bloqué pendant 60 secondes
script_unavailable, host_busyLe service de script est injoignable ou occupé ; réessayer plus tard
queue_fullUn bloc retient trop de messages ou de clés
flow_cycleDes flux se déclenchent mutuellement en boucle
« Ces blocs envoient des messages en boucle sans jamais attendre »Un cycle sans bloc d’attente dans un même flux
no_recipients, too_many_recipients, members_unavailable, invalid_attachment, notify_failed, limitErreurs de Notify : aucun destinataire à prévenir, plus de 20 destinataires après application des rôles, membres impossibles à lire, pièce jointe invalide, toutes les livraisons ont échoué, tous les canaux ont épuisé leur quota

Voir Dépannage des flux.

Alarmes et règles

MessageCorrectif
« Une clé désigne une clé de télémétrie : pas d’espaces et pas un nombre. »Saisissez la valeur dans Value, et non dans Key
« Une autre règle de ce profil a déjà ce type. »Utilisez un type unique par profil
« Entre 10 secondes et 7 jours. »Le délai avant hors ligne est hors plage
« Une mise en sourdine peut durer 90 jours au maximum. »Choisissez une fin plus proche
« Le lever et le coucher du soleil nécessitent la position du lieu : renseignez-la d’abord sur le lieu. »Renseignez la latitude et la longitude sur l’actif
« 20 actions au maximum, y compris celles contenues dans les choix. »Scindez la règle de la carte Rules
« Ce type d’appareil ne possède pas une telle commande. »Ajoutez la commande au catalogue du profil

Profils, actifs et cartes

MessageCorrectif
« Encore utilisé par … : déplacez-les ou supprimez-les d’abord. »Un profil encore utilisé par des appareils, des règles d’alarme ou des commandes ne peut pas être supprimé
« Définissez d’abord un autre profil par défaut. »Le profil par défaut ne peut pas être supprimé
« Un actif contenant des actifs enfants ne peut pas être supprimé. »Supprimez ou déplacez d’abord les enfants
« Ce fichier n’est pas un package de tableau de bord que cette version comprend. »Importez un fichier de carte exporté depuis un tableau de bord
« Rien dans ce package ne peut être importé ici. »Installez d’abord les modules ou widgets nécessaires à la carte

Connexion

MessageCorrectif
« Ce compte est verrouillé après trop de tentatives de connexion échouées. Réessayez plus tard ou réinitialisez votre mot de passe. »Attendez ou réinitialisez le mot de passe
« Trop de codes erronés. Veuillez patienter quelques minutes et réessayer. »Patientez
« Cette organisation exige une vérification en deux étapes. Reconnectez-vous et effectuez-la. »Ajoutez une clé d’accès et connectez-vous avec elle
« Ce compte est verrouillé pour des raisons de sécurité… »Contactez le support

Voir Problèmes de connexion.

Caméras et panneaux de routeur

Message ou codeCorrectif
« L’image a été demandée trop souvent. Patientez un moment et réessayez. »Plus de 24 demandes de lien en direct par minute pour une même caméra
« Trop de caméras sont consultées sur cette installation en ce moment. Réessayez dans un instant. »La capacité de l’installation ; réessayez
ttl_idle, ttl_hard, lte_cap, no_dial … (Ended because de la session du panneau)Voir Limites et audit de l’accès à distance

Voir aussi