你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
FabricClient.ServiceManagementClient.RemoveReplicaAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| RemoveReplicaAsync(String, Guid, Int64) |
删除节点上运行的服务副本。 |
| RemoveReplicaAsync(String, Guid, Int64, Boolean) |
删除节点上运行的服务副本。 |
| RemoveReplicaAsync(String, Guid, Int64, TimeSpan, CancellationToken) |
删除节点上运行的服务副本。 还采用超时间隔，这是系统在返回 TimeoutException 操作之前允许此操作继续的最长时间，以及操作观察到的取消标记。 |
| RemoveReplicaAsync(String, Guid, Int64, Boolean, TimeSpan, CancellationToken) |
删除节点上运行的服务副本。 还采用超时间隔，这是系统在返回 TimeoutException 操作之前允许此操作继续的最长时间，以及操作观察到的取消标记。 |
RemoveReplicaAsync(String, Guid, Int64)
删除节点上运行的服务副本。
public System.Threading.Tasks.Task RemoveReplicaAsync (string nodeName, Guid partitionId, long replicaOrInstanceId);member this.RemoveReplicaAsync : string * Guid * int64 -> System.Threading.Tasks.TaskPublic Function RemoveReplicaAsync (nodeName As String, partitionId As Guid, replicaOrInstanceId As Long) As Task参数
- nodeName
- String
节点的名称。
- partitionId
- Guid
分区标识符。
- replicaOrInstanceId
- Int64
实例标识符。
返回
一个表示请求确认的任务。
例外
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 。
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 。
ReplicaDoesNotExist如果副本 (replica) 或实例 ID 未在节点上运行，则返回 。
InvalidReplicaStateForReplicaOperation如果此时无法重新启动或删除副本 (replica) 或实例 ID，则返回 ，因为它处于无效状态。 例如，副本 (replica) 已在关闭过程中。
另 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见的 FabricClient 故障。
如果 nodeName 为 null 或空。
注解
此 API 使正在运行的副本 (replica) 有机会清理其状态并正常关闭。
默认超时为一分钟，系统允许在返回 TimeoutException之前继续此操作。
警告：使用此 API 时，不会执行任何安全检查。 不当地使用此 API 可能导致有状态服务的数据丢失。
适用于
RemoveReplicaAsync(String, Guid, Int64, Boolean)
删除节点上运行的服务副本。
public System.Threading.Tasks.Task RemoveReplicaAsync (string nodeName, Guid partitionId, long replicaOrInstanceId, bool forceRemove);member this.RemoveReplicaAsync : string * Guid * int64 * bool -> System.Threading.Tasks.TaskPublic Function RemoveReplicaAsync (nodeName As String, partitionId As Guid, replicaOrInstanceId As Long, forceRemove As Boolean) As Task参数
- nodeName
- String
节点的名称。
- partitionId
- Guid
分区标识符。
- replicaOrInstanceId
- Int64
实例标识符。
- forceRemove
- Boolean
指定是否应为副本 (replica) 提供正常清理其状态并关闭的机会
返回
一个表示请求确认的任务。
例外
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 。
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 。
ReplicaDoesNotExist如果副本 (replica) 或实例 ID 未在节点上运行，则返回 。
InvalidReplicaStateForReplicaOperation如果此时无法重新启动或删除副本 (replica) 或实例 ID，则返回 ，因为它处于无效状态。 例如，副本 (replica) 已在关闭过程中。
另 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见的 FabricClient 故障。
如果 nodeName 为 null 或空。
注解
此 API 使正在运行的副本 (replica) 有机会清理其状态并正常关闭。
如果设置了 forceRemove 标志，则不会提供此类机会。 Service Fabric 将终止该副本 (replica) 的主机，并且该副本 (replica) 的任何持久状态都将泄漏。
警告：使用此 API 时，不会执行任何安全检查。 不当地使用此 API 可能导致有状态服务的数据丢失。
此外，forceRemove 标志会影响同一进程中承载的所有其他副本。
默认超时为一分钟，系统允许在返回 TimeoutException之前继续此操作。
适用于
RemoveReplicaAsync(String, Guid, Int64, TimeSpan, CancellationToken)
删除节点上运行的服务副本。 还采用超时间隔，这是系统在返回 TimeoutException 操作之前允许此操作继续的最长时间，以及操作观察到的取消标记。
public System.Threading.Tasks.Task RemoveReplicaAsync (string nodeName, Guid partitionId, long replicaOrInstanceId, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);member this.RemoveReplicaAsync : string * Guid * int64 * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function RemoveReplicaAsync (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
操作正在观察的可选取消标记。 它可用于发送应取消操作的通知。 请注意，取消是建议性的，即使取消了操作，操作仍可能已完成。
返回
一个表示请求确认的任务。
例外
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 。
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 。
ReplicaDoesNotExist如果副本 (replica) 或实例 ID 未在节点上运行，则返回 。
InvalidReplicaStateForReplicaOperation如果此时无法重新启动或删除副本 (replica) 或实例 ID，则返回 ，因为它处于无效状态。 例如，副本 (replica) 已在关闭过程中。
另 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见的 FabricClient 故障。
如果 nodeName 为 null 或空。
注解
此 API 使正在运行的副本 (replica) 有机会清理其状态并正常关闭。
警告：使用此 API 时，不会执行任何安全检查。 不当地使用此 API 可能导致有状态服务的数据丢失。
适用于
RemoveReplicaAsync(String, Guid, Int64, Boolean, TimeSpan, CancellationToken)
删除节点上运行的服务副本。 还采用超时间隔，这是系统在返回 TimeoutException 操作之前允许此操作继续的最长时间，以及操作观察到的取消标记。
public System.Threading.Tasks.Task RemoveReplicaAsync (string nodeName, Guid partitionId, long replicaOrInstanceId, bool forceRemove, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);member this.RemoveReplicaAsync : string * Guid * int64 * bool * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function RemoveReplicaAsync (nodeName As String, partitionId As Guid, replicaOrInstanceId As Long, forceRemove As Boolean, timeout As TimeSpan, cancellationToken As CancellationToken) As Task参数
- nodeName
- String
节点的名称。
- partitionId
- Guid
分区标识符。
- replicaOrInstanceId
- Int64
实例标识符。
- forceRemove
- Boolean
指定是否应为副本 (replica) 提供正常清理其状态并关闭的机会
- timeout
- TimeSpan
定义最大时间量的时间跨度将允许此操作在返回 TimeoutException之前继续。
- cancellationToken
- CancellationToken
操作正在观察的可选取消标记。 它可用于发送应取消操作的通知。 请注意，取消是建议性的，即使取消了操作，操作仍可能已完成。
返回
一个表示请求确认的任务。
例外
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 。
有关处理常见 FabricClient 故障，请参阅 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 。
ReplicaDoesNotExist如果副本 (replica) 或实例 ID 未在节点上运行，则返回 。
InvalidReplicaStateForReplicaOperation如果此时无法重新启动或删除副本 (replica) 或实例 ID，则返回 ，因为它处于无效状态。 例如，副本 (replica) 已在关闭过程中。
另 https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions 请参阅处理常见的 FabricClient 故障。
如果 nodeName 为 null 或空。
注解
此 API 使正在运行的副本 (replica) 有机会清理其状态并正常关闭。
如果设置了 forceRemove 标志，则不会提供此类机会。 Service Fabric 将终止该副本 (replica) 的主机，并且该副本 (replica) 的任何持久状态都将泄漏。
警告：使用此 API 时，不会执行任何安全检查。 不当地使用此 API 可能导致有状态服务的数据丢失。
此外，forceRemove 标志会影响同一进程中承载的所有其他副本。
