FabricClient.QueryClient.GetDeployedReplicaDetailAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
GetDeployedReplicaDetailAsync(String, Guid, Int64) |
Returns details of a replica running on the specified node. |
GetDeployedReplicaDetailAsync(String, Guid, Int64, TimeSpan, CancellationToken) |
Returns details of a replica running on the specified node. |
GetDeployedReplicaDetailAsync(String, Guid, Int64)
Returns details of a replica running on the specified node.
public System.Threading.Tasks.Task<System.Fabric.Query.DeployedServiceReplicaDetail> GetDeployedReplicaDetailAsync (string nodeName, Guid partitionId, long replicaId);
member this.GetDeployedReplicaDetailAsync : string * Guid * int64 -> System.Threading.Tasks.Task<System.Fabric.Query.DeployedServiceReplicaDetail>
Public Function GetDeployedReplicaDetailAsync (nodeName As String, partitionId As Guid, replicaId As Long) As Task(Of DeployedServiceReplicaDetail)
Parameters
- nodeName
- String
The node name from which the results are desired. This is a case-sensitive exact match. This value should not be null or empty, and if the node name does not match any node on the cluster, an exception is thrown.
- partitionId
- Guid
The partition id for which the results are desired.
- replicaId
- Int64
The identifier for the replica or the instance for which the results are desired.
Returns
A task that represents the asynchronous query operation.
The returned task contains the replica information as DeployedServiceReplicaDetail.
Exceptions
See https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions for handling common FabricClient failures.
This operation has a timeout of 60 seconds.
See https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions for handling common FabricClient failures.
See also https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions for handling common FabricClient failures.
For this query, this exception usually means that the given node name does not match any node in the cluster.
Remarks
Service Fabric is a distributed system where many components have a view of the same entity.
In an unstable or transient state, this view may not match GetReplicaListAsync(Guid) and GetDeployedReplicaListAsync(String, Uri)
Applies to
GetDeployedReplicaDetailAsync(String, Guid, Int64, TimeSpan, CancellationToken)
Returns details of a replica running on the specified node.
public System.Threading.Tasks.Task<System.Fabric.Query.DeployedServiceReplicaDetail> GetDeployedReplicaDetailAsync (string nodeName, Guid partitionId, long replicaId, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
member this.GetDeployedReplicaDetailAsync : string * Guid * int64 * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Fabric.Query.DeployedServiceReplicaDetail>
Public Function GetDeployedReplicaDetailAsync (nodeName As String, partitionId As Guid, replicaId As Long, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of DeployedServiceReplicaDetail)
Parameters
- nodeName
- String
The node name from which the results are desired. This is a case-sensitive exact match. This value should not be null or empty, and if the node name does not match any node on the cluster, an exception is thrown.
- partitionId
- Guid
The partition id for which the results are desired.
- replicaId
- Int64
The identifier for the replica or the instance for which the results are desired.
- timeout
- TimeSpan
Specifies the duration this operation has to complete before timing out.
- cancellationToken
- CancellationToken
Propagates notification that operations should be canceled.
Returns
A task that represents the asynchronous query operation.
The returned task contains the replica information as DeployedServiceReplicaDetail.
Exceptions
See https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions for handling common FabricClient failures.
See https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions for handling common FabricClient failures.
See also https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions for handling common FabricClient failures.
For this query, this exception usually means that the given node name does not match any node in the cluster.
Remarks
Service Fabric is a distributed system where many components have a view of the same entity.
In an unstable or transient state, this view may not match GetReplicaListAsync(Guid) and GetDeployedReplicaDetailAsync(String, Guid, Int64)