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.