FabricClient.HealthClient.GetServiceHealthAsync 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

GetServiceHealthAsync(ServiceHealthQueryDescription)	Ruft die Integrität eines Service Fabric-Diensts mithilfe des angegebenen Timeout- und Abbruchtokens asynchron ab.
GetServiceHealthAsync(Uri)	Ruft die Integrität eines Service Fabric-Diensts asynchron ab.
GetServiceHealthAsync(Uri, ApplicationHealthPolicy)	Ruft die Integrität eines Service Fabric-Diensts asynchron ab.
GetServiceHealthAsync(ServiceHealthQueryDescription, TimeSpan, CancellationToken)	Ruft die Integrität eines Service Fabric-Diensts mithilfe des angegebenen Timeout- und Abbruchtokens asynchron ab.
GetServiceHealthAsync(Uri, TimeSpan, CancellationToken)	Ruft die Integrität eines Service Fabric-Diensts mithilfe des angegebenen Timeout- und Abbruchtokens asynchron ab.
GetServiceHealthAsync(Uri, ApplicationHealthPolicy, TimeSpan, CancellationToken)	Ruft die Integrität eines Service Fabric-Diensts mithilfe des angegebenen Timeout- und Abbruchtokens asynchron ab.

GetServiceHealthAsync(ServiceHealthQueryDescription)

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

public System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth> GetServiceHealthAsync (System.Fabric.Description.ServiceHealthQueryDescription queryDescription);

member this.GetServiceHealthAsync : System.Fabric.Description.ServiceHealthQueryDescription -> System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth>

Public Function GetServiceHealthAsync (queryDescription As ServiceHealthQueryDescription) As Task(Of ServiceHealth)

Parameter

queryDescription: ServiceHealthQueryDescription

Die Abfragebeschreibung.

Gibt zurück

Task<ServiceHealth>

Die Integrität eines Service Fabric-Diensts.

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 ServiceName 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:

GetServiceHealthAsync(Uri)

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

public System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth> GetServiceHealthAsync (Uri serviceName);

member this.GetServiceHealthAsync : Uri -> System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth>

Public Function GetServiceHealthAsync (serviceName As Uri) As Task(Of ServiceHealth)

Parameter

serviceName: Uri

Der Name des Service Fabric-Diensts.

Gibt zurück

Task<ServiceHealth>

Die Integrität eines Service Fabric-Diensts.

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 serviceName 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 eines Diensts abgerufen.

public static bool GetServiceHealth(string clusterConnection)
            {
                ServiceHealth serviceHealth;
                Uri serviceName = new Uri("fabric:/myapp/todo/svc1");

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

                // Get the service health.
                try
                {
                    serviceHealth = fabricClient.HealthManager.GetServiceHealthAsync(serviceName).Result;
                }
                catch (Exception e)
                {
                    Console.WriteLine("Error: " + e.Message);

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

                    return false;
                }

                Console.WriteLine("Service Health:");
                Console.WriteLine("  Service {0}: {1}", serviceHealth.ServiceName, serviceHealth.AggregatedHealthState);

                // List the health states.
                Console.WriteLine("    Partition Health States:");
                IList<PartitionHealthState> partitionHealthStates = serviceHealth.PartitionHealthStates;
                foreach (PartitionHealthState partitionHealthState in partitionHealthStates)
                {
                    Console.WriteLine("      Aggregated Health State: " + partitionHealthState.AggregatedHealthState);
                    Console.WriteLine("      Partition ID: " + partitionHealthState.PartitionId);
                }

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

Gilt für:

GetServiceHealthAsync(Uri, ApplicationHealthPolicy)

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

public System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth> GetServiceHealthAsync (Uri serviceName, System.Fabric.Health.ApplicationHealthPolicy healthPolicy);

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

Public Function GetServiceHealthAsync (serviceName As Uri, healthPolicy As ApplicationHealthPolicy) As Task(Of ServiceHealth)

Parameter

serviceName: Uri

Der Name des Service Fabric-Diensts.

healthPolicy: ApplicationHealthPolicy

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

Gibt zurück

Task<ServiceHealth>

Die Integrität eines Service Fabric-Diensts.

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 serviceName 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:

GetServiceHealthAsync(ServiceHealthQueryDescription, TimeSpan, CancellationToken)

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

public System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth> GetServiceHealthAsync (System.Fabric.Description.ServiceHealthQueryDescription queryDescription, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.GetServiceHealthAsync : System.Fabric.Description.ServiceHealthQueryDescription * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth>

Public Function GetServiceHealthAsync (queryDescription As ServiceHealthQueryDescription, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ServiceHealth)

Parameter

queryDescription: ServiceHealthQueryDescription

Die Abfragebeschreibung.

timeout: TimeSpan

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

cancellationToken: CancellationToken

Das optionale 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 eine Empfehlung ist und dass der Vorgang auch dann abgeschlossen werden kann, wenn er abgebrochen wird.

Gibt zurück

Task<ServiceHealth>

Die Integrität eines Service Fabric-Diensts.

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 ServiceName 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:

GetServiceHealthAsync(Uri, TimeSpan, CancellationToken)

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

public System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth> GetServiceHealthAsync (Uri serviceName, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

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

Public Function GetServiceHealthAsync (serviceName As Uri, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ServiceHealth)

Parameter

serviceName: Uri

Der Name des Service Fabric-Diensts.

timeout: TimeSpan

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

cancellationToken: CancellationToken

Das optionale 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<ServiceHealth>

Die Integrität eines Service Fabric-Diensts.

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 serviceName 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:

GetServiceHealthAsync(Uri, ApplicationHealthPolicy, TimeSpan, CancellationToken)

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

public System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth> GetServiceHealthAsync (Uri serviceName, System.Fabric.Health.ApplicationHealthPolicy healthPolicy, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

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

Public Function GetServiceHealthAsync (serviceName As Uri, healthPolicy As ApplicationHealthPolicy, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ServiceHealth)

Parameter

serviceName: Uri

Der Name des Service Fabric-Diensts.

healthPolicy: ApplicationHealthPolicy

Die Anwendungsintegritätsrichtlinie, die zum Bewerten der Entitätsintegritä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

Das optionale 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<ServiceHealth>

Die Integrität eines Service Fabric-Diensts.

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 serviceName kein gültiger Service Fabric-Name ist.