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

Intégrité d’un package de service Service Fabric déployé.

Exceptions

FabricObjectClosedException

L’objet FabricClient est dans un état fermé. Supprimer l’objet que FabricClient vous utilisez et instancier un nouvel FabricClient objet.

ArgumentNullException

Retourné lorsqu’une référence null est passée à une méthode qui ne l’accepte pas comme argument valide.

ArgumentException

Causé par l’un des éléments suivants :

E_INVALIDARG est retourné lorsqu’un ou plusieurs arguments ne sont pas valides.

TimeoutException

Causé par l’un des éléments suivants :

OperationTimedOut est retourné lorsque l’opération prend plus de temps que celui fourni timeout par l’utilisateur.

FabricException

Causé par l’un des éléments suivants :

InvalidNameUri est retourné lorsque applicationName n’est pas un nom Service Fabric valide.

CommunicationError est retourné lorsqu’une erreur de communication a provoqué l’échec de l’opération.

FabricTransientException

Causé par l’un des éléments suivants :

ServiceTooBusy est retourné lorsque le service est trop occupé pour traiter l’opération.

UnauthorizedAccessException

Causé par l’un des éléments suivants :

E_ACCESSDENIED est retourné lorsque le case activée d’accès a échoué pour cette opération.

S’applique à

GetDeployedServicePackageHealthAsync(Uri, String, String, ApplicationHealthPolicy)

Obtient de manière asynchrone l’intégrité d’un package de service Service Fabric déployé.

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)

Paramètres

applicationName: Uri

URI de l’application Service Fabric.

serviceManifestName: String

Nom du fichier manifeste de service pour ce service Service Fabric.

nodeName: String

Nom du nœud sur lequel le service Service Fabric a été déployé.

healthPolicy: ApplicationHealthPolicy

Stratégie d’intégrité de l’application utilisée pour évaluer l’intégrité de l’entité.

Retours

Intégrité d’un package de service Service Fabric déployé.

Exceptions

FabricObjectClosedException

L’objet FabricClient est dans un état fermé. Supprimer l’objet que FabricClient vous utilisez et instancier un nouvel FabricClient objet.

ArgumentNullException

Retourné lorsqu’une référence null est passée à une méthode qui ne l’accepte pas comme argument valide.

ArgumentException

Causé par l’un des éléments suivants :

E_INVALIDARG est retourné lorsqu’un ou plusieurs arguments ne sont pas valides.

TimeoutException

Causé par l’un des éléments suivants :

OperationTimedOut est retourné lorsque l’opération prend plus de temps que le temps spécifié.

FabricException

Causé par l’un des éléments suivants :

InvalidNameUri est retourné lorsque applicationName n’est pas un nom Service Fabric valide.

CommunicationError est retourné lorsqu’une erreur de communication a provoqué l’échec de l’opération.

FabricTransientException

Causé par l’un des éléments suivants :

ServiceTooBusy est retourné lorsque le service est trop occupé pour traiter l’opération.

UnauthorizedAccessException

Causé par l’un des éléments suivants :

E_ACCESSDENIED est retourné lorsque le case activée d’accès a échoué pour cette opération.

S’applique à

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

Obtient de manière asynchrone l’intégrité d’un package de service Service Fabric déployé à l’aide du délai d’expiration et du jeton d’annulation spécifiés.

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)

Paramètres

applicationName: Uri

URI de l’application Service Fabric.

serviceManifestName: String

Nom du fichier manifeste de service pour ce service Service Fabric.

nodeName: String

Nom du nœud sur lequel le service Service Fabric a été déployé.

timeout: TimeSpan

La durée maximale pendant laquelle Service Fabric autorise cette opération à se poursuivre avant de retourner un TimeoutException.

cancellationToken: CancellationToken

Retours

Intégrité d’un package de service Service Fabric déployé.

Exceptions

FabricObjectClosedException

L’objet FabricClient est dans un état fermé. Supprimer l’objet que FabricClient vous utilisez et instancier un nouvel FabricClient objet.

ArgumentNullException

Retourné lorsqu’une référence null est passée à une méthode qui ne l’accepte pas comme argument valide.

ArgumentException

Causé par l’un des éléments suivants :

E_INVALIDARG est retourné lorsqu’un ou plusieurs arguments ne sont pas valides.

TimeoutException

Causé par l’un des éléments suivants :

OperationTimedOut est retourné lorsque l’opération prend plus de temps que celui fourni timeout par l’utilisateur.

FabricException

Causé par l’un des éléments suivants :

InvalidNameUri est retourné lorsque applicationName n’est pas un nom Service Fabric valide.

CommunicationError est retourné lorsqu’une erreur de communication a provoqué l’échec de l’opération.

FabricTransientException

Causé par l’un des éléments suivants :

ServiceTooBusy est retourné lorsque le service est trop occupé pour traiter l’opération.

UnauthorizedAccessException

