FabricClient.ServiceManagementClient.RemoveReplicaAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| RemoveReplicaAsync(String, Guid, Int64) |
Quita una réplica de servicio que se ejecuta en un nodo. |
| RemoveReplicaAsync(String, Guid, Int64, Boolean) |
Quita una réplica de servicio que se ejecuta en un nodo. |
| RemoveReplicaAsync(String, Guid, Int64, TimeSpan, CancellationToken) |
Quita una réplica de servicio que se ejecuta en un nodo. También tarda en el intervalo de tiempo de espera, que es el tiempo máximo que el sistema permitirá que esta operación continúe antes de devolver TimeoutException y cancelar el token que la operación está observando. |
| RemoveReplicaAsync(String, Guid, Int64, Boolean, TimeSpan, CancellationToken) |
Quita una réplica de servicio que se ejecuta en un nodo. También tarda en el intervalo de tiempo de espera, que es el tiempo máximo que el sistema permitirá que esta operación continúe antes de devolver TimeoutException y cancelar el token que la operación está observando. |
RemoveReplicaAsync(String, Guid, Int64)
Quita una réplica de servicio que se ejecuta en un nodo.
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 TaskParámetros
- nodeName
- String
El nombre del nodo.
- partitionId
- Guid
Identificador de partición.
- replicaOrInstanceId
- Int64
Identificador de la instancia.
Devoluciones
Tarea que representa la confirmación de la solicitud.
Excepciones
Consulte https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions para controlar errores comunes de FabricClient.
Consulte https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions para controlar errores comunes de FabricClient.
ReplicaDoesNotExist se devuelve si la réplica o el identificador de instancia no se ejecutan en el nodo.
InvalidReplicaStateForReplicaOperation se devuelve si la réplica o el identificador de instancia no se pueden reiniciar ni quitar en este momento, ya que se encuentra en un estado no válido. Por ejemplo, la réplica ya está en proceso de cierre.
Consulte también https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions para controlar errores comunes de FabricClient.
Si nodeName es null o está vacío.
Comentarios
Esta API ofrece a una réplica en ejecución la posibilidad de limpiar su estado y cerrarse correctamente.
El tiempo de espera predeterminado es de un minuto para el que el sistema permitirá que esta operación continúe antes de devolver TimeoutException.
ADVERTENCIA: No se realizan comprobaciones de seguridad cuando se usa esta API. El uso incorrecto de esta API puede conllevar la pérdida de datos de los servicios con estado.
Se aplica a
RemoveReplicaAsync(String, Guid, Int64, Boolean)
Quita una réplica de servicio que se ejecuta en un nodo.
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 TaskParámetros
- nodeName
- String
El nombre del nodo.
- partitionId
- Guid
Identificador de partición.
- replicaOrInstanceId
- Int64
Identificador de la instancia.
- forceRemove
- Boolean
Especifica si la réplica debe tener la oportunidad de limpiar correctamente su estado y cerrarse.
Devoluciones
Tarea que representa la confirmación de la solicitud.
Excepciones
Consulte https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions para controlar errores comunes de FabricClient.
Consulte https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions para controlar errores comunes de FabricClient.
ReplicaDoesNotExist se devuelve si la réplica o el identificador de instancia no se ejecutan en el nodo.
InvalidReplicaStateForReplicaOperation se devuelve si la réplica o el identificador de instancia no se pueden reiniciar ni quitar en este momento, ya que se encuentra en un estado no válido. Por ejemplo, la réplica ya está en proceso de cierre.
Consulte también https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions para controlar errores comunes de FabricClient.
Si nodeName es null o está vacío.
Comentarios
Esta API ofrece a una réplica en ejecución la posibilidad de limpiar su estado y cerrarse correctamente.
Si se establece la marca forceRemove, no se da esa oportunidad. Service Fabric finalizará el host de esa réplica y se perderá cualquier estado persistente de esa réplica.
ADVERTENCIA: No se realizan comprobaciones de seguridad cuando se usa esta API. El uso incorrecto de esta API puede conllevar la pérdida de datos de los servicios con estado.
Además, la marca forceRemove afecta a todas las demás réplicas hospedadas en el mismo proceso.
El tiempo de espera predeterminado es de un minuto para el que el sistema permitirá que esta operación continúe antes de devolver TimeoutException.
Se aplica a
RemoveReplicaAsync(String, Guid, Int64, TimeSpan, CancellationToken)
Quita una réplica de servicio que se ejecuta en un nodo. También tarda en el intervalo de tiempo de espera, que es el tiempo máximo que el sistema permitirá que esta operación continúe antes de devolver TimeoutException y cancelar el token que la operación está observando.
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 TaskParámetros
- nodeName
- String
El nombre del nodo.
- partitionId
- Guid
Identificador de partición.
- replicaOrInstanceId
- Int64
Identificador de la instancia.
- timeout
- TimeSpan
El intervalo de tiempo que define la cantidad máxima de tiempo permitirá que esta operación continúe antes de devolver un TimeoutException.
- cancellationToken
- CancellationToken
Token de cancelación opcional que observa la operación. Se puede usar para enviar una notificación de que se debe cancelar la operación. Tenga en cuenta que la cancelación es un aviso y que la operación todavía se puede completar aunque se cancele.
Devoluciones
Tarea que representa la confirmación de la solicitud.
Excepciones
Consulte https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions para controlar errores comunes de FabricClient.
Consulte https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions para controlar errores comunes de FabricClient.
ReplicaDoesNotExist se devuelve si la réplica o el identificador de instancia no se ejecutan en el nodo.
InvalidReplicaStateForReplicaOperation se devuelve si la réplica o el identificador de instancia no se pueden reiniciar ni quitar en este momento, ya que se encuentra en un estado no válido. Por ejemplo, la réplica ya está en proceso de cierre.
Consulte también https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions para controlar errores comunes de FabricClient.
Si nodeName es null o está vacío.
Comentarios
Esta API ofrece a una réplica en ejecución la posibilidad de limpiar su estado y cerrarse correctamente.
ADVERTENCIA: No se realizan comprobaciones de seguridad cuando se usa esta API. El uso incorrecto de esta API puede conllevar la pérdida de datos de los servicios con estado.
Se aplica a
RemoveReplicaAsync(String, Guid, Int64, Boolean, TimeSpan, CancellationToken)
Quita una réplica de servicio que se ejecuta en un nodo. También tarda en el intervalo de tiempo de espera, que es el tiempo máximo que el sistema permitirá que esta operación continúe antes de devolver TimeoutException y cancelar el token que la operación está observando.
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 TaskParámetros
- nodeName
- String
El nombre del nodo.
- partitionId
- Guid
Identificador de partición.
- replicaOrInstanceId
- Int64
Identificador de la instancia.
- forceRemove
- Boolean
Especifica si la réplica debe tener la oportunidad de limpiar correctamente su estado y cerrarse.
- timeout
- TimeSpan
El intervalo de tiempo que define la cantidad máxima de tiempo permitirá que esta operación continúe antes de devolver un TimeoutException.
- cancellationToken
- CancellationToken
Token de cancelación opcional que observa la operación. Se puede usar para enviar una notificación de que se debe cancelar la operación. Tenga en cuenta que la cancelación es un aviso y que la operación todavía se puede completar aunque se cancele.
Devoluciones
Tarea que representa la confirmación de la solicitud.
Excepciones
Consulte https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions para controlar errores comunes de FabricClient.
Consulte https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions para controlar errores comunes de FabricClient.
ReplicaDoesNotExist se devuelve si la réplica o el identificador de instancia no se ejecutan en el nodo.
InvalidReplicaStateForReplicaOperation se devuelve si la réplica o el identificador de instancia no se pueden reiniciar ni quitar en este momento, ya que se encuentra en un estado no válido. Por ejemplo, la réplica ya está en proceso de cierre.
Consulte también https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions para controlar errores comunes de FabricClient.
Si nodeName es null o está vacío.
Comentarios
Esta API ofrece a una réplica en ejecución la posibilidad de limpiar su estado y cerrarse correctamente.
Si se establece la marca forceRemove, no se da esa oportunidad. Service Fabric finalizará el host de esa réplica y se perderá cualquier estado persistente de esa réplica.
ADVERTENCIA: No se realizan comprobaciones de seguridad cuando se usa esta API. El uso incorrecto de esta API puede conllevar la pérdida de datos de los servicios con estado.
Además, la marca forceRemove afecta a todas las demás réplicas hospedadas en el mismo proceso.
Se aplica a
Azure SDK for .NET
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de