Codici di errore

Nel Babel Licensing Service i codici di errore hanno un ruolo fondamentale nel comunicare e gestire in modo efficiente i vari problemi che possono presentarsi nelle interazioni con il sistema di licenze. Questi codici, insieme alle rispettive descrizioni, vengono usati per costruire messaggi di errore dettagliati che aiutano a capire la natura dei problemi riscontrati.

Questo insieme di codici di errore è pensato per individuare e classificare gli errori relativi a tre funzionalità principali del server nel Babel Licensing Service: licenze flottanti, attivazione delle licenze e report. Ogni codice di errore corrisponde a uno scenario preciso, così sviluppatori e client possono identificare rapidamente un problema specifico e reagire di conseguenza.

Di seguito trovi l’elenco completo dei codici di errore, suddivisi per funzionalità, con una breve descrizione della natura di ciascun errore. Lo StatusCode indica lo stato della RpcException corrispondente che il Babel Licensing Service restituisce al client.

Errori comuni

Questa categoria comprende una serie di problemi frequenti che possono verificarsi in diverse funzionalità del Babel Licensing Service. Sono errori di base e riguardano sia le licenze flottanti sia l’attivazione delle licenze.

• 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). Vedi Token di licenza

Errori delle licenze flottanti

Questa categoria riguarda in modo specifico gli errori legati all’uso e alla gestione delle licenze flottanti nel 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)

Errori di attivazione della licenza

Questa categoria comprende una serie di errori che possono verificarsi durante l’attivazione della licenza, come la necessità di un codice del computer valido per completare l’attivazione.

• 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). Dalla 12.0.7 l’attivazione non lo restituisce più: un computer che esegue di nuovo l’attivazione riottiene la sua attivazione esistente.
• LicenseNotActivated: “The license has not been activated” (StatusCode.FailedPrecondition)
• LicenseNotActivationMode: “Cannot use this license for activation” (StatusCode.FailedPrecondition)

Errori di reporting

Questa categoria riguarda i problemi legati in modo specifico alle funzionalità di reporting del Babel Licensing Service.

• NotAuthorizedToSendReport: “Client is not authorized to send reports” (StatusCode.PermissionDenied)

Questi codici StatusCode indicano il tipo di stato gRPC associato a ciascun messaggio di errore. Insieme alle descrizioni degli errori servono a costruire le istanze della classe Status con cui il Babel Licensing Service restituisce alle applicazioni client gli errori gRPC di tipo RpcException.