借助 FabricClient API,群集和应用程序管理员可以对 Service Fabric 应用程序、服务或群集执行管理任务。 例如,部署、升级和删除应用程序、检查群集的运行状况或测试服务。 应用程序开发人员和群集管理员可以使用 FabricClient API 来开发用于管理 Service Fabric 群集和应用程序的工具。
使用 FabricClient 可以执行许多不同类型的操作。 由于输入错误、运行时错误或暂时性基础结构问题,每种方法可能会引发异常或错误。 请参阅 API 参考文档,以查找特定的方法会引发哪些异常。 不过,某些异常可能会由多个不同的 FabricClient API 引发。 下表列出了 FabricClient API 引发的常见异常。
例外 | 引发时机 |
---|---|
System.Fabric.FabricObjectClosedException | FabricClient 对象处于关闭状态。 释放正在使用的 FabricClient 对象,并实例化新的 FabricClient 对象。 |
System.TimeoutException | 操作超时。如果完成操作花费的时间超过 MaxOperationTimeout,将返回 OperationTimedOut。 |
System.UnauthorizedAccessException | 对操作的访问权限检查失败。 返回了 E_ACCESSDENIED。 |
System.Fabric.FabricException | 执行操作时发生运行时错误。 任何 FabricClient 方法都可能引发 FabricException,ErrorCode 属性将指示异常的确切原因。 FabricErrorCode 枚举中将定义错误代码。 |
System.Fabric.FabricTransientException | 由于出现某种暂时性错误状态,操作失败。 例如,由于副本的仲裁暂时不可访问,某项操作可能会失败。 暂时性异常对应于可重试的失败操作。 |
可能在 FabricException 中返回的某些常见 FabricErrorCode 错误:
Error | 天气条件 |
---|---|
CommunicationError | 通信错误导致操作失败,请重试操作。 |
InvalidCredentialType | 凭据类型无效。 |
InvalidX509FindType | X509FindType 无效。 |
InvalidX509StoreLocation | X509 存储位置无效。 |
InvalidX509StoreName | X509 存储名称无效。 |
InvalidX509Thumbprint | X509 证书指纹字符串无效。 |
InvalidProtectionLevel | 保护级别无效。 |
InvalidX509Store | 无法打开 X509 证书存储。 |
InvalidSubjectName | 使用者名称无效。 |
InvalidAllowedCommonNameList | 公用名字符串列表的格式无效。 应为逗号分隔的列表。 |