Partager via

Obtenir le bloc d’intégrité du cluster à l’aide de la stratégie et des filtres avancés

  • Article

Obtient l’intégrité d’un cluster Service Fabric à l’aide de blocs d’intégrité.

Obtient l’intégrité d’un cluster Service Fabric à l’aide de blocs d’intégrité. L’évaluation de l’intégrité est effectuée en fonction de la description de la requête de bloc d’intégrité du cluster d’entrée. La description de la requête permet aux utilisateurs de spécifier des stratégies d’intégrité pour évaluer le cluster et ses enfants. Les utilisateurs peuvent spécifier des filtres très flexibles pour sélectionner les entités de cluster à retourner. La sélection peut être effectuée en fonction de l’état d’intégrité des entités et de la hiérarchie. La requête peut retourner des enfants multiniveaux des entités en fonction des filtres spécifiés. Par exemple, il peut retourner une application avec un nom spécifié et, pour cette application, retourner uniquement les services qui sont dans Error ou Warning, ainsi que tous les partitions et réplicas pour l’un de ces services.

Requête

Méthode URI de demande
POST /$/GetClusterHealthChunk?api-version=6.0&timeout={timeout}

Paramètres

Nom Type Obligatoire Emplacement
api-version string Oui Requête
timeout integer (int64) Non Requête
ClusterHealthChunkQueryDescription ClusterHealthChunkQueryDescription Non body

api-version

Type : chaîne
Obligatoire : Oui
Par défaut : 6.0

Version de l’API. Ce paramètre est obligatoire et sa valeur doit être « 6.0 ».

La version de l’API REST Service Fabric est basée sur la version du runtime dans laquelle l’API a été introduite ou a été modifiée. Le runtime Service Fabric prend en charge plusieurs versions de l’API. Il s’agit de la dernière version prise en charge de l’API. Si une version inférieure de l’API est passée, la réponse retournée peut être différente de celle documentée dans cette spécification.

En outre, le runtime accepte toute version supérieure à la dernière version prise en charge jusqu’à la version actuelle du runtime. Par conséquent, si la dernière version de l’API est 6.0, mais que le runtime est 6.1, afin de faciliter l’écriture des clients, le runtime accepte la version 6.1 pour cette API. Toutefois, le comportement de l’API sera conformément à la version 6.0 documentée.

timeout

Type : integer (int64)
Obligatoire : Non
Par défaut : 60
InclusiveMaximum : 4294967295
InclusiveMinimum : 1

Délai d’attente du serveur pour l’exécution de l’opération en secondes. Il spécifie la durée pendant laquelle le client attend la fin de l’opération demandée. La valeur par défaut de ce paramètre est de 60 secondes.

ClusterHealthChunkQueryDescription

Type : ClusterHealthChunkQueryDescription
Obligatoire : Non

Décrit les stratégies d’intégrité du cluster et des applications utilisées pour évaluer l’intégrité du cluster et les filtres permettant de sélectionner les entités de cluster à retourner. Si la stratégie d’intégrité du cluster est présente, elle est utilisée pour évaluer les événements de cluster et les nœuds de cluster. Si elle n’est pas présente, l’évaluation de l’intégrité utilise la stratégie d’intégrité du cluster définie dans le manifeste du cluster ou la stratégie d’intégrité du cluster par défaut. Par défaut, chaque application est évaluée à l’aide de sa stratégie d’intégrité d’application spécifique, définie dans le manifeste de l’application, ou de la stratégie d’intégrité par défaut, si aucune stratégie n’est définie dans le manifeste. Si le mappage de stratégie d’intégrité de l’application est spécifié et qu’il contient une entrée pour une application, la stratégie d’intégrité de l’application spécifiée est utilisée pour évaluer l’intégrité de l’application. Les utilisateurs peuvent spécifier des filtres très flexibles pour sélectionner les entités de cluster à inclure en réponse. La sélection peut être effectuée en fonction de l’état d’intégrité des entités et de la hiérarchie. La requête peut retourner des enfants multiniveaux des entités en fonction des filtres spécifiés. Par exemple, il peut retourner une application avec un nom spécifié et, pour cette application, retourner uniquement les services qui sont dans Error ou Warning, ainsi que tous les partitions et réplicas pour l’un de ces services.

Réponses

Code d’état HTTP Description Schéma de réponse
200 (OK) Une opération réussie retourne 200 status code et les informations de bloc d’intégrité du cluster demandées.
 ClusterHealthChunk
Tous les autres codes status Réponse d’erreur détaillée.
 FabricError