Product Documentation

GetMachineFailureTrendsByType

Oct 21, 2016

Obtient une liste de répartition de machines et nombre de réussite par type, avec une tendance pour chaque type, pour la période de temps spécifiée. Chaque point de données de la tendance représente le nombre total de machines dans un état d’échec dans le dernier intervalle (paramètre intervalLength). Vous pouvez spécifier un type d'échec particulier pour limiter la requête ou obtenir tous les types d'échec.

Nom de paramètre Type Commentaires
startDate DateTime Début de la fenêtre de temps à interroger pour la tendance de l'échec de machine. Doit être UTC. Non requis pour la non récupération de tendances.
endDate DateTime Fin de la fenêtre de temps à interroger pour la tendance de l'échec de machine. Doit être UTC.
intervalLength int Intervalle entre les points de données en minutes pour la tendance.
machineFailureType int (MachineFailureType) Si fourni (> 0), retourne uniquement ce type d'échec de machine dans les résultats. Sinon, (une valeur nulle ou égale à zéro) retourne une liste de tous les types d'échec. Ce nombre entier correspond à une enum MachineFailureType.
sessionSupport int (SessionSupport) Nullable int. S'ils ne sont pas fournis, retourne alors tous les types sessionSupport. Unique=1, Multiple=2, Inconnu=0

Retours

Un IQueryable des objets MachineFailureTrend qui contiennent les informations suivantes pour chaque MachineFailureType.

Si tous les types sont requis, la somme est également retourné avec MachineFailureType = -1

Si $expand=FailureTrend est inclus dans la requête, la tendance et les propriétés TotalFailureCount sont récupérées pour chaque type d'échec.

Si $expand=DesktopGroupBreakdown est inclus dans la requête, cette propriété est également récupérée pour chaque type d'échec.

Nom de la propriété Type Commentaires
MachineFailureType int [MachineFailureType] Type d'échec de connexion (veuillez consulter la section Déterminer les valeurs d'énumération (enum)).
TotalFailureCount int Nombre total d’échecs à l'endDate spécifiée.
FailureTrend List TrendItem contient une date UTC (DateTime), un nombre (double) pour indiquer la tendance des échecs de machine pendant la période spécifiée pour ce type d'échec.
DesktopGroupBreakdown List DesktopGroupBreakdown contient un objet DesktopGroup et Count (int) pour représenter le nombre total de machines dans un état d’échec à l'endDate spécifiée.

Exemples

Récupérez à la fois la répartition des groupes de mise à disposition et l'échec de tendance pour tous les types d'échec de machine du 14 novembre à 5 heures du matin (UTC) au 14 novembre à 7 heures du matin (UTC), avec un point de données toutes les 30 minutes pour toutes les machines avec OS de serveur (par exemple, sessionSupport = 2) :

http://{dc-host}/Citrix/Monitor/OData/v1/Methods/GetMachineFailureTrendsByType?startDate=datetime'2011-11-14T05:00:00'&endDate=datetime'2011-11-14T07:00:00'&intervalLength=30&machineFailureType=0&sessionSupport=2&$expand=FailureTrend,DesktopGroupBreakdown

Récupérez la répartition des groupes de mise à disposition uniquement pour l'échec de machine de type 3 (Bloqué au démarrage) du 14 novembre à 5 heures du matin (UTC) au 14 novembre à 7 heures du matin (UTC) pour les machines avec OS de bureau :

http://{dc-host}/Citrix/Monitor/OData/v1/Methods/GetMachineFailureTrendsByType?startDate=datetime'2011-11-14T05:00:00'&endDate=datetime'2011-11-14T07:00:00'&machineFailureType=3&sessionSupport=1&$expand=FailureTrend

Récupérez la tendance d'échec pour tous les types d'échec pour tous les types de session de machine du 14 novembre à minuit (UTC) au 14 novembre à 11 heures du soir (UTC), avec un point de données toutes les heures:

http://{dc-host}/Citrix/Monitor/OData/v1/Methods/GetMachineFailureTrendsByType?startDate=datetime'2011-11-14T00:00:00'&endDate=datetime'2011-11-14T23:00:00'&intervalLength=60&machineFailureType=0&$expand=FailureTrend