FabricClient.HealthClient.GetDeployedServicePackageHealthAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
GetDeployedServicePackageHealthAsync(Uri, String, String, ApplicationHealthPolicy, TimeSpan, CancellationToken) |
Obtém de forma assíncrona a integridade de um pacote de serviço do Service Fabric implantado usando o tempo limite e o token de cancelamento especificados. |
GetDeployedServicePackageHealthAsync(Uri, String, String, ApplicationHealthPolicy) |
Obtém de forma assíncrona a integridade de um pacote de serviço do Service Fabric implantado. |
GetDeployedServicePackageHealthAsync(Uri, String, String, TimeSpan, CancellationToken) |
Obtém de forma assíncrona a integridade de um pacote de serviço do Service Fabric implantado usando o tempo limite e o token de cancelamento especificados. |
GetDeployedServicePackageHealthAsync(DeployedServicePackageHealthQueryDescription, TimeSpan, CancellationToken) |
Obtém de forma assíncrona a integridade de um pacote de serviço do Service Fabric implantado usando o tempo limite e o token de cancelamento especificados. |
GetDeployedServicePackageHealthAsync(Uri, String, String) |
Obtém de forma assíncrona a integridade de um pacote de serviço do Service Fabric implantado. |
GetDeployedServicePackageHealthAsync(DeployedServicePackageHealthQueryDescription) |
Obtém de forma assíncrona a integridade de um pacote de serviço do Service Fabric implantado usando o tempo limite e o token de cancelamento especificados. |
GetDeployedServicePackageHealthAsync(Uri, String, String, ApplicationHealthPolicy, TimeSpan, CancellationToken)
Obtém de forma assíncrona a integridade de um pacote de serviço do Service Fabric implantado usando o tempo limite e o token de cancelamento especificados.
public System.Threading.Tasks.Task<System.Fabric.Health.DeployedServicePackageHealth> GetDeployedServicePackageHealthAsync (Uri applicationName, string serviceManifestName, string nodeName, System.Fabric.Health.ApplicationHealthPolicy healthPolicy, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
member this.GetDeployedServicePackageHealthAsync : Uri * string * string * System.Fabric.Health.ApplicationHealthPolicy * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Fabric.Health.DeployedServicePackageHealth>
Public Function GetDeployedServicePackageHealthAsync (applicationName As Uri, serviceManifestName As String, nodeName As String, healthPolicy As ApplicationHealthPolicy, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of DeployedServicePackageHealth)
Parâmetros
- applicationName
- Uri
O URI do aplicativo do Service Fabric.
- serviceManifestName
- String
O nome do arquivo de manifesto de serviço para esse serviço do Service Fabric.
- nodeName
- String
O nome do nó no qual o serviço do Service Fabric foi implantado.
- healthPolicy
- ApplicationHealthPolicy
A política de integridade do aplicativo usada para avaliar a integridade da entidade.
- timeout
- TimeSpan
A quantidade máxima de tempo que o Service Fabric permitirá que essa operação continue antes de retornar um TimeoutException.
- cancellationToken
- CancellationToken
O token de cancelamento opcional que a operação está observando. Ele pode ser usado para enviar uma notificação de que a operação deve ser cancelada. Observe que o cancelamento é um aviso e que a operação ainda pode ser concluída mesmo se ela for cancelada.
Retornos
A integridade de um pacote de serviço do Service Fabric implantado.
Exceções
O FabricClient objeto está em um estado fechado. Descarte o objeto que FabricClient você está usando e instancie um novo FabricClient objeto.
Retornado quando uma referência nula é passada para um método que não a aceita como um argumento válido.
Causado por um dos seguintes:
E_INVALIDARG é retornado quando um ou mais argumentos não são válidos.
Causado por um dos seguintes:
OperationTimedOut é retornado quando a operação leva mais do que o usuário fornecido timeout
para concluir.
Causado por um dos seguintes:
InvalidNameUri é retornado quando applicationName
não é um nome válido do Service Fabric.
CommunicationError é retornado quando um erro de comunicação fez com que a operação falhasse.
Causado por um dos seguintes:
ServiceTooBusy é retornado quando o serviço está muito ocupado para processar a operação.
Causado por um dos seguintes:
E_ACCESSDENIED é retornado quando a marcar de acesso falha nessa operação.
Aplica-se a
GetDeployedServicePackageHealthAsync(Uri, String, String, ApplicationHealthPolicy)
Obtém de forma assíncrona a integridade de um pacote de serviço do Service Fabric implantado.
public System.Threading.Tasks.Task<System.Fabric.Health.DeployedServicePackageHealth> GetDeployedServicePackageHealthAsync (Uri applicationName, string serviceManifestName, string nodeName, System.Fabric.Health.ApplicationHealthPolicy healthPolicy);
member this.GetDeployedServicePackageHealthAsync : Uri * string * string * System.Fabric.Health.ApplicationHealthPolicy -> System.Threading.Tasks.Task<System.Fabric.Health.DeployedServicePackageHealth>
Public Function GetDeployedServicePackageHealthAsync (applicationName As Uri, serviceManifestName As String, nodeName As String, healthPolicy As ApplicationHealthPolicy) As Task(Of DeployedServicePackageHealth)
Parâmetros
- applicationName
- Uri
O URI do aplicativo do Service Fabric.
- serviceManifestName
- String
O nome do arquivo de manifesto de serviço para esse serviço do Service Fabric.
- nodeName
- String
O nome do nó no qual o serviço do Service Fabric foi implantado.
- healthPolicy
- ApplicationHealthPolicy
A política de integridade do aplicativo usada para avaliar a integridade da entidade.
Retornos
A integridade de um pacote de serviço do Service Fabric implantado.
Exceções
O FabricClient objeto está em um estado fechado. Descarte o objeto que FabricClient você está usando e instancie um novo FabricClient objeto.
Retornado quando uma referência nula é passada para um método que não a aceita como um argumento válido.
Causado por um dos seguintes:
E_INVALIDARG é retornado quando um ou mais argumentos não são válidos.
Causado por um dos seguintes:
OperationTimedOut é retornado quando a operação leva mais do que o tempo especificado para ser concluída.
Causado por um dos seguintes:
InvalidNameUri é retornado quando applicationName
não é um nome válido do Service Fabric.
CommunicationError é retornado quando um erro de comunicação fez com que a operação falhasse.
Causado por um dos seguintes:
ServiceTooBusy é retornado quando o serviço está muito ocupado para processar a operação.
Causado por um dos seguintes:
E_ACCESSDENIED é retornado quando a marcar de acesso falha nessa operação.
Aplica-se a
GetDeployedServicePackageHealthAsync(Uri, String, String, TimeSpan, CancellationToken)
Obtém de forma assíncrona a integridade de um pacote de serviço do Service Fabric implantado usando o tempo limite e o token de cancelamento especificados.
public System.Threading.Tasks.Task<System.Fabric.Health.DeployedServicePackageHealth> GetDeployedServicePackageHealthAsync (Uri applicationName, string serviceManifestName, string nodeName, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
member this.GetDeployedServicePackageHealthAsync : Uri * string * string * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Fabric.Health.DeployedServicePackageHealth>
Public Function GetDeployedServicePackageHealthAsync (applicationName As Uri, serviceManifestName As String, nodeName As String, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of DeployedServicePackageHealth)
Parâmetros
- applicationName
- Uri
O URI do aplicativo do Service Fabric.
- serviceManifestName
- String
O nome do arquivo de manifesto de serviço para esse serviço do Service Fabric.
- nodeName
- String
O nome do nó no qual o serviço do Service Fabric foi implantado.
- timeout
- TimeSpan
A quantidade máxima de tempo que o Service Fabric permitirá que essa operação continue antes de retornar um TimeoutException.
- cancellationToken
- CancellationToken
O token de cancelamento opcional que a operação está observando. Ele pode ser usado para enviar uma notificação de que a operação deve ser cancelada. Observe que o cancelamento é um aviso e que a operação ainda pode ser concluída mesmo se ela for cancelada.
Retornos
A integridade de um pacote de serviço do Service Fabric implantado.
Exceções
O FabricClient objeto está em um estado fechado. Descarte o objeto que FabricClient você está usando e instancie um novo FabricClient objeto.
Retornado quando uma referência nula é passada para um método que não a aceita como um argumento válido.
Causado por um dos seguintes:
E_INVALIDARG é retornado quando um ou mais argumentos não são válidos.
Causado por um dos seguintes:
OperationTimedOut é retornado quando a operação leva mais do que o usuário fornecido timeout
para concluir.
Causado por um dos seguintes:
InvalidNameUri é retornado quando applicationName
não é um nome válido do Service Fabric.
CommunicationError é retornado quando um erro de comunicação fez com que a operação falhasse.
Causado por um dos seguintes:
ServiceTooBusy é retornado quando o serviço está muito ocupado para processar a operação.
Causado por um dos seguintes:
E_ACCESSDENIED é retornado quando a marcar de acesso falha nessa operação.
Aplica-se a
GetDeployedServicePackageHealthAsync(DeployedServicePackageHealthQueryDescription, TimeSpan, CancellationToken)
Obtém de forma assíncrona a integridade de um pacote de serviço do Service Fabric implantado usando o tempo limite e o token de cancelamento especificados.
public System.Threading.Tasks.Task<System.Fabric.Health.DeployedServicePackageHealth> GetDeployedServicePackageHealthAsync (System.Fabric.Description.DeployedServicePackageHealthQueryDescription queryDescription, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
member this.GetDeployedServicePackageHealthAsync : System.Fabric.Description.DeployedServicePackageHealthQueryDescription * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Fabric.Health.DeployedServicePackageHealth>
Public Function GetDeployedServicePackageHealthAsync (queryDescription As DeployedServicePackageHealthQueryDescription, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of DeployedServicePackageHealth)
Parâmetros
- queryDescription
- DeployedServicePackageHealthQueryDescription
A descrição da consulta.
- timeout
- TimeSpan
A quantidade máxima de tempo que o Service Fabric permitirá que essa operação continue antes de retornar um TimeoutException.
- cancellationToken
- CancellationToken
O token de cancelamento opcional que a operação está observando. Ele pode ser usado para enviar uma notificação de que a operação deve ser cancelada. Observe que o cancelamento é um aviso e que a operação ainda pode ser concluída mesmo se ela for cancelada.
Retornos
A integridade de um pacote de serviço do Service Fabric implantado.
Exceções
Consulte https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions para lidar com falhas comuns do FabricClient.
Consulte https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions para lidar com falhas comuns do FabricClient.
Causado por um dos seguintes:
InvalidNameUri é retornado quando ApplicationName não é um nome válido do Service Fabric.
Consulte também https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions para lidar com falhas comuns do FabricClient.
Retornado quando uma referência nula é passada para um método que não a aceita como um argumento válido.
Causado por um dos seguintes:
E_INVALIDARG é retornado quando um ou mais argumentos não são válidos.
Causado por um dos seguintes:
ServiceTooBusy é retornado quando o serviço está muito ocupado para processar a operação.
Causado por um dos seguintes:
E_ACCESSDENIED é retornado quando a marcar de acesso falha nessa operação.
Aplica-se a
GetDeployedServicePackageHealthAsync(Uri, String, String)
Obtém de forma assíncrona a integridade de um pacote de serviço do Service Fabric implantado.
public System.Threading.Tasks.Task<System.Fabric.Health.DeployedServicePackageHealth> GetDeployedServicePackageHealthAsync (Uri applicationName, string serviceManifestName, string nodeName);
member this.GetDeployedServicePackageHealthAsync : Uri * string * string -> System.Threading.Tasks.Task<System.Fabric.Health.DeployedServicePackageHealth>
Public Function GetDeployedServicePackageHealthAsync (applicationName As Uri, serviceManifestName As String, nodeName As String) As Task(Of DeployedServicePackageHealth)
Parâmetros
- applicationName
- Uri
O URI do aplicativo do Service Fabric.
- serviceManifestName
- String
O nome do arquivo de manifesto de serviço para esse serviço do Service Fabric.
- nodeName
- String
O nome do nó no qual o serviço do Service Fabric foi implantado.
Retornos
A integridade de um pacote de serviço do Service Fabric implantado.
Exceções
O FabricClient objeto está em um estado fechado. Descarte o objeto que FabricClient você está usando e instancie um novo FabricClient objeto.
Retornado quando uma referência nula é passada para um método que não a aceita como um argumento válido.
Causado por um dos seguintes:
E_INVALIDARG é retornado quando um ou mais argumentos não são válidos.
Causado por um dos seguintes:
OperationTimedOut é retornado quando a operação leva mais do que o tempo especificado para ser concluída.
Causado por um dos seguintes:
InvalidNameUri é retornado quando applicationName
não é um nome válido do Service Fabric.
CommunicationError é retornado quando um erro de comunicação fez com que a operação falhasse.
Causado por um dos seguintes:
ServiceTooBusy é retornado quando o serviço está muito ocupado para processar a operação.
Causado por um dos seguintes:
E_ACCESSDENIED é retornado quando a marcar de acesso falha nessa operação.
Comentários
O exemplo a seguir obtém a integridade de um pacote de serviço implantado.
public static bool GetDeployedServicePackageHealth(string clusterConnection)
{
DeployedApplicationHealth deployedApplicationHealth;
DeployedServicePackageHealth deployedServicePackageHealth;
ApplicationHealth applicationHealth;
Uri applicationName = new Uri("fabric:/myapp/todo");
// Connect to the cluster.
FabricClient fabricClient = new FabricClient(clusterConnection);
Console.WriteLine("Deployed Service Package Health:");
try
{
// Determine the nodes where the application has been deployed.
applicationHealth = fabricClient.HealthManager.GetApplicationHealthAsync(applicationName).Result;
// Get the deployed service package health for each node.
IList<DeployedApplicationHealthState> deployedApplicationHealthStateList = applicationHealth.DeployedApplicationHealthStates;
foreach (DeployedApplicationHealthState deployedApplicationHealthState in deployedApplicationHealthStateList)
{
// Get the deployed application health, which contains the service manifest name and
// the names of the nodes where the service has been deployed.
deployedApplicationHealth = fabricClient.HealthManager.GetDeployedApplicationHealthAsync(applicationName,
deployedApplicationHealthState.NodeName).Result;
// Return if empty.
if (deployedApplicationHealth.DeployedServicePackageHealthStates.Count == 0)
return false;
// Get the deployed service package health.
deployedServicePackageHealth = fabricClient.HealthManager.GetDeployedServicePackageHealthAsync(applicationName,
deployedApplicationHealth.DeployedServicePackageHealthStates[0].ServiceManifestName,
deployedApplicationHealthState.NodeName).Result;
// Display the deployed service package health information.
Console.WriteLine(" Application Name: " + deployedServicePackageHealth.ApplicationName);
Console.WriteLine(" Node Name: " + deployedServicePackageHealth.NodeName);
Console.WriteLine(" Aggregated Health State: " + deployedServicePackageHealth.AggregatedHealthState);
Console.WriteLine(" Service Manifest Name: " + deployedServicePackageHealth.ServiceManifestName);
// List the health events.
Console.WriteLine(" Health Events:");
IList<HealthEvent> healthEvents = deployedServicePackageHealth.HealthEvents;
foreach (HealthEvent healthEvent in healthEvents)
{
Console.WriteLine(" Health Event:");
Console.WriteLine(" Last Modified: " + healthEvent.LastModifiedUtcTimestamp);
Console.WriteLine(" Source UTC Timestamp: " + healthEvent.SourceUtcTimestamp);
Console.WriteLine(" Is Expired: " + healthEvent.IsExpired);
Console.WriteLine(" Health Information:");
Console.WriteLine(" Description: " + healthEvent.HealthInformation.Description);
Console.WriteLine(" Source ID: " + healthEvent.HealthInformation.SourceId);
Console.WriteLine(" Health State: " + healthEvent.HealthInformation.HealthState);
Console.WriteLine(" Property: " + healthEvent.HealthInformation.Property);
Console.WriteLine(" Remove When Expired: " + healthEvent.HealthInformation.RemoveWhenExpired);
Console.WriteLine(" Sequence Number: " + healthEvent.HealthInformation.SequenceNumber);
Console.WriteLine(" Time to Live: " + healthEvent.HealthInformation.TimeToLive);
}
// List the unhealthy evaluations.
Console.WriteLine(" Unhealthy Evaluations:");
IList<HealthEvaluation> healthEvaluationList = deployedServicePackageHealth.UnhealthyEvaluations;
foreach (HealthEvaluation healthEvaluation in healthEvaluationList)
{
Console.WriteLine(" Kind: " + healthEvaluation.Kind);
Console.WriteLine(" Aggregated Health State: " + healthEvaluation.AggregatedHealthState);
Console.WriteLine(" Description: " + healthEvaluation.Description);
}
Console.WriteLine();
}
}
catch (Exception e)
{
Console.WriteLine("Error: " + e.Message);
if (e.InnerException != null)
Console.WriteLine(" Inner Exception: " + e.InnerException.Message);
return false;
}
return true;
}
Aplica-se a
GetDeployedServicePackageHealthAsync(DeployedServicePackageHealthQueryDescription)
Obtém de forma assíncrona a integridade de um pacote de serviço do Service Fabric implantado usando o tempo limite e o token de cancelamento especificados.
public System.Threading.Tasks.Task<System.Fabric.Health.DeployedServicePackageHealth> GetDeployedServicePackageHealthAsync (System.Fabric.Description.DeployedServicePackageHealthQueryDescription queryDescription);
member this.GetDeployedServicePackageHealthAsync : System.Fabric.Description.DeployedServicePackageHealthQueryDescription -> System.Threading.Tasks.Task<System.Fabric.Health.DeployedServicePackageHealth>
Public Function GetDeployedServicePackageHealthAsync (queryDescription As DeployedServicePackageHealthQueryDescription) As Task(Of DeployedServicePackageHealth)
Parâmetros
- queryDescription
- DeployedServicePackageHealthQueryDescription
A descrição da consulta.
Retornos
A integridade de um pacote de serviço do Service Fabric implantado.
Exceções
O FabricClient objeto está em um estado fechado. Descarte o objeto que FabricClient você está usando e instancie um novo FabricClient objeto.
Retornado quando uma referência nula é passada para um método que não a aceita como um argumento válido.
Causado por um dos seguintes:
E_INVALIDARG é retornado quando um ou mais argumentos não são válidos.
Causado por um dos seguintes:
OperationTimedOut é retornado quando a operação leva mais do que o tempo especificado para ser concluída.
Causado por um dos seguintes:
InvalidNameUri é retornado quando ApplicationName não é um nome válido do Service Fabric.
CommunicationError é retornado quando um erro de comunicação fez com que a operação falhasse.
Causado por um dos seguintes:
ServiceTooBusy é retornado quando o serviço está muito ocupado para processar a operação.
Causado por um dos seguintes:
E_ACCESSDENIED é retornado quando a marcar de acesso falha nessa operação.
Aplica-se a
Azure SDK for .NET