FabricClient.ServiceManagementClient.RemoveReplicaAsync メソッド

定義

名前空間:

System.Fabric

アセンブリ:

System.Fabric.dll

パッケージ:

Microsoft.ServiceFabric v9.1.1833

オーバーロード

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

Public Function RemoveReplicaAsync (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 は、レプリカまたはインスタンス ID がノードで実行されていない場合に返されます。

InvalidReplicaStateForReplicaOperation は、レプリカまたはインスタンス ID が無効な状態であるため、この時点で再起動または削除できない場合に返されます。 たとえば、レプリカは既に閉じられている処理中です。

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

ArgumentException

が null または空の場合 nodeName 。

注釈

この API は、実行中のレプリカに状態をクリーンアップし、正常にシャットダウンする機会を提供します。

既定のタイムアウトは 1 分で、システムは を返す前にこの操作を 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.Task

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

パラメーター

nodeName

String

ノード名。

partitionId

Guid

パーティション識別子。

replicaOrInstanceId

Int64

インスタンス識別子。

forceRemove

Boolean

レプリカに状態を正常にクリーンして閉じる機会を与えるかどうかを指定します

戻り値

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 は、レプリカまたはインスタンス ID がノードで実行されていない場合に返されます。

InvalidReplicaStateForReplicaOperation は、レプリカまたはインスタンス ID が無効な状態であるため、この時点で再起動または削除できない場合に返されます。 たとえば、レプリカは既に閉じられている処理中です。

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

ArgumentException

が null または空の場合 nodeName 。

注釈

この API は、実行中のレプリカに状態をクリーンアップし、正常にシャットダウンする機会を提供します。

forceRemove フラグが設定されている場合、そのような機会は与えされません。 Service Fabric は、そのレプリカのホストを終了し、そのレプリカの永続化された状態がリークされます。

警告: この API を使用するときに実行される安全性チェックはありません。 この API の不適切な使用は、ステートフル サービスのデータの損失につながる場合があります。

さらに、forceRemove フラグは、同じプロセスでホストされている他のすべてのレプリカに影響します。

既定のタイムアウトは 1 分で、システムは を返す前にこの操作を 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.Task

Public 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

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

戻り値

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 は、レプリカまたはインスタンス ID がノードで実行されていない場合に返されます。

InvalidReplicaStateForReplicaOperation は、レプリカまたはインスタンス ID が無効な状態であるため、この時点で再起動または削除できない場合に返されます。 たとえば、レプリカは既に閉じられている処理中です。

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

ArgumentException

が null または空の場合 nodeName 。

注釈

この API は、実行中のレプリカに状態をクリーンアップし、正常にシャットダウンする機会を提供します。

警告: この 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.Task

Public 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

レプリカに状態を正常にクリーンして閉じる機会を与えるかどうかを指定します

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 は、レプリカまたはインスタンス ID がノードで実行されていない場合に返されます。

InvalidReplicaStateForReplicaOperation は、レプリカまたはインスタンス ID が無効な状態であるため、この時点で再起動または削除できない場合に返されます。 たとえば、レプリカは既に閉じられている処理中です。

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

ArgumentException

が null または空の場合 nodeName 。

注釈

この API は、実行中のレプリカに状態をクリーンアップし、正常にシャットダウンする機会を提供します。

forceRemove フラグが設定されている場合、そのような機会は与えされません。 Service Fabric は、そのレプリカのホストを終了し、そのレプリカの永続化された状態がリークされます。

警告: この API を使用するときに実行される安全性チェックはありません。 この API の不適切な使用は、ステートフル サービスのデータの損失につながる場合があります。

さらに、forceRemove フラグは、同じプロセスでホストされている他のすべてのレプリカに影響します。