Causé par l’un des éléments suivants :

E_ACCESSDENIED est retourné lorsque le case activée d’accès a échoué pour cette opération.

S’applique à

GetDeployedServicePackageHealthAsync(DeployedServicePackageHealthQueryDescription, TimeSpan, CancellationToken)

Obtient de manière asynchrone l’intégrité d’un package de service Service Fabric déployé à l’aide du délai d’expiration et du jeton d’annulation spécifiés.

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)

Paramètres

queryDescription: DeployedServicePackageHealthQueryDescription

Description de la requête.

timeout: TimeSpan

La durée maximale pendant laquelle Service Fabric autorise cette opération à se poursuivre avant de retourner un TimeoutException.

cancellationToken: CancellationToken

Retours

Intégrité d’un package de service Service Fabric déployé.

Exceptions

FabricObjectClosedException

Consultez https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions pour gérer les échecs FabricClient courants.

TimeoutException

Consultez https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions pour gérer les échecs FabricClient courants.

FabricException

Causé par l’un des éléments suivants :

InvalidNameUri est retourné lorsque ApplicationName n’est pas un nom Service Fabric valide.

Consultez également https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions pour gérer les échecs FabricClient courants.

ArgumentNullException

Retourné lorsqu’une référence null est passée à une méthode qui ne l’accepte pas comme argument valide.

ArgumentException

Causé par l’un des éléments suivants :

E_INVALIDARG est retourné lorsqu’un ou plusieurs arguments ne sont pas valides.

FabricTransientException

Causé par l’un des éléments suivants :

ServiceTooBusy est retourné lorsque le service est trop occupé pour traiter l’opération.

UnauthorizedAccessException

Causé par l’un des éléments suivants :

E_ACCESSDENIED est retourné lorsque le case activée d’accès a échoué pour cette opération.

S’applique à

GetDeployedServicePackageHealthAsync(Uri, String, String)

Obtient de manière asynchrone l’intégrité d’un package de service Service Fabric déployé.

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)

Paramètres

applicationName: Uri

URI de l’application Service Fabric.

serviceManifestName: String

Nom du fichier manifeste de service pour ce service Service Fabric.

nodeName: String

Nom du nœud sur lequel le service Service Fabric a été déployé.

Retours

Intégrité d’un package de service Service Fabric déployé.

Exceptions

FabricObjectClosedException

L’objet FabricClient est dans un état fermé. Supprimer l’objet que FabricClient vous utilisez et instancier un nouvel FabricClient objet.

ArgumentNullException

Retourné lorsqu’une référence null est passée à une méthode qui ne l’accepte pas comme argument valide.

ArgumentException

Causé par l’un des éléments suivants :

E_INVALIDARG est retourné lorsqu’un ou plusieurs arguments ne sont pas valides.

TimeoutException

Causé par l’un des éléments suivants :

OperationTimedOut est retourné lorsque l’opération prend plus de temps que le délai spécifié.

FabricException

Causé par l’un des éléments suivants :

InvalidNameUri est retourné lorsque applicationName n’est pas un nom Service Fabric valide.

CommunicationError est retourné lorsqu’une erreur de communication a provoqué l’échec de l’opération.

FabricTransientException

Causé par l’un des éléments suivants :

ServiceTooBusy est retourné lorsque le service est trop occupé pour traiter l’opération.

UnauthorizedAccessException

Causé par l’un des éléments suivants :

E_ACCESSDENIED est retourné lorsque le case activée d’accès a échoué pour cette opération.

Remarques

L’exemple suivant obtient l’intégrité d’un package de service déployé.

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

S’applique à

GetDeployedServicePackageHealthAsync(DeployedServicePackageHealthQueryDescription)

Obtient de manière asynchrone l’intégrité d’un package de service Service Fabric déployé à l’aide du délai d’expiration et du jeton d’annulation spécifiés.

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)

Paramètres

queryDescription: DeployedServicePackageHealthQueryDescription

Description de la requête.

Retours

Intégrité d’un package de service Service Fabric déployé.

Exceptions

FabricObjectClosedException

L’objet FabricClient est dans un état fermé. Supprimer l’objet que FabricClient vous utilisez et instancier un nouvel FabricClient objet.

ArgumentNullException

Retourné lorsqu’une référence null est passée à une méthode qui ne l’accepte pas comme argument valide.

ArgumentException

Causé par l’un des éléments suivants :

E_INVALIDARG est retourné lorsqu’un ou plusieurs arguments ne sont pas valides.

TimeoutException

Causé par l’un des éléments suivants :

OperationTimedOut est retourné lorsque l’opération prend plus de temps que le délai spécifié.

FabricException

Causé par l’un des éléments suivants :

InvalidNameUri est retourné lorsque ApplicationName n’est pas un nom Service Fabric valide.

CommunicationError est retourné lorsqu’une erreur de communication a provoqué l’échec de l’opération.