FabricClient.ServiceManagementClient.RemoveReplicaAsync Methode

Definition

Namespace:

System.Fabric

Assembly:

System.Fabric.dll

Paket:

Microsoft.ServiceFabric v9.1.1833

Überlädt

RemoveReplicaAsync(String, Guid, Int64)	Entfernt ein Dienstreplikat, das auf einem Knoten ausgeführt wird.
RemoveReplicaAsync(String, Guid, Int64, Boolean)	Entfernt ein Dienstreplikat, das auf einem Knoten ausgeführt wird.
RemoveReplicaAsync(String, Guid, Int64, TimeSpan, CancellationToken)	Entfernt ein Dienstreplikat, das auf einem Knoten ausgeführt wird. Benötigt auch ein Timeoutintervall, d. h. die maximale Zeit, die das System diesen Vorgang fortsetzen lässt, bevor das vom Vorgang beobachtete Token und das Abbruchtoken TimeoutException zurückgegeben wird.
RemoveReplicaAsync(String, Guid, Int64, Boolean, TimeSpan, CancellationToken)	Entfernt ein Dienstreplikat, das auf einem Knoten ausgeführt wird. Benötigt auch ein Timeoutintervall, d. h. die maximale Zeit, die das System diesen Vorgang fortsetzen lässt, bevor das vom Vorgang beobachtete Token und das Abbruchtoken TimeoutException zurückgegeben wird.

RemoveReplicaAsync(String, Guid, Int64)

Entfernt ein Dienstreplikat, das auf einem Knoten ausgeführt wird.

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

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

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

Parameter

nodeName

String

Der Name des Knotens.

partitionId

Guid

Der Partitionsbezeichner.

replicaOrInstanceId

Int64

Der Instanzbezeichner.

Gibt zurück

Task

Ein Vorgang, der die Bestätigung der Anforderung darstellt.

Ausnahmen

FabricObjectClosedException

Informationen zur Behandlung allgemeiner FabricClient-Fehler finden Sie unter https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions .

TimeoutException

Informationen zur Behandlung allgemeiner FabricClient-Fehler finden Sie unter https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions .

FabricException

ReplicaDoesNotExistwird zurückgegeben, wenn das Replikat oder die instance-ID nicht auf dem Knoten ausgeführt wird.

InvalidReplicaStateForReplicaOperationwird zurückgegeben, wenn das Replikat oder die instance-ID zu diesem Zeitpunkt nicht neu gestartet oder entfernt werden kann, da sie sich in einem ungültigen Zustand befindet. Beispielsweise wird das Replikat bereits geschlossen.

Siehe auch https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions zur Behandlung allgemeiner FabricClient-Fehler.

ArgumentException

Wenn nodeName null oder leer ist.

Hinweise

Diese API gibt einem ausgeführten Replikat die Möglichkeit, seinen Zustand zu bereinigen und ordnungsgemäß herunterzufahren.

Das Standardtimeout beträgt eine Minute, für die das System diesen Vorgang fortsetzen kann, bevor zurückgegeben TimeoutExceptionwird.

WARNUNG: Es werden keine Sicherheitsüberprüfungen durchgeführt, wenn diese API verwendet wird. Eine falsche Verwendung dieser API kann zum Verlust der Daten von zustandsbehafteten Diensten führen.

RemoveReplicaAsync(String, Guid, Int64, Boolean)

Entfernt ein Dienstreplikat, das auf einem Knoten ausgeführt wird.

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

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

Public Function RemoveReplicaAsync (nodeName As String, partitionId As Guid, replicaOrInstanceId As Long, forceRemove As Boolean) As Task

Parameter

nodeName

String

Der Name des Knotens.

partitionId

Guid

Der Partitionsbezeichner.

replicaOrInstanceId

Int64

Der Instanzbezeichner.

forceRemove

Boolean

Gibt an, ob dem Replikat die Möglichkeit gegeben werden soll, seinen Zustand ordnungsgemäß zu sauber und zu schließen.

Gibt zurück

Task

Ein Vorgang, der die Bestätigung der Anforderung darstellt.

Ausnahmen

FabricObjectClosedException

Informationen zur Behandlung allgemeiner FabricClient-Fehler finden Sie unter https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions .

TimeoutException

Informationen zur Behandlung allgemeiner FabricClient-Fehler finden Sie unter https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions .

FabricException

ReplicaDoesNotExistwird zurückgegeben, wenn das Replikat oder die instance-ID nicht auf dem Knoten ausgeführt wird.

InvalidReplicaStateForReplicaOperationwird zurückgegeben, wenn das Replikat oder die instance-ID zu diesem Zeitpunkt nicht neu gestartet oder entfernt werden kann, da sie sich in einem ungültigen Zustand befindet. Beispielsweise wird das Replikat bereits geschlossen.

Siehe auch https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions zur Behandlung allgemeiner FabricClient-Fehler.

ArgumentException

Wenn nodeName null oder leer ist.

Hinweise

Diese API gibt einem ausgeführten Replikat die Möglichkeit, seinen Zustand zu bereinigen und ordnungsgemäß herunterzufahren.

Wenn das forceRemove-Flag festgelegt ist, wird keine solche Möglichkeit angegeben. Service Fabric beendet den Host für dieses Replikat, und jeder persistente Zustand dieses Replikats wird durchleckt.

WARNUNG: Es werden keine Sicherheitsüberprüfungen durchgeführt, wenn diese API verwendet wird. Eine falsche Verwendung dieser API kann zum Verlust der Daten von zustandsbehafteten Diensten führen.

Darüber hinaus wirkt sich das forceRemove-Flag auf alle anderen Repliken aus, die im selben Prozess gehostet werden.

Das Standardtimeout beträgt eine Minute, für die das System diesen Vorgang fortsetzen kann, bevor zurückgegeben TimeoutExceptionwird.

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

Entfernt ein Dienstreplikat, das auf einem Knoten ausgeführt wird. Benötigt auch ein Timeoutintervall, d. h. die maximale Zeit, die das System diesen Vorgang fortsetzen lässt, bevor das vom Vorgang beobachtete Token und das Abbruchtoken TimeoutException zurückgegeben wird.

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.Task

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

Parameter

nodeName

String

Der Name des Knotens.

partitionId

Guid

Der Partitionsbezeichner.

replicaOrInstanceId

Int64

Der Instanzbezeichner.

timeout

TimeSpan

Der Zeitbereich, der die maximale Zeitdauer definiert, ermöglicht es diesem Vorgang, vor dem Zurückgeben eines TimeoutExceptionfortzusetzen.

cancellationToken

CancellationToken

Das optionale Abbruchtoken, das der Vorgang beobachtet. Sie kann verwendet werden, um eine Benachrichtigung zu senden, dass der Vorgang abgebrochen werden soll. Beachten Sie, dass der Abbruch hilfreich ist und dass der Vorgang auch dann abgeschlossen werden kann, wenn er abgebrochen wird.

Gibt zurück

Task

Ein Vorgang, der die Bestätigung der Anforderung darstellt.

Ausnahmen

FabricObjectClosedException

Informationen zur Behandlung allgemeiner FabricClient-Fehler finden Sie unter https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions .

TimeoutException

Informationen zur Behandlung allgemeiner FabricClient-Fehler finden Sie unter https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions .

FabricException

ReplicaDoesNotExistwird zurückgegeben, wenn das Replikat oder die instance-ID nicht auf dem Knoten ausgeführt wird.

InvalidReplicaStateForReplicaOperationwird zurückgegeben, wenn das Replikat oder die instance-ID zu diesem Zeitpunkt nicht neu gestartet oder entfernt werden kann, da sie sich in einem ungültigen Zustand befindet. Beispielsweise wird das Replikat bereits geschlossen.

Siehe auch https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions zur Behandlung allgemeiner FabricClient-Fehler.

ArgumentException

Wenn nodeName null oder leer ist.

Hinweise

Diese API gibt einem ausgeführten Replikat die Möglichkeit, seinen Zustand zu bereinigen und ordnungsgemäß herunterzufahren.

WARNUNG: Es werden keine Sicherheitsüberprüfungen durchgeführt, wenn diese API verwendet wird. Eine falsche Verwendung dieser API kann zum Verlust der Daten von zustandsbehafteten Diensten führen.

RemoveReplicaAsync(String, Guid, Int64, Boolean, TimeSpan, CancellationToken)

Entfernt ein Dienstreplikat, das auf einem Knoten ausgeführt wird. Benötigt auch ein Timeoutintervall, d. h. die maximale Zeit, die das System diesen Vorgang fortsetzen lässt, bevor das vom Vorgang beobachtete Token und das Abbruchtoken TimeoutException zurückgegeben wird.

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.Task

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

Parameter

nodeName

String

Der Name des Knotens.

partitionId

Guid

Der Partitionsbezeichner.

replicaOrInstanceId

Int64

Der Instanzbezeichner.

forceRemove

Boolean

Gibt an, ob dem Replikat die Möglichkeit gegeben werden soll, seinen Zustand ordnungsgemäß zu sauber und zu schließen.

timeout

TimeSpan

Der Zeitbereich, der die maximale Zeitdauer definiert, ermöglicht es diesem Vorgang, vor dem Zurückgeben eines TimeoutExceptionfortzusetzen.

cancellationToken

CancellationToken

Das optionale Abbruchtoken, das der Vorgang beobachtet. Sie kann verwendet werden, um eine Benachrichtigung zu senden, dass der Vorgang abgebrochen werden soll. Beachten Sie, dass der Abbruch hilfreich ist und dass der Vorgang auch dann abgeschlossen werden kann, wenn er abgebrochen wird.

Gibt zurück

Task

Ein Vorgang, der die Bestätigung der Anforderung darstellt.

Ausnahmen

FabricObjectClosedException

Informationen zur Behandlung allgemeiner FabricClient-Fehler finden Sie unter https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions .

TimeoutException

Informationen zur Behandlung allgemeiner FabricClient-Fehler finden Sie unter https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions .

FabricException

ReplicaDoesNotExistwird zurückgegeben, wenn das Replikat oder die instance-ID nicht auf dem Knoten ausgeführt wird.

InvalidReplicaStateForReplicaOperationwird zurückgegeben, wenn das Replikat oder die instance-ID zu diesem Zeitpunkt nicht neu gestartet oder entfernt werden kann, da sie sich in einem ungültigen Zustand befindet. Beispielsweise wird das Replikat bereits geschlossen.

Siehe auch https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions zur Behandlung allgemeiner FabricClient-Fehler.

ArgumentException

Wenn nodeName null oder leer ist.

Hinweise

Diese API gibt einem ausgeführten Replikat die Möglichkeit, seinen Zustand zu bereinigen und ordnungsgemäß herunterzufahren.

Wenn das forceRemove-Flag festgelegt ist, wird keine solche Möglichkeit angegeben. Service Fabric beendet den Host für dieses Replikat, und jeder persistente Zustand dieses Replikats wird durchleckt.

WARNUNG: Es werden keine Sicherheitsüberprüfungen durchgeführt, wenn diese API verwendet wird. Eine falsche Verwendung dieser API kann zum Verlust der Daten von zustandsbehafteten Diensten führen.

Darüber hinaus wirkt sich das forceRemove-Flag auf alle anderen Repliken aus, die im selben Prozess gehostet werden.