FabricClient.HealthClient.GetApplicationHealthAsync Methode

Referenz

Definition

Namespace:: System.Fabric

Assembly:: System.Fabric.dll

Paket:: Microsoft.ServiceFabric v9.1.1833

Paket:: Microsoft.ServiceFabric v8.2.1748

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

GetApplicationHealthAsync(ApplicationHealthQueryDescription)	Ruft die Integrität der angegebenen Service Fabric-Anwendung mithilfe der angegebenen Abfragebeschreibung asynchron ab.
GetApplicationHealthAsync(Uri)	Ruft die Integrität der angegebenen Service Fabric-Anwendung asynchron ab.
GetApplicationHealthAsync(Uri, ApplicationHealthPolicy)	Ruft die Integrität der angegebenen Service Fabric-Anwendung mithilfe des Anwendungs-URI und der Integritätsrichtlinie asynchron ab.
GetApplicationHealthAsync(ApplicationHealthQueryDescription, TimeSpan, CancellationToken)	Ruft die Integrität der angegebenen Service Fabric-Anwendung mithilfe der angegebenen Abfrageeingabe, des angegebenen Timeouts und des angegebenen Abbruchtokens asynchron ab.
GetApplicationHealthAsync(Uri, TimeSpan, CancellationToken)	Ruft die Integrität der angegebenen Service Fabric-Anwendung mithilfe des angegebenen Anwendungs-URI, des angegebenen Timeouts und des angegebenen Abbruchtokens asynchron ab.
GetApplicationHealthAsync(Uri, ApplicationHealthPolicy, TimeSpan, CancellationToken)	Ruft die Integrität der angegebenen Service Fabric-Anwendung mithilfe des angegebenen Timeout- und Abbruchtokens asynchron ab.

GetApplicationHealthAsync(ApplicationHealthQueryDescription)

Ruft die Integrität der angegebenen Service Fabric-Anwendung mithilfe der angegebenen Abfragebeschreibung asynchron ab.

public System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth> GetApplicationHealthAsync (System.Fabric.Description.ApplicationHealthQueryDescription queryDescription);

member this.GetApplicationHealthAsync : System.Fabric.Description.ApplicationHealthQueryDescription -> System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth>

Public Function GetApplicationHealthAsync (queryDescription As ApplicationHealthQueryDescription) As Task(Of ApplicationHealth)

Parameter

queryDescription: ApplicationHealthQueryDescription

Die ApplicationHealthQueryDescription instance, um die Abfrage zum Abrufen der Anwendungsintegrität zu beschreiben.

Gibt zurück

Task<ApplicationHealth>

Die Integrität der angegebenen Service Fabric-Anwendung.

Ausnahmen

FabricObjectClosedException

Das FabricClient Objekt befindet sich in einem geschlossenen Zustand. Entsorgen Sie das FabricClient 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

Dies wird durch eine der folgenden Ursachen verursacht:

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

TimeoutException

Dies wird durch eine der folgenden Ursachen verursacht:

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

FabricException

Dies wird durch eine der folgenden Ursachen verursacht:

FabricHealthEntityNotFound.

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.

InvalidCredentialType.

InvalidX509FindType.

InvalidX509StoreLocation.

InvalidX509StoreName.

InvalidX509Thumbprint.

InvalidProtectionLevel.

InvalidX509Store.

InvalidSubjectName.

InvalidAllowedCommonNameList.

FabricTransientException

Dies wird durch eine der folgenden Ursachen verursacht:

ServiceTooBusy wird zurückgegeben, wenn der Dienst zum Verarbeiten des Vorgangs zu ausgelastet ist.

UnauthorizedAccessException

Dies wird durch eine der folgenden Ursachen verursacht:

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

Gilt für:

GetApplicationHealthAsync(Uri)

Ruft die Integrität der angegebenen Service Fabric-Anwendung asynchron ab.

public System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth> GetApplicationHealthAsync (Uri applicationName);

