Fabric Client. Health Client. Get Deployed Service Package Health Async Método

El estado de un paquete de servicio de Service Fabric implementado.

Excepciones

FabricObjectClosedException

El FabricClient objeto está en un estado cerrado. Elimine el FabricClient objeto que está usando y cree una instancia de un nuevo FabricClient objeto.

ArgumentNullException

Se devuelve cuando se pasa una referencia nula a un método que no lo acepta como argumento válido.

ArgumentException

Causado por una de las siguientes causas:

E_INVALIDARG se devuelve cuando uno o varios argumentos no son válidos.

TimeoutException

Causado por una de las siguientes causas:

OperationTimedOut se devuelve cuando la operación tarda más que el usuario proporcionado timeout para completarse.

FabricException

Causado por una de las siguientes causas:

InvalidNameUri se devuelve cuando applicationName no es un nombre de Service Fabric válido.

CommunicationError se devuelve cuando se produce un error de comunicación por el que se produce un error en la operación.

FabricTransientException

Causado por una de las siguientes causas:

ServiceTooBusy se devuelve cuando el servicio está demasiado ocupado para procesar la operación.

UnauthorizedAccessException

Causado por una de las siguientes causas:

E_ACCESSDENIED se devuelve cuando se ha producido un error en la comprobación de acceso para esta operación.

Se aplica a

GetDeployedServicePackageHealthAsync(Uri, String, String, ApplicationHealthPolicy)

Obtiene de forma asincrónica el estado de un paquete de servicio de Service Fabric implementado.

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

URI de la aplicación de Service Fabric.

serviceManifestName: String

Nombre del archivo de manifiesto de servicio para este servicio de Service Fabric.

nodeName: String

Nombre del nodo en el que se implementó el servicio de Service Fabric.

healthPolicy: ApplicationHealthPolicy

Directiva de estado de la aplicación que se usa para evaluar el estado de la entidad.

Devoluciones

El estado de un paquete de servicio de Service Fabric implementado.

Excepciones

FabricObjectClosedException

El FabricClient objeto está en un estado cerrado. Elimine el FabricClient objeto que está usando y cree una instancia de un nuevo FabricClient objeto.

ArgumentNullException

Se devuelve cuando se pasa una referencia nula a un método que no lo acepta como argumento válido.

ArgumentException

Causado por una de las siguientes causas:

E_INVALIDARG se devuelve cuando uno o varios argumentos no son válidos.

TimeoutException

Causado por una de las siguientes causas:

OperationTimedOut se devuelve cuando la operación tarda más que el tiempo especificado en completarse.

FabricException

Causado por una de las siguientes causas:

InvalidNameUri se devuelve cuando applicationName no es un nombre de Service Fabric válido.

CommunicationError se devuelve cuando se produce un error de comunicación por el que se produce un error en la operación.

FabricTransientException

Causado por una de las siguientes causas:

ServiceTooBusy se devuelve cuando el servicio está demasiado ocupado para procesar la operación.

UnauthorizedAccessException

Causado por una de las siguientes causas:

E_ACCESSDENIED se devuelve cuando se ha producido un error en la comprobación de acceso para esta operación.

Se aplica a

GetDeployedServicePackageHealthAsync(Uri, String, String, TimeSpan, CancellationToken)

Obtiene de forma asincrónica el estado de un paquete de servicio de Service Fabric implementado mediante el tiempo de espera y el token de cancelación 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

URI de la aplicación de Service Fabric.

serviceManifestName: String

Nombre del archivo de manifiesto de servicio para este servicio de Service Fabric.

nodeName: String

Nombre del nodo en el que se implementó el servicio de Service Fabric.

timeout: TimeSpan

La cantidad máxima de tiempo que Service Fabric permitirá que esta operación continúe antes de devolver .TimeoutException

cancellationToken: CancellationToken

Devoluciones

El estado de un paquete de servicio de Service Fabric implementado.

Excepciones

FabricObjectClosedException

El FabricClient objeto está en un estado cerrado. Elimine el FabricClient objeto que está usando y cree una instancia de un nuevo FabricClient objeto.

ArgumentNullException

Se devuelve cuando se pasa una referencia nula a un método que no lo acepta como argumento válido.

ArgumentException

Causado por una de las siguientes causas:

E_INVALIDARG se devuelve cuando uno o varios argumentos no son válidos.

TimeoutException

Causado por una de las siguientes causas:

OperationTimedOut se devuelve cuando la operación tarda más que el usuario proporcionado timeout para completarse.

FabricException

Causado por una de las siguientes causas:

InvalidNameUri se devuelve cuando applicationName no es un nombre de Service Fabric válido.

CommunicationError se devuelve cuando se produce un error de comunicación por el que se produce un error en la operación.

FabricTransientException

Causado por una de las siguientes causas:

ServiceTooBusy se devuelve cuando el servicio está demasiado ocupado para procesar la operación.

UnauthorizedAccessException

Causado por una de las siguientes causas:

E_ACCESSDENIED se devuelve cuando se ha producido un error en la comprobación de acceso para esta operación.

Se aplica a

GetDeployedServicePackageHealthAsync(DeployedServicePackageHealthQueryDescription, TimeSpan, CancellationToken)

Obtiene de forma asincrónica el estado de un paquete de servicio de Service Fabric implementado mediante el tiempo de espera y el token de cancelación 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

Descripción de la consulta.

timeout: TimeSpan

La cantidad máxima de tiempo que Service Fabric permitirá que esta operación continúe antes de devolver .TimeoutException

cancellationToken: CancellationToken

Devoluciones

El estado de un paquete de servicio de Service Fabric implementado.

Excepciones

FabricObjectClosedException

Consulte https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions para controlar errores comunes de FabricClient.

TimeoutException

Consulte https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions para controlar errores comunes de FabricClient.

FabricException

Causado por una de las siguientes causas:

InvalidNameUri se devuelve cuando ApplicationName no es un nombre de Service Fabric válido.

Consulte también https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions para controlar errores comunes de FabricClient.

ArgumentNullException

Se devuelve cuando se pasa una referencia nula a un método que no lo acepta como argumento válido.

ArgumentException

Causado por una de las siguientes causas:

E_INVALIDARG se devuelve cuando uno o varios argumentos no son válidos.

FabricTransientException

Causado por una de las siguientes causas:

ServiceTooBusy se devuelve cuando el servicio está demasiado ocupado para procesar la operación.

UnauthorizedAccessException

Causado por una de las siguientes causas:

E_ACCESSDENIED se devuelve cuando se ha producido un error en la comprobación de acceso para esta operación.

Se aplica a

GetDeployedServicePackageHealthAsync(Uri, String, String)

Obtiene de forma asincrónica el estado de un paquete de servicio de Service Fabric implementado.

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

URI de la aplicación de Service Fabric.

serviceManifestName: String

Nombre del archivo de manifiesto de servicio para este servicio de Service Fabric.

nodeName: String

Nombre del nodo en el que se implementó el servicio de Service Fabric.

Devoluciones

El estado de un paquete de servicio de Service Fabric implementado.

Excepciones

FabricObjectClosedException

El FabricClient objeto está en un estado cerrado. Elimine el FabricClient objeto que está usando y cree una instancia de un nuevo FabricClient objeto.

ArgumentNullException

Se devuelve cuando se pasa una referencia nula a un método que no lo acepta como argumento válido.

ArgumentException

Causado por una de las siguientes causas:

E_INVALIDARG se devuelve cuando uno o varios argumentos no son válidos.

TimeoutException

Causado por una de las siguientes causas:

OperationTimedOut se devuelve cuando la operación tarda más que el tiempo especificado en completarse.

FabricException

Causado por una de las siguientes causas:

InvalidNameUri se devuelve cuando applicationName no es un nombre de Service Fabric válido.

CommunicationError se devuelve cuando se produce un error de comunicación por el que se produce un error en la operación.

FabricTransientException

Causado por una de las siguientes causas:

ServiceTooBusy se devuelve cuando el servicio está demasiado ocupado para procesar la operación.

UnauthorizedAccessException

Causado por una de las siguientes causas:

E_ACCESSDENIED se devuelve cuando se ha producido un error en la comprobación de acceso para esta operación.

Comentarios

En el ejemplo siguiente se obtiene el estado de un paquete de servicio implementado.

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;
            }

Se aplica a

GetDeployedServicePackageHealthAsync(DeployedServicePackageHealthQueryDescription)

Obtiene de forma asincrónica el estado de un paquete de servicio de Service Fabric implementado mediante el tiempo de espera y el token de cancelación 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

Descripción de la consulta.

Devoluciones

El estado de un paquete de servicio de Service Fabric implementado.

Excepciones

FabricObjectClosedException

El FabricClient objeto está en un estado cerrado. Elimine el FabricClient objeto que está usando y cree una instancia de un nuevo FabricClient objeto.

ArgumentNullException

Se devuelve cuando se pasa una referencia nula a un método que no lo acepta como argumento válido.

ArgumentException

Causado por una de las siguientes causas:

E_INVALIDARG se devuelve cuando uno o varios argumentos no son válidos.

TimeoutException

Causado por una de las siguientes causas:

OperationTimedOut se devuelve cuando la operación tarda más que el tiempo especificado en completarse.

FabricException

Causado por una de las siguientes causas:

InvalidNameUri se devuelve cuando ApplicationName no es un nombre de Service Fabric válido.

CommunicationError se devuelve cuando se produce un error de comunicación por el que se produce un error en la operación.