Fabric Client. Health Client. Get Deployed Service Package Health Async Methode

Die Integrität eines bereitgestellten Service Fabric-Dienstpakets.

Ausnahmen

FabricObjectClosedException

Das FabricClient Objekt befindet sich in einem geschlossenen Zustand. Entsorgen Sie das FabricClient von Ihnen verwendete Objekt, und instanziieren Sie ein neues FabricClient Objekt.

ArgumentNullException

Wird zurückgegeben, wenn ein NULL-Verweis an eine Methode übergeben wird, die ihn nicht als gültiges Argument akzeptiert.

ArgumentException

Verursacht durch eine der folgenden:

E_INVALIDARG wird zurückgegeben, wenn mindestens ein Argument ungültig ist.

TimeoutException

Verursacht durch eine der folgenden:

OperationTimedOut wird zurückgegeben, wenn der Vorgang mehr benötigt als der benutzerseitig bereitgestellte timeout Vorgang ausführt.

FabricException

Verursacht durch eine der folgenden:

InvalidNameUri wird zurückgegeben, wenn applicationName kein gültiger Service Fabric-Name ist.

CommunicationError wird zurückgegeben, wenn ein Kommunikationsfehler dazu geführt hat, dass der Vorgang fehlschlägt.

FabricTransientException

Verursacht durch eine der folgenden:

ServiceTooBusy wird zurückgegeben, wenn der Dienst zu ausgelastet ist, um den Vorgang zu verarbeiten.

UnauthorizedAccessException

Verursacht durch eine der folgenden:

E_ACCESSDENIED wird zurückgegeben, wenn bei der Zugriffsprüfung für diesen Vorgang ein Fehler aufgetreten ist.

Gilt für:

GetDeployedServicePackageHealthAsync(Uri, String, String, ApplicationHealthPolicy)

Ruft asynchron die Integrität eines bereitgestellten Service Fabric-Dienstpakets ab.

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)

Parameter

applicationName: Uri

Der URI der Service Fabric-Anwendung.

serviceManifestName: String

Der Name der Dienstmanifestdatei für diesen Service Fabric-Dienst.

nodeName: String

Der Name des Knotens, in dem der Service Fabric-Dienst bereitgestellt wurde.

healthPolicy: ApplicationHealthPolicy

Die Anwendungsintegritätsrichtlinie, die zum Bewerten der Entitätsintegrität verwendet wird.

Gibt zurück

Die Integrität eines bereitgestellten Service Fabric-Dienstpakets.

Ausnahmen

FabricObjectClosedException

Das FabricClient Objekt befindet sich in einem geschlossenen Zustand. Entsorgen Sie das FabricClient von Ihnen verwendete Objekt, und instanziieren Sie ein neues FabricClient Objekt.

ArgumentNullException

Wird zurückgegeben, wenn ein NULL-Verweis an eine Methode übergeben wird, die ihn nicht als gültiges Argument akzeptiert.

ArgumentException

Verursacht durch eine der folgenden:

E_INVALIDARG wird zurückgegeben, wenn mindestens ein Argument ungültig ist.

TimeoutException

Verursacht durch eine der folgenden:

OperationTimedOut wird zurückgegeben, wenn der Vorgang mehr als die angegebene Zeit in Anspruch nimmt.

FabricException

Verursacht durch eine der folgenden:

InvalidNameUri wird zurückgegeben, wenn applicationName kein gültiger Service Fabric-Name ist.

CommunicationError wird zurückgegeben, wenn ein Kommunikationsfehler dazu geführt hat, dass der Vorgang fehlschlägt.

FabricTransientException

Verursacht durch eine der folgenden:

ServiceTooBusy wird zurückgegeben, wenn der Dienst zu ausgelastet ist, um den Vorgang zu verarbeiten.

UnauthorizedAccessException

Verursacht durch eine der folgenden:

E_ACCESSDENIED wird zurückgegeben, wenn bei der Zugriffsprüfung für diesen Vorgang ein Fehler aufgetreten ist.

Gilt für:

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

Ruft die Integrität eines bereitgestellten Service Fabric-Dienstpakets mithilfe des angegebenen Timeout- und Abbruchtokens asynchron ab.

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)

