Proposed Pull Request Change

📄 Document Links

View on GitHub View on Microsoft Learn

--- title: Common FabricClient exceptions thrown description: Describes the common exceptions and errors that can be thrown by the FabricClient APIs while performing application and cluster management operations. ms.topic: how-to ms.author: tomcassidy author: tomvcassidy ms.service: azure-service-fabric services: service-fabric ms.date: 03/22/2026 # Customer intent: As a cluster administrator, I want to understand the common exceptions thrown by the FabricClient APIs, so that I can effectively troubleshoot and manage application and cluster operations. --- # Common exceptions and errors when working with the FabricClient APIs The [FabricClient](/dotnet/api/system.fabric.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 that 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](/dotnet/api/system.fabric.fabricclient) APIs. The following table lists the exceptions that are common across the FabricClient APIs. | Exception | Thrown when | | --- |:--- | | [System.Fabric.FabricObjectClosedException](/dotnet/api/system.fabric.fabricobjectclosedexception) |The [FabricClient](/dotnet/api/system.fabric.fabricclient) object is in a closed state. Dispose of the [FabricClient](/dotnet/api/system.fabric.fabricclient) object you're using and instantiate a new [FabricClient](/dotnet/api/system.fabric.fabricclient) object. | | [System.TimeoutException](/dotnet/core/api/system.timeoutexception) |The operation timed out. [OperationTimedOut](/dotnet/api/system.fabric.fabricerrorcode) is returned when the operation takes more than MaxOperationTimeout to complete. | | [System.UnauthorizedAccessException](/dotnet/core/api/system.unauthorizedaccessexception) |The access check for the operation failed. E_ACCESSDENIED is returned. | | [System.Fabric.FabricException](/dotnet/api/system.fabric.fabricexception) |A runtime error occurred while performing the operation. Any of the FabricClient methods can potentially throw [FabricException](/dotnet/api/system.fabric.fabricexception), the [ErrorCode](/dotnet/api/system.fabric.fabricexception.errorcode) property indicates the exact cause of the exception. Error codes are defined in the [FabricErrorCode](/dotnet/api/system.fabric.fabricerrorcode) enumeration. | | [System.Fabric.FabricTransientException](/dotnet/api/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](/dotnet/api/system.fabric.fabricerrorcode) errors that can be returned in a [FabricException](/dotnet/api/system.fabric.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 can't 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. |