member this.GetApplicationHealthAsync : Uri -> System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth>

Public Function GetApplicationHealthAsync (applicationName As Uri) As Task(Of ApplicationHealth)

Parameter

applicationName: Uri

Der URI der Service Fabric-Anwendung.

Gibt zurück

Task<ApplicationHealth>

Die Integrität der angegebenen Service Fabric-Anwendung.

Ausnahmen

FabricObjectClosedException

Das FabricClient Objekt befindet sich in einem geschlossenen Zustand. Entsorgen Sie das FabricClient 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.

TimeoutException

Dies wird durch eine der folgenden Ursachen verursacht:

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

FabricException

Dies wird durch eine der folgenden Ursachen verursacht:

FabricHealthEntityNotFound.

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.

InvalidCredentialType.

InvalidX509FindType.

InvalidX509StoreLocation.

InvalidX509StoreName.

InvalidX509Thumbprint.

InvalidProtectionLevel.

InvalidX509Store.

InvalidSubjectName.

InvalidAllowedCommonNameList.

FabricTransientException

Dies wird durch eine der folgenden Ursachen verursacht:

ServiceTooBusy wird zurückgegeben, wenn der Dienst zum Verarbeiten des Vorgangs zu ausgelastet ist.

UnauthorizedAccessException

Dies wird durch eine der folgenden Ursachen verursacht:

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

Hinweise

Im folgenden Beispiel wird die Integrität einer Anwendung abgerufen.

public static bool GetApplicationHealth(string clusterConnection)
            {
                ApplicationHealth applicationHealth;
                Uri applicationName = new Uri("fabric:/myapp/todo");

                // Connect to the cluster.
                FabricClient fabricClient = new FabricClient(clusterConnection);

                // Get the application health.
                try
                {
                    applicationHealth = fabricClient.HealthManager.GetApplicationHealthAsync(applicationName).Result;
                }
                catch (Exception e)
                {
                    Console.WriteLine("Error: " + e.Message);

                    if (e.InnerException != null)
            Console.WriteLine("  Inner Exception: " + e.InnerException.Message);

                    return false;
                }

                // Display the application health information.
                Console.WriteLine("Get Application Health:");
                Console.WriteLine("  Application {0}: {1}", applicationHealth.ApplicationName, applicationHealth.AggregatedHealthState);

                // List the deployed application health states.
                Console.WriteLine("    Deployed applications:");
                IList<DeployedApplicationHealthState> deployedAppHealthStateList = applicationHealth.DeployedApplicationHealthStates;
                foreach (DeployedApplicationHealthState deployedAppHealthState in deployedAppHealthStateList)
                {
                    Console.WriteLine("      Application: " + deployedAppHealthState.ApplicationName);
                    Console.WriteLine("        Aggregated Health State: " + deployedAppHealthState.AggregatedHealthState);
                    Console.WriteLine("        Node Name: " + deployedAppHealthState.NodeName);
                }

                // List the deployed services health states.
                Console.WriteLine("    Service Health States:");
                IList<ServiceHealthState> deployedSvcsHealthStateList = applicationHealth.ServiceHealthStates;
                foreach (ServiceHealthState serviceHealthState in deployedSvcsHealthStateList)
                {
                    Console.WriteLine("      Service {0}: {1}", serviceHealthState.ServiceName, serviceHealthState.AggregatedHealthState);
                }

                // List the health events.
                Console.WriteLine("    Health Events:");
                IList<HealthEvent> healthEvents = applicationHealth.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);
                }

                Console.WriteLine();
                return true;
            }

Gilt für:

GetApplicationHealthAsync(Uri, ApplicationHealthPolicy)

Ruft die Integrität der angegebenen Service Fabric-Anwendung mithilfe des Anwendungs-URI und der Integritätsrichtlinie asynchron ab.

public System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth> GetApplicationHealthAsync (Uri applicationName, System.Fabric.Health.ApplicationHealthPolicy healthPolicy);

member this.GetApplicationHealthAsync : Uri * System.Fabric.Health.ApplicationHealthPolicy -> System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth>

Public Function GetApplicationHealthAsync (applicationName As Uri, healthPolicy As ApplicationHealthPolicy) As Task(Of ApplicationHealth)

Parameter

applicationName: Uri

Der URI der Service Fabric-Anwendung.

healthPolicy: ApplicationHealthPolicy

Die ApplicationHealthPolicy instance, die zum Auswerten der Anwendung verwendet wird.

Gibt zurück

Task<ApplicationHealth>

Die Integritätsberichte der angegebenen Service Fabric-Anwendung.

Ausnahmen

FabricObjectClosedException

Das FabricClient Objekt befindet sich in einem geschlossenen Zustand. Entsorgen Sie das FabricClient 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

Dies wird durch eine der folgenden Ursachen verursacht:

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

TimeoutException

Dies wird durch eine der folgenden Ursachen verursacht:

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

FabricException

Dies wird durch eine der folgenden Ursachen verursacht:

FabricHealthEntityNotFound.

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.

InvalidCredentialType.

InvalidX509FindType.

InvalidX509StoreLocation.

InvalidX509StoreName.

InvalidX509Thumbprint.

InvalidProtectionLevel.

InvalidX509Store.

InvalidSubjectName.

InvalidAllowedCommonNameList.

FabricTransientException

Dies wird durch eine der folgenden Ursachen verursacht:

ServiceTooBusy wird zurückgegeben, wenn der Dienst zum Verarbeiten des Vorgangs zu ausgelastet ist.

UnauthorizedAccessException

Dies wird durch eine der folgenden Ursachen verursacht:

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

Gilt für:

GetApplicationHealthAsync(ApplicationHealthQueryDescription, TimeSpan, CancellationToken)

Ruft die Integrität der angegebenen Service Fabric-Anwendung mithilfe der angegebenen Abfrageeingabe, des angegebenen Timeouts und des angegebenen Abbruchtokens asynchron ab.

public System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth> GetApplicationHealthAsync (System.Fabric.Description.ApplicationHealthQueryDescription queryDescription, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.GetApplicationHealthAsync : System.Fabric.Description.ApplicationHealthQueryDescription * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth>

Public Function GetApplicationHealthAsync (queryDescription As ApplicationHealthQueryDescription, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ApplicationHealth)

Parameter

queryDescription: ApplicationHealthQueryDescription

Die ApplicationHealthQueryDescription instance, um die Abfrage zum Abrufen der Anwendungsintegrität zu beschreiben.

timeout: TimeSpan

Die maximale Zeitspanne, die Service Fabric ermöglicht, diesen Vorgang fortzusetzen, bevor ein TimeoutExceptionzurückgegeben wird.

cancellationToken: CancellationToken

Das Abbruchtoken, das vom Vorgang beobachtet wird. Sie kann verwendet werden, um eine Benachrichtigung zu senden, dass der Vorgang abgebrochen werden soll. Beachten Sie, dass der Abbruch eine Empfehlung ist und dass der Vorgang auch dann abgeschlossen werden kann, wenn er abgebrochen wird.

Gibt zurück

Task<ApplicationHealth>

Die Integritätsberichte der angegebenen Service Fabric-Anwendung.

Ausnahmen

FabricObjectClosedException

Das FabricClient Objekt befindet sich in einem geschlossenen Zustand. Entsorgen Sie das FabricClient 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

Dies wird durch eine der folgenden Ursachen verursacht:

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

TimeoutException

Dies wird durch eine der folgenden Ursachen verursacht:

OperationTimedOut wird zurückgegeben, wenn der Vorgang mehr als der vom Benutzer bereitgestellte timeout Vorgang benötigt.

FabricException

Dies wird durch eine der folgenden Ursachen verursacht:

FabricHealthEntityNotFound.

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.

InvalidCredentialType.

InvalidX509FindType.

InvalidX509StoreLocation.

InvalidX509StoreName.

InvalidX509Thumbprint.

InvalidProtectionLevel.

InvalidX509Store.

InvalidSubjectName.

InvalidAllowedCommonNameList.

FabricTransientException

Dies wird durch eine der folgenden Ursachen verursacht:

ServiceTooBusy wird zurückgegeben, wenn der Dienst zum Verarbeiten des Vorgangs zu ausgelastet ist.

UnauthorizedAccessException

Dies wird durch eine der folgenden Ursachen verursacht:

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

Gilt für:

GetApplicationHealthAsync(Uri, TimeSpan, CancellationToken)

Ruft asynchron die Integrität der angegebenen Service Fabric-Anwendung unter Verwendung des angegebenen Anwendungs-URI, Timeouts und Abbruchtokens ab.

public System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth> GetApplicationHealthAsync (Uri applicationName, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.GetApplicationHealthAsync : Uri * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth>

Public Function GetApplicationHealthAsync (applicationName As Uri, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ApplicationHealth)

Parameter

applicationName: Uri

Der URI der Service Fabric-Anwendung.

timeout: TimeSpan

Die maximale Zeitspanne, die Service Fabric ermöglicht, diesen Vorgang fortzusetzen, bevor ein TimeoutExceptionzurückgegeben wird.

cancellationToken: CancellationToken

Das Abbruchtoken, das der Vorgang beobachtet. Sie kann verwendet werden, um eine Benachrichtigung zu senden, dass der Vorgang abgebrochen werden soll. Beachten Sie, dass der Abbruch hilfreich ist und dass der Vorgang auch dann abgeschlossen werden kann, wenn er abgebrochen wird.

Gibt zurück

Task<ApplicationHealth>

Die Integritätsberichte der angegebenen Service Fabric-Anwendung.

Ausnahmen

FabricObjectClosedException

Das FabricClient Objekt befindet sich in einem geschlossenen Zustand. Entsorgen Sie das FabricClient 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

Dies wird durch eine der folgenden Ursachen verursacht:

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

TimeoutException

Dies wird durch eine der folgenden Ursachen verursacht:

OperationTimedOut wird zurückgegeben, wenn der Vorgang mehr als der vom Benutzer bereitgestellte timeout Vorgang benötigt.

FabricException

Dies wird durch eine der folgenden Ursachen verursacht:

FabricHealthEntityNotFound.

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.

InvalidCredentialType.

InvalidX509FindType.

InvalidX509StoreLocation.

InvalidX509StoreName.

InvalidX509Thumbprint.

InvalidProtectionLevel.

InvalidX509Store.

InvalidSubjectName.

InvalidAllowedCommonNameList.

FabricTransientException

Dies wird durch eine der folgenden Ursachen verursacht:

ServiceTooBusy wird zurückgegeben, wenn der Dienst zum Verarbeiten des Vorgangs zu ausgelastet ist.

UnauthorizedAccessException

Dies wird durch eine der folgenden Ursachen verursacht:

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

Gilt für:

GetApplicationHealthAsync(Uri, ApplicationHealthPolicy, TimeSpan, CancellationToken)

Ruft die Integrität der angegebenen Service Fabric-Anwendung mithilfe des angegebenen Timeout- und Abbruchtokens asynchron ab.

public System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth> GetApplicationHealthAsync (Uri applicationName, System.Fabric.Health.ApplicationHealthPolicy healthPolicy, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.GetApplicationHealthAsync : Uri * System.Fabric.Health.ApplicationHealthPolicy * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth>

Public Function GetApplicationHealthAsync (applicationName As Uri, healthPolicy As ApplicationHealthPolicy, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ApplicationHealth)

Parameter

applicationName: Uri

Der URI der Service Fabric-Anwendung.

healthPolicy: ApplicationHealthPolicy

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

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

Task<ApplicationHealth>

Die Integritätsberichte der angegebenen Service Fabric-Anwendung.

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:

FabricHealthEntityNotFound.

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