Common exceptions and errors when working with the FabricClient APIs
The FabricClient APIs enable cluster and application administrators to perform administrative tasks on a Service Fabric application, service, or cluster. For example, application deployment, upgrade, and removal, checking the health a cluster, or testing a service. Application developers and cluster administrators can use the FabricClient APIs to develop tools for managing the Service Fabric cluster and applications.
There are many different types of operations which can be performed using FabricClient. Each method can throw exceptions for errors due to incorrect input, runtime errors, or transient infrastructure issues. See the API reference documentation to find which exceptions are thrown by a specific method. There are some exceptions, however, which can be thrown by many different FabricClient APIs. The following table lists the exceptions that are common across the FabricClient APIs.
| Exception | Thrown when |
|---|---|
| System.Fabric.FabricObjectClosedException | The FabricClient object is in a closed state. Dispose of the FabricClient object you are using and instantiate a new FabricClient object. |
| System.TimeoutException | The operation timed out. OperationTimedOut is returned when the operation takes more than MaxOperationTimeout to complete. |
| System.UnauthorizedAccessException | The access check for the operation failed. E_ACCESSDENIED is returned. |
| System.Fabric.FabricException | A runtime error occurred while performing the operation. Any of the FabricClient methods can potentially throw FabricException, the ErrorCode property indicates the exact cause of the exception. Error codes are defined in the FabricErrorCode enumeration. |
| System.Fabric.FabricTransientException | The operation failed due to a transient error condition of some kind. For example, an operation may fail because a quorum of replicas is temporarily not reachable. Transient exceptions correspond to failed operations that can be retried. |
Some common FabricErrorCode errors that can be returned in a FabricException:
| Error | Condition |
|---|---|
| CommunicationError | A communication error caused the operation to fail, retry the operation. |
| InvalidCredentialType | The credential type is invalid. |
| InvalidX509FindType | The X509FindType is invalid. |
| InvalidX509StoreLocation | The X509 store location is invalid. |
| InvalidX509StoreName | The X509 store name is invalid. |
| InvalidX509Thumbprint | The X509 certificate thumbprint string is invalid. |
| InvalidProtectionLevel | The protection level is invalid. |
| InvalidX509Store | The X509 certificate store cannot be opened. |
| InvalidSubjectName | The subject name is invalid. |
| InvalidAllowedCommonNameList | The format of common name list string is invalid. It should be a comma-separated list. |