Parameter

applicationName: Uri

Der URI der Service Fabric-Anwendung.

serviceManifestName: String

Der Name der Dienstmanifestdatei für diesen Service Fabric-Dienst.

nodeName: String

Der Name des Knotens, in dem der Service Fabric-Dienst bereitgestellt wurde.

timeout: TimeSpan

Die maximale Zeitspanne, die Service Fabric ermöglicht, dass dieser Vorgang fortgesetzt werden kann, bevor ein TimeoutExceptionzurückgegeben wird.

cancellationToken: CancellationToken

Gibt zurück

Die Integrität eines bereitgestellten Service Fabric-Dienstpakets.

Ausnahmen

FabricObjectClosedException

Das FabricClient Objekt befindet sich in einem geschlossenen Zustand. Entsorgen Sie das FabricClient von Ihnen verwendete Objekt, und instanziieren Sie ein neues FabricClient Objekt.

ArgumentNullException

Wird zurückgegeben, wenn ein NULL-Verweis an eine Methode übergeben wird, die ihn nicht als gültiges Argument akzeptiert.

ArgumentException

Verursacht durch eine der folgenden:

E_INVALIDARG wird zurückgegeben, wenn mindestens ein Argument ungültig ist.

TimeoutException

Verursacht durch eine der folgenden:

OperationTimedOut wird zurückgegeben, wenn der Vorgang mehr benötigt als der benutzerseitig bereitgestellte timeout Vorgang ausführt.

FabricException

Verursacht durch eine der folgenden:

InvalidNameUri wird zurückgegeben, wenn applicationName kein gültiger Service Fabric-Name ist.

CommunicationError wird zurückgegeben, wenn ein Kommunikationsfehler dazu geführt hat, dass der Vorgang fehlschlägt.

FabricTransientException

Verursacht durch eine der folgenden:

ServiceTooBusy wird zurückgegeben, wenn der Dienst zu ausgelastet ist, um den Vorgang zu verarbeiten.

UnauthorizedAccessException

Verursacht durch eine der folgenden:

E_ACCESSDENIED wird zurückgegeben, wenn bei der Zugriffsprüfung für diesen Vorgang ein Fehler aufgetreten ist.

Gilt für:

GetDeployedServicePackageHealthAsync(DeployedServicePackageHealthQueryDescription, TimeSpan, CancellationToken)

Ruft die Integrität eines bereitgestellten Service Fabric-Dienstpakets mithilfe des angegebenen Timeout- und Abbruchtokens asynchron ab.

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)

Parameter

queryDescription: DeployedServicePackageHealthQueryDescription

Die Abfragebeschreibung.

timeout: TimeSpan

Die maximale Zeitspanne, die Service Fabric ermöglicht, dass dieser Vorgang fortgesetzt werden kann, bevor ein TimeoutExceptionzurückgegeben wird.

cancellationToken: CancellationToken

Gibt zurück

Die Integrität eines bereitgestellten Service Fabric-Dienstpakets.

Ausnahmen

FabricObjectClosedException

Informationen zur Behandlung allgemeiner FabricClient-Fehler finden Sie unter https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions .

TimeoutException

Informationen zur Behandlung allgemeiner FabricClient-Fehler finden Sie unter https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions .

FabricException

Verursacht durch eine der folgenden:

InvalidNameUri wird zurückgegeben, wenn ApplicationName kein gültiger Service Fabric-Name ist.

Siehe auch https://docs.microsoft.com/azure/service-fabric/service-fabric-errors-and-exceptions zur Behandlung allgemeiner FabricClient-Fehler.

ArgumentNullException

Wird zurückgegeben, wenn ein NULL-Verweis an eine Methode übergeben wird, die ihn nicht als gültiges Argument akzeptiert.

ArgumentException

Verursacht durch eine der folgenden:

E_INVALIDARG wird zurückgegeben, wenn mindestens ein Argument ungültig ist.

FabricTransientException

Verursacht durch eine der folgenden:

ServiceTooBusy wird zurückgegeben, wenn der Dienst zu ausgelastet ist, um den Vorgang zu verarbeiten.

UnauthorizedAccessException

Verursacht durch eine der folgenden:

E_ACCESSDENIED wird zurückgegeben, wenn bei der Zugriffsprüfung für diesen Vorgang ein Fehler aufgetreten ist.

Gilt für:

GetDeployedServicePackageHealthAsync(Uri, String, String)

Ruft asynchron die Integrität eines bereitgestellten Service Fabric-Dienstpakets ab.

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)

Parameter

applicationName: Uri

Der URI der Service Fabric-Anwendung.

serviceManifestName: String

Der Name der Dienstmanifestdatei für diesen Service Fabric-Dienst.

nodeName: String

Der Name des Knotens, in dem der Service Fabric-Dienst bereitgestellt wurde.

Gibt zurück

Die Integrität eines bereitgestellten Service Fabric-Dienstpakets.

Ausnahmen

FabricObjectClosedException

Das FabricClient Objekt befindet sich in einem geschlossenen Zustand. Entsorgen Sie das FabricClient von Ihnen verwendete Objekt, und instanziieren Sie ein neues FabricClient Objekt.

ArgumentNullException

Wird zurückgegeben, wenn ein NULL-Verweis an eine Methode übergeben wird, die ihn nicht als gültiges Argument akzeptiert.

ArgumentException

Verursacht durch eine der folgenden:

E_INVALIDARG wird zurückgegeben, wenn mindestens ein Argument ungültig ist.

TimeoutException

Verursacht durch eine der folgenden:

OperationTimedOut wird zurückgegeben, wenn der Vorgang mehr als die angegebene Zeit in Anspruch nimmt.

FabricException

Verursacht durch eine der folgenden:

InvalidNameUri wird zurückgegeben, wenn applicationName kein gültiger Service Fabric-Name ist.

CommunicationError wird zurückgegeben, wenn ein Kommunikationsfehler dazu geführt hat, dass der Vorgang fehlschlägt.

FabricTransientException

Verursacht durch eine der folgenden:

ServiceTooBusy wird zurückgegeben, wenn der Dienst zu ausgelastet ist, um den Vorgang zu verarbeiten.

UnauthorizedAccessException

Verursacht durch eine der folgenden:

E_ACCESSDENIED wird zurückgegeben, wenn bei der Zugriffsprüfung für diesen Vorgang ein Fehler aufgetreten ist.

Hinweise

Im folgenden Beispiel wird die Integrität eines bereitgestellten Dienstpakets abgerufen.

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

Gilt für:

GetDeployedServicePackageHealthAsync(DeployedServicePackageHealthQueryDescription)

Ruft die Integrität eines bereitgestellten Service Fabric-Dienstpakets mithilfe des angegebenen Timeout- und Abbruchtokens asynchron ab.

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)

Parameter

queryDescription: DeployedServicePackageHealthQueryDescription

Die Abfragebeschreibung.

Gibt zurück

Die Integrität eines bereitgestellten Service Fabric-Dienstpakets.

Ausnahmen

FabricObjectClosedException

Das FabricClient Objekt befindet sich in einem geschlossenen Zustand. Entsorgen Sie das FabricClient von Ihnen verwendete Objekt, und instanziieren Sie ein neues FabricClient Objekt.

ArgumentNullException

Wird zurückgegeben, wenn ein NULL-Verweis an eine Methode übergeben wird, die ihn nicht als gültiges Argument akzeptiert.

ArgumentException

Verursacht durch eine der folgenden:

E_INVALIDARG wird zurückgegeben, wenn mindestens ein Argument ungültig ist.

TimeoutException

Verursacht durch eine der folgenden:

OperationTimedOut wird zurückgegeben, wenn der Vorgang mehr als die angegebene Zeit in Anspruch nimmt.

FabricException

Verursacht durch eine der folgenden:

InvalidNameUri wird zurückgegeben, wenn ApplicationName kein gültiger Service Fabric-Name ist.

CommunicationError wird zurückgegeben, wenn ein Kommunikationsfehler dazu geführt hat, dass der Vorgang fehlschlägt.