FabricClient.ClusterManagementClient.RemoveNodeStateAsync メソッド

定義

名前空間:

System.Fabric

アセンブリ:

System.Fabric.dll

パッケージ:

Microsoft.ServiceFabric v9.1.1833

オーバーロード

RemoveNodeStateAsync(String)	ノードの永続化されたデータが失われること (ディスク障害や再イメージ化など) が発生し、その Service Fabric がそのノード上のサービスまたは状態を失われ、回復不能として扱う必要があることを示します。
RemoveNodeStateAsync(String, TimeSpan, CancellationToken)	特定のノード (ダウン) が実際に失われ、その Service Fabric がそのノード上のサービスまたは状態を失われ、回復不能として扱う必要があることを示します。

RemoveNodeStateAsync(String)

ノードの永続化されたデータが失われること (ディスク障害や再イメージ化など) が発生し、その Service Fabric がそのノード上のサービスまたは状態を失われ、回復不能として扱う必要があることを示します。

public System.Threading.Tasks.Task RemoveNodeStateAsync (string nodeName);

member this.RemoveNodeStateAsync : string -> System.Threading.Tasks.Task

Public Function RemoveNodeStateAsync (nodeName As String) As Task

パラメーター

nodeName

String

完全に失われたノードの名前。

戻り値

Task

操作を表すタスク。

例外

FabricObjectClosedException

一般的な FabricClient エラーの処理に関するページを参照してください https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ 。

TimeoutException

一般的な FabricClient エラーの処理に関するページを参照してください https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ 。

FabricException

一般的な FabricClient エラーの処理についても https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ 参照してください。

注釈

ノードがダウンした後、Service Fabric は、そのノード上の状態を持つため、そのノード上の永続化されたサービスのレプリカを追跡します。

ノードの永続化された状態が完全に失われることを管理者が認識している場合は、メソッドを RemoveNodeStateAsync(String) ... と呼ぶ必要があります。ノードの状態がなくなったことを Service Fabric に通知する場合 (または、ノードが持っていた状態に戻ることは決してできません)。

これにより、Service Fabric は、そのノード (およびそのノード上の永続化されたレプリカ) の復旧の待機を停止するように指示します。

注: この API は、そのノードの状態が失われたと判断された後にのみ呼び出す必要があります。

Service Fabric 6.5 以降、シード ノードにこの API を使用する場合は、シード ノードを通常の (非シード) ノードに変更した後、この API を呼び出して、ノードの状態を削除してください。

クラスターが Azure で実行されている場合、シード ノードが停止した後、Service Fabric は自動的にそれを非シード ノードに変更しようとします。 そうなるようにするには、プライマリ ノード タイプの非シード ノードの数が、ダウンしているシード ノードの数以上になるようにします。 そのために、必要に応じて、プライマリ ノード タイプにノードを追加します。

スタンドアロン クラスターの場合、ダウン シード ノードの状態がそのまま戻らないと予想される場合は、クラスターからノードを削除してください。「」を参照してください https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-windows-server-add-remove-nodes/

この API が呼び出され、ノードの状態がそのまま戻った場合、未定義の動作になります

RemoveNodeStateAsync(String, TimeSpan, CancellationToken)

特定のノード (ダウン) が実際に失われ、その Service Fabric がそのノード上のサービスまたは状態を失われ、回復不能として扱う必要があることを示します。

public System.Threading.Tasks.Task RemoveNodeStateAsync (string nodeName, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.RemoveNodeStateAsync : string * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function RemoveNodeStateAsync (nodeName As String, timeout As TimeSpan, cancellationToken As CancellationToken) As Task

パラメーター

nodeName

String

完全に失われたノードの名前。

timeout

TimeSpan

最大時間を定義する期間では、 を返す前にこの操作を TimeoutException続行できます。

cancellationToken

CancellationToken

操作が監視している省略可能なキャンセル トークン。 操作を取り消す必要があることを示す通知を送信するために使用できます。 取り消しはアドバイザリであり、取り消しても操作が完了する可能性があることに注意してください。

戻り値

Task

操作を表すタスク。

例外

FabricObjectClosedException

一般的な FabricClient エラーの処理に関するページを参照してください https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ 。

TimeoutException

一般的な FabricClient エラーの処理に関するページを参照してください https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ 。

FabricException

一般的な FabricClient エラーの処理についても https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ 参照してください。

注釈

ノードがダウンした後、Service Fabric は、そのノード上の状態を持つため、そのノード上の永続化されたサービスのレプリカを追跡します。

ノード (およびその状態) が完全に失われることを管理者が認識している場合は、メソッドを RemoveNodeStateAsync(String) 呼び出す必要があります。

これにより、Service Fabric は、そのノード (およびそのノード上の永続化されたレプリカ) の復旧の待機を停止するように指示します。

注: この API は、そのノードの状態が失われたと判断された後にのみ呼び出す必要があります。

Service Fabric 6.5 以降、シード ノードにこの API を使用する場合は、シード ノードを通常の (非シード) ノードに変更した後、この API を呼び出して、ノードの状態を削除してください。

クラスターが Azure で実行されている場合、シード ノードが停止した後、Service Fabric は自動的にそれを非シード ノードに変更しようとします。 そうなるようにするには、プライマリ ノード タイプの非シード ノードの数が、ダウンしているシード ノードの数以上になるようにします。 そのために、必要に応じて、プライマリ ノード タイプにノードを追加します。

スタンドアロン クラスターの場合、ダウン シード ノードの状態がそのまま戻らないと予想される場合は、クラスターからノードを削除してください。「」を参照してください https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-windows-server-add-remove-nodes/

この API が呼び出され、ノードの状態がそのまま戻った場合、未定義の動作になります