Freigeben über


FabricClient.HealthClient.GetServiceHealthAsync Methode

Definition

Ü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

Die Integrität eines Service Fabric-Diensts.

Ausnahmen

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

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

Dies wird durch eine der folgenden Ursachen verursacht:

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

Dies wird durch eine der folgenden Ursachen verursacht:

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

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.

Dies wird durch eine der folgenden Ursachen verursacht:

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

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

Die Integrität eines Service Fabric-Diensts.

Ausnahmen

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

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

Dies wird durch eine der folgenden Ursachen verursacht:

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

Dies wird durch eine der folgenden Ursachen verursacht:

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

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.

Dies wird durch eine der folgenden Ursachen verursacht:

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

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

Die Integrität eines Service Fabric-Diensts.

Ausnahmen

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

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

Dies wird durch eine der folgenden Ursachen verursacht:

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

Dies wird durch eine der folgenden Ursachen verursacht:

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

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.

Dies wird durch eine der folgenden Ursachen verursacht:

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

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

Die Integrität eines Service Fabric-Diensts.

Ausnahmen

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

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

Dies wird durch eine der folgenden Ursachen verursacht:

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

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.

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.

Dies wird durch eine der folgenden Ursachen verursacht:

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

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

Die Integrität eines Service Fabric-Diensts.

Ausnahmen

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

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

Dies wird durch eine der folgenden Ursachen verursacht:

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

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.

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.

Dies wird durch eine der folgenden Ursachen verursacht:

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

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

Die Integrität eines Service Fabric-Diensts.

Ausnahmen

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

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

Verursacht durch eine der folgenden:

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

Verursacht durch eine der folgenden:

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

Verursacht durch eine der folgenden:

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.

Verursacht durch eine der folgenden:

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

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: