Errori ed eccezioni comuni quando si usano le API FabricClientCommon exceptions and errors when working with the FabricClient APIs

Le API FabricClient consentono agli amministratori di cluster e applicazioni di eseguire attività amministrative su applicazioni, servizi o cluster di Service Fabric.The FabricClient APIs enable cluster and application administrators to perform administrative tasks on a Service Fabric application, service, or cluster. Ad esempio, la distribuzione, l'aggiornamento e la rimozione di applicazioni, il controllo dell'integrità di un cluster o il test di un servizio.For example, application deployment, upgrade, and removal, checking the health a cluster, or testing a service. Gli sviluppatori di applicazioni e gli amministratori di cluster possono usare le API FabricClient per sviluppare strumenti per la gestione del cluster e delle applicazioni Service Fabric.Application developers and cluster administrators can use the FabricClient APIs to develop tools for managing the Service Fabric cluster and applications.

Esistono molti tipi diversi di operazioni che possono essere eseguite tramite FabricClient.There are many different types of operations which can be performed using FabricClient. Ogni metodo può generare eccezioni per errori dovuti a input non corretti, errori di runtime o problemi temporanei dell'infrastruttura.Each method can throw exceptions for errors due to incorrect input, runtime errors, or transient infrastructure issues. Per individuare le eccezioni generate da un metodo specifico, vedere la documentazione di riferimento delle API.See the API reference documentation to find which exceptions are thrown by a specific method. Esistono alcune eccezioni, tuttavia, che possono essere generate da diverse API FabricClient.There are some exceptions, however, which can be thrown by many different FabricClient APIs. Nella tabella seguente vengono elencate le eccezioni comuni alle API FabricClient.The following table lists the exceptions that are common across the FabricClient APIs.

EccezioneException Generata quandoThrown when
System.Fabric.FabricObjectClosedExceptionSystem.Fabric.FabricObjectClosedException L'oggetto FabricClient si trova in uno stato chiuso.The FabricClient object is in a closed state. Eliminare l'oggetto FabricClient in uso e creare un'istanza di un nuovo oggetto FabricClient.Dispose of the FabricClient object you are using and instantiate a new FabricClient object.
System.TimeoutExceptionSystem.TimeoutException L'operazione ha raggiunto il timeout. OperationTimedOut viene restituito quando per il completamento dell'operazione occorre più tempo di quello stabilito in MaxOperationTimeout.The operation timed out. OperationTimedOut is returned when the operation takes more than MaxOperationTimeout to complete.
System.UnauthorizedAccessExceptionSystem.UnauthorizedAccessException Il controllo di accesso per l'operazione non è riuscito.The access check for the operation failed. Viene restituito E_ACCESSDENIED.E_ACCESSDENIED is returned.
System.Fabric.FabricExceptionSystem.Fabric.FabricException Si è verificato un errore di runtime durante l'operazione.A runtime error occurred while performing the operation. Tutti i metodi FabricClient possono potenzialmente generare un'eccezione FabricException. La proprietà ErrorCode indica la causa esatta dell'eccezione.Any of the FabricClient methods can potentially throw FabricException, the ErrorCode property indicates the exact cause of the exception. I codici di errore sono definiti nell'enumerazione FabricErrorCode.Error codes are defined in the FabricErrorCode enumeration.
System.Fabric.FabricTransientExceptionSystem.Fabric.FabricTransientException L'operazione non è riuscita a causa di una condizione di errore temporanea.The operation failed due to a transient error condition of some kind. Ad esempio, un'operazione potrebbe non riuscire perché un quorum di repliche non è temporaneamente raggiungibile.For example, an operation may fail because a quorum of replicas is temporarily not reachable. Le eccezioni temporanee corrispondono alle operazioni non riuscite che è possibile ritentare.Transient exceptions correspond to failed operations that can be retried.

Alcuni errori FabricErrorCode comuni che possono essere restituiti in un'eccezione FabricException:Some common FabricErrorCode errors that can be returned in a FabricException:

ErroreError CondizioneCondition
CommunicationErrorCommunicationError L'operazione non è riuscita a causa di un errore di comunicazione, ripetere l'operazione.A communication error caused the operation to fail, retry the operation.
InvalidCredentialTypeInvalidCredentialType Il tipo di credenziale non è valido.The credential type is invalid.
InvalidX509FindTypeInvalidX509FindType Il tipo X509FindType non è valido.The X509FindType is invalid.
InvalidX509StoreLocationInvalidX509StoreLocation Il percorso dell'archivio X509 non è valido.The X509 store location is invalid.
InvalidX509StoreNameInvalidX509StoreName Il nome dell'archivio X509 non è valido.The X509 store name is invalid.
InvalidX509ThumbprintInvalidX509Thumbprint La stringa di identificazione personale del certificato X509 non è valida.The X509 certificate thumbprint string is invalid.
InvalidProtectionLevelInvalidProtectionLevel Il livello di protezione non è valido.The protection level is invalid.
InvalidX509StoreInvalidX509Store Non è possibile aprire l'archivio certificati X509.The X509 certificate store cannot be opened.
InvalidSubjectNameInvalidSubjectName Il nome soggetto non è valido.The subject name is invalid.
InvalidAllowedCommonNameListInvalidAllowedCommonNameList Il formato della stringa dell'elenco nomi comuni non è valido.The format of common name list string is invalid. Deve essere un elenco delimitato da virgole.It should be a comma-separated list.