FabricClient.ServiceManagementClient.RestartReplicaAsync メソッド

定義

オーバーロード

RestartReplicaAsync(String, Guid, Int64)

ノード上で実行されている永続化されたサービスのサービス レプリカを再起動します。

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

ノード上で実行されている永続化されたサービスのサービス レプリカを再起動します。 また、タイムアウト間隔を取ります。これは、操作が監視しているキャンセル トークンと を返す前に、システムがこの操作を TimeoutException 続行できる最大時間です。

RestartReplicaAsync(String, Guid, Int64)

ノード上で実行されている永続化されたサービスのサービス レプリカを再起動します。

public System.Threading.Tasks.Task RestartReplicaAsync (string nodeName, Guid partitionId, long replicaOrInstanceId);
member this.RestartReplicaAsync : string * Guid * int64 -> System.Threading.Tasks.Task
Public Function RestartReplicaAsync (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 は、レプリカまたはインスタンス ID がノードで実行されていない場合に返されます。

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

InvalidReplicaOperation は、レプリカがステートフルな永続化されたサービスに属していない場合に返されます。 ステートフルな永続化されたレプリカのみを再起動できます。

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

が null または空の場合 nodeName

注釈

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

既定のタイムアウトは 1 分で、システムはこの操作を続行してから を TimeoutException返すことができます。

適用対象

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

ノード上で実行されている永続化されたサービスのサービス レプリカを再起動します。 また、タイムアウト間隔を取ります。これは、操作が監視しているキャンセル トークンと を返す前に、システムがこの操作を TimeoutException 続行できる最大時間です。

public System.Threading.Tasks.Task RestartReplicaAsync (string nodeName, Guid partitionId, long replicaOrInstanceId, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
member this.RestartReplicaAsync : string * Guid * int64 * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function RestartReplicaAsync (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 は、レプリカまたはインスタンス ID がノードで実行されていない場合に返されます。

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

InvalidReplicaOperation は、レプリカがステートフルな永続化されたサービスに属していない場合に返されます。 ステートフルな永続化されたレプリカのみを再起動できます。

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

が null または空の場合 nodeName

注釈

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

適用対象