Cause. L'objet n'existe pas, ou il n'est pas visible pour l'appelant. Kyvernon donne la même réponse dans les deux cas, afin qu'un appelant sans accès ne puisse pas savoir si un objet existe. L'objet a peut-être été supprimé, ou l'identifiant est incorrect.
Solution.
Actualisez l'inventaire dans la console, ou listez à nouveau les objets : kyvernon inventory search <name>.
Vérifiez l'identifiant utilisé. Les identifiants ont la forme <kind>-<number>.
Si l'objet devrait exister, demandez à un administrateur si votre rôle y donne accès : kyvernon privileges check <entity> <privilege>.
error.already_exists
Texte dans la console
Un objet portant ce nom ou cet ID existe déjà. Choisissez un autre nom.
Cause. L'objet a changé entre le moment où vous l'avez lu et celui où vous l'avez enregistré. Chaque modification nomme la version sur laquelle elle repose (expectedVersion dans l'API, If-Match pour le pare-feu), et cette version n'est plus la version courante.
Solution.
Rechargez l'objet dans la console, ou lisez-le à nouveau : kyvernon inventory get <id>.
Appliquez à nouveau votre modification à la version que vous avez lue. Avec la CLI, donnez la nouvelle version : kyvernon inventory update <id> --expected-version <version> --body-file <file>.
error.unauthenticated
Texte dans la console
Vous n’êtes pas connecté. Connectez-vous, puis réessayez.
Cause. La requête ne contient aucun jeton porteur, ou le jeton n'est pas valide : il a expiré, a été révoqué, ou appartient à une session terminée.
Solution.
Connectez-vous à nouveau : kyvernon login <username> --save. Dans la console, utilisez Connexion.
Les clients d'API vérifient que l'en-tête Authorization: Bearer <token> est envoyé et que le jeton d'API n'a pas expiré : kyvernon auth api-tokens list.
error.permission_denied
Texte dans la console
La requête a été refusée. Votre rôle n’inclut pas le privilège requis. Demandez l’accès à un administrateur.
Cause. L'utilisateur, ou le jeton, détient un rôle sans le privilège dont l'opération a besoin sur cet objet. Le privilège est nommé dans l'argument privilege de la réponse de l'API.
Solution.
Vérifiez le privilège dans la réponse, puis ce que votre rôle contient : kyvernon privileges check <entity> <privilege>.
Demandez à un administrateur un rôle qui inclut le privilège sur cet objet. L'administrateur l'accorde avec kyvernon permissions set <entity> <principal> --role <role>.
Transmettez l'identifiant de message, le nom du privilège et l'heure.
error.audit_record_immutable
Texte dans la console
Les enregistrements d’audit ne peuvent pas être supprimés.
Cause. Une requête a tenté de supprimer un enregistrement d'audit. Les enregistrements d'audit sont en ajout seul, et aucun rôle ne peut les supprimer.
Solution.
Ne supprimez pas d'enregistrements d'audit. Retirez la requête du script ou de l'outil qui l'envoie.
Pour limiter la durée de conservation des enregistrements d'audit, un administrateur définit audit_age dans la section [retention] de la configuration du contrôleur. Kyvernon supprime lui-même les enregistrements plus anciens.