Référence Pour: administrateurs, utilisateurs, locataires, développeurs

Erreurs de jeton d'API

Causes et solutions des codes d'erreur renvoyés à la création d'un jeton d'API.

error.api_token.name

Texte dans la console
Le jeton d’API doit avoir un nom de 1 à 64 caractères.
Signification pour les clients de l'API
The API token name is empty or too long.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentContenu
fieldle champ de la requête qui contient la valeur refusée, ici name.

Cause. Le nom du jeton est vide une fois les espaces de début et de fin retirés, compte plus de 64 caractères ou contient un caractère de contrôle.

Solution.

  1. Donnez au jeton un nom de 1 à 64 caractères sans caractère de contrôle.
  2. Créez à nouveau le jeton : kyvernon auth api-tokens create <name> pour votre propre compte, ou kyvernon users api-tokens <username> create <name> pour un autre compte.

error.api_token.limit

Texte dans la console
Ce compte possède déjà {max} jetons d’API. Supprimez-en un avant d’en créer un autre.
Signification pour les clients de l'API
The user has max API tokens already.
Code
RESOURCE_EXHAUSTED, HTTP 429
ArgumentContenu
maxle nombre de jetons d'API qu'un compte peut détenir.

Cause. Le compte détient déjà le plus grand nombre de jetons d'API qu'un compte peut avoir (16).

Solution.

  1. Listez les jetons du compte : kyvernon auth api-tokens list.
  2. Supprimez un jeton qui n'est plus utilisé : kyvernon auth api-tokens delete <id>.
  3. Créez à nouveau le nouveau jeton.

error.api_token.ttl

Texte dans la console
La durée de validité du jeton doit être d’au moins une seconde et d’au plus {max} secondes.
Signification pour les clients de l'API
The API token lifetime is zero or longer than the maximum of max seconds.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentContenu
fieldle champ de la requête qui contient la valeur refusée, ici ttlSeconds.
maxla durée de vie maximale en secondes.

Cause. La durée de vie demandée est nulle, ou plus longue que le maximum autorisé par le contrôleur. Le maximum est le paramètre api_token_max_ttl de la section [identity.policy] de la configuration du contrôleur (365 jours par défaut).

Solution.

  1. Demandez une durée d'au moins une seconde et d'au plus la valeur indiquée dans le message : kyvernon auth api-tokens create <name> --ttl <seconds>.
  2. Omettez --ttl pour prendre le maximum du contrôleur.
  3. Si une durée plus longue est nécessaire, un administrateur augmente api_token_max_ttl. Transmettez-lui l'identifiant de message error.api_token.ttl et la durée dont vous avez besoin.

Version 0.1. Dernière modification : 2026-11-13