你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

FabricClient.ServiceManagementClient.RestartReplicaAsync 方法

定义

命名空间:

System.Fabric

程序集:

System.Fabric.dll

包:

Microsoft.ServiceFabric v9.1.1833

重载

RestartReplicaAsync(String, Guid, Int64)	重启节点上运行的持久性服务的服务副本。
RestartReplicaAsync(String, Guid, Int64, TimeSpan, CancellationToken)	重启节点上运行的持久性服务的服务副本。 还采用超时间隔，这是系统允许此操作在返回 TimeoutException 和操作观察到的取消标记之前继续的最长时间。

RestartReplicaAsync(String, Guid, Int64)

重启节点上运行的持久性服务的服务副本。

public System.Threading.Tasks.Task RestartReplicaAsync (string nodeName, Guid partitionId, long replicaOrInstanceId);

member this.RestartReplicaAsync : string * Guid * int64 -> System.Threading.Tasks.Task

Public Function RestartReplicaAsync (nodeName As String, partitionId As Guid, replicaOrInstanceId As Long) As Task

参数

nodeName

String

节点的名称。

partitionId

Guid

分区标识符。

replicaOrInstanceId

Int64

实例标识符。

返回

Task

一个任务，表示请求的确认。

例外

FabricObjectClosedException

有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 。

TimeoutException

有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 。

FabricException

ReplicaDoesNotExist如果副本 (replica) 或实例 ID 未在节点上运行，则返回 。

InvalidReplicaStateForReplicaOperation如果此时无法重启或删除副本 (replica) 或实例 ID，因为它处于无效状态，则返回 。 例如，副本 (replica) 已在关闭过程中。

InvalidReplicaOperation如果副本 (replica) 不属于有状态持久化服务，则返回 。 只能重启有状态持久化副本。

另 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见 FabricClient 故障。

ArgumentException

如果 nodeName 为 null 或为空。

注解

警告：使用此 API 时不会执行安全检查。 不当地使用此 API 可能导致有状态服务失去可用性。

默认超时为一分钟，系统将在返回 TimeoutException之前允许此操作继续。

RestartReplicaAsync(String, Guid, Int64, TimeSpan, CancellationToken)

重启节点上运行的持久性服务的服务副本。 还采用超时间隔，这是系统允许此操作在返回 TimeoutException 和操作观察到的取消标记之前继续的最长时间。

public System.Threading.Tasks.Task RestartReplicaAsync (string nodeName, Guid partitionId, long replicaOrInstanceId, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.RestartReplicaAsync : string * Guid * int64 * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function RestartReplicaAsync (nodeName As String, partitionId As Guid, replicaOrInstanceId As Long, timeout As TimeSpan, cancellationToken As CancellationToken) As Task

参数

nodeName

String

节点的名称。

partitionId

Guid

分区标识符。

replicaOrInstanceId

Int64

实例标识符。

timeout

TimeSpan

定义最大时间量的时间跨度将允许在返回 TimeoutException之前继续此操作。

cancellationToken

CancellationToken

操作正在观察的可选取消标记。 它可用于发送应取消操作的通知。 请注意，取消是通知性的，即使操作被取消，操作仍可能完成。

返回

Task

一个任务，表示请求的确认。

例外

FabricObjectClosedException

有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 。

TimeoutException

有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 。

FabricException

ReplicaDoesNotExist如果副本 (replica) 或实例 ID 未在节点上运行，则返回 。

InvalidReplicaStateForReplicaOperation如果此时无法重启或删除副本 (replica) 或实例 ID，因为它处于无效状态，则返回 。 例如，副本 (replica) 已在关闭过程中。

InvalidReplicaOperation如果副本 (replica) 不属于有状态持久化服务，则返回 。 只能重启有状态持久化副本。

另 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见 FabricClient 故障。

ArgumentException

如果 nodeName 为 null 或为空。

注解

警告：使用此 API 时不会执行安全检查。 不当地使用此 API 可能导致有状态服务失去可用性。