Codes d’erreur

Dans le Babel Licensing Service, les codes d’erreur servent à signaler et à traiter efficacement les problèmes qui peuvent survenir lors des échanges avec le système de gestion des licences. Ces codes d’erreur et leurs descriptions servent à construire des messages d’erreur détaillés, qui renseignent sur la nature des problèmes rencontrés.

Cet ensemble de codes d’erreur est conçu pour traiter et classer les erreurs liées à trois grandes fonctionnalités serveur du Babel Licensing Service : les licences flottantes, l’activation de licence et les rapports. Chaque code d’erreur correspond à un scénario unique, ce qui permet aux développeurs et aux applications clientes d’identifier rapidement un problème précis et d’y répondre.

Vous trouverez ci-dessous la liste complète des codes d’erreur, classés par fonctionnalité, avec une brève description de la nature de chaque erreur. Le StatusCode désigne l’état de l’exception RpcException correspondante que le Babel Licensing Service renvoie au client.

Erreurs communes

Cette catégorie regroupe des problèmes fréquents, qui peuvent survenir dans différentes fonctionnalités du Babel Licensing Service. Ces erreurs sont de nature fondamentale et concernent à la fois les licences flottantes et l’activation de licence.

• LicenseKeyNotFound : « License key not found » (StatusCode.NotFound)
• LicenseRevoked : « The license has been revoked » (StatusCode.PermissionDenied)
• LicenseExpired : « The license has expired » (StatusCode.PermissionDenied)
• TokenExpired : « The license token has expired » (StatusCode.PermissionDenied)
• LicenseTampered : « The license has been tampered » (StatusCode.DataLoss)
• TokenNotFound : « License token not found » (StatusCode.NotFound)
• TokenTampered : « License token has been tampered » (StatusCode.DataLoss)
• ServerReachedMaxTokenAllowed : « The server has reached the maximum number of license tokens allowed » (StatusCode.PermissionDenied). Voir Jetons de licence

Erreurs de licence flottante

Cette catégorie concerne les erreurs liées à l’utilisation et à la gestion des licences flottantes dans le Babel Licensing Service.

• LicenseReachedMaxClients : « The maximum number of concurrent users for the license has been reached » (StatusCode.ResourceExhausted)
• LicenseAlreadyAssigned : « The requested floating license has already been assigned » (StatusCode.InvalidArgument)

Erreurs d’activation de licence

Cette catégorie regroupe les erreurs qui peuvent survenir pendant l’activation de licence, par exemple lorsqu’un code machine valide est nécessaire pour activer la licence.

• MachineCodeRequiredToActivate : « The machine code is required for license activation » (StatusCode.InvalidArgument)
• LicenseTemplateNotFound : « A license template could not be found for the selected license » (StatusCode.NotFound)
• LicenseMaxActivationReached : « The license has reached the maximum number of activations allowed » (StatusCode.ResourceExhausted)
• LicenseAlreadyActivated : « The license has already been activated » (StatusCode.AlreadyExists). Depuis la version 12.0.7, l’activation ne renvoie plus ce code : une machine qui s’active de nouveau retrouve son activation existante.
• LicenseNotActivated : « The license has not been activated » (StatusCode.FailedPrecondition)
• LicenseNotActivationMode : « Cannot use this license for activation » (StatusCode.FailedPrecondition)

Erreurs de rapports

Cette catégorie concerne les problèmes liés aux fonctionnalités de rapports du Babel Licensing Service.

• NotAuthorizedToSendReport : « Client is not authorized to send reports » (StatusCode.PermissionDenied)

Ces codes StatusCode indiquent le type d’état gRPC associé à chaque message d’erreur. Avec les descriptions des erreurs, ils servent à construire les instances de la classe Status au moyen desquelles le Babel Licensing Service renvoie aux applications clientes des erreurs gRPC de type RpcException.