Obtenir des événements chaos
Permet d’obtenir le segment suivant des événements Chaos sur le jeton de continuation ou l’intervalle de temps.
Pour obtenir le segment suivant des événements Chaos, vous pouvez spécifier le jeton de continuation. Pour obtenir le début d’un nouveau segment d’événements Chaos, vous pouvez spécifier l’intervalle de temps via StartTimeUtc et EndTimeUtc. Vous ne pouvez pas spécifier à la fois le jeton de continuation et l’intervalle de temps dans le même appel. Lorsqu’il y a plus de 100 événements Chaos, les événements Chaos sont retournés en plusieurs segments, où un segment ne contient pas plus de 100 événements Chaos. Pour obtenir le segment suivant, effectuez un appel à cette API avec le jeton de continuation.
Requête
| Méthode | URI de demande |
|---|---|
| GET | /Tools/Chaos/Events?api-version=6.2&ContinuationToken={ContinuationToken}&StartTimeUtc={StartTimeUtc}&EndTimeUtc={EndTimeUtc}&MaxResults={MaxResults}&timeout={timeout} |
Paramètres
| Nom | Type | Obligatoire | Emplacement |
|---|---|---|---|
api-version |
string | Oui | Requête |
ContinuationToken |
string | Non | Requête |
StartTimeUtc |
string | Non | Requête |
EndTimeUtc |
string | Non | Requête |
MaxResults |
entier (int64) | Non | Requête |
timeout |
entier (int64) | Non | Requête |
api-version
Type : chaîne
Obligatoire : Oui
Par défaut : 6.2
Version de l’API. Ce paramètre est obligatoire et sa valeur doit être « 6.2 ».
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. Cette version est la dernière version prise en charge de l’API. Si une version d’API inférieure est transmise, 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 et que le runtime est 6.1, le runtime accepte la version 6.1 pour cette API. Toutefois, le comportement de l’API sera en fonction de la version 6.0 documentée.
ContinuationToken
Type : chaîne
Obligatoire : Non
Le paramètre de jeton de liaison permet d’obtenir le jeu de résultats suivant. Un jeton de liaison avec une valeur non vide est inclus dans la réponse de l’API quand les résultats du système ne tiennent pas dans une seule réponse. Lorsque cette valeur est transmise à l’appel d’API suivant, l’API retourne le jeu de résultats suivant. S’il n’existe pas de résultats supplémentaires, le jeton de liaison ne contient pas de valeur. La valeur de ce paramètre ne doit pas être codée URL.
StartTimeUtc
Type : chaîne
Obligatoire : Non
Heure de fichier Windows représentant l’heure de début de l’intervalle de temps pour lequel un rapport Chaos doit être généré. Pour plus d’informations, consultez DateTime.ToFileTimeUtc, méthode.
EndTimeUtc
Type : chaîne
Obligatoire : Non
Heure de fichier Windows représentant l’heure de fin de l’intervalle de temps pour lequel un rapport Chaos doit être généré. Pour plus d’informations, consultez DateTime.ToFileTimeUtc, méthode.
MaxResults
Type : integer (int64)
Obligatoire : Non
Par défaut : 0
InclusiveMinimum : 0
Nombre maximal de résultats à renvoyer dans le cadre des requêtes paginées. Ce paramètre définit la limite supérieure du nombre de résultats renvoyés. Le nombre de résultats renvoyés peut être inférieur au nombre maximal de résultats spécifié s’ils ne tiennent pas dans le message conformément aux restrictions de taille maximale définies dans la configuration. Si ce paramètre est défini sur zéro ou n’est pas spécifié, la requête paginée comprend le nombre maximal de résultats pouvant tenir dans le message renvoyé.
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.
Réponses
| Code d’état HTTP | Description | Schéma de réponse |
|---|---|---|
| 200 (OK) | Segment suivant des événements Chaos. |
ChaosEventsSegment |
| Tous les autres codes status | Réponse d’erreur détaillée. |
FabricError |
Exemples
Obtenir les événements Chaos en fonction d’un intervalle de temps
Cet exemple montre comment obtenir des événements Chaos dans un message de réponse unique sans avoir besoin de paginer via le paramètre ContinuationToken.
Requête
GET http://localhost:19080/Tools/Chaos/Events?api-version=6.2&StartTimeUtc=0&EndTimeUtc=3155378975999999999
Réponse 200
Corps
{
"ContinuationToken": "",
"History": [
{
"ChaosEvent": {
"Kind": "Started",
"TimeStampUtc": "2017-04-14T04:27:19.049Z",
"ChaosParameters": {
"MaxClusterStabilizationTimeoutInSeconds": "30",
"MaxConcurrentFaults": "3",
"WaitTimeBetweenIterationsInSeconds": "10",
"WaitTimeBetweenFaultsInSeconds": "1",
"TimeToRunInSeconds": "3600",
"EnableMoveReplicaFaults": true,
"ClusterHealthPolicy": {
"ConsiderWarningAsError": true,
"MaxPercentUnhealthyNodes": "0",
"MaxPercentUnhealthyApplications": "10",
"ApplicationTypeHealthPolicyMap": [
{
"Key": "myapp",
"Value": "3"
}
]
},
"Context": {
"Map": {
"k1": "v1",
"k2": "v2",
"k3": "v5"
}
}
}
}
},
{
"ChaosEvent": {
"Kind": "ExecutingFaults",
"TimeStampUtc": "2017-04-14T04:27:20.667Z",
"Faults": [
"ActionType: RestartReplica, ServiceUri: fabric:/TestApp1/PersistServ_6R_1, PartitionId: 6a91b09a-bd76-45da-afaa-ed0fd9bfe7d2, ReplicaId: 131366172775684622",
"ActionType: CodePackageRestart, NodeName: N0050, ApplicationName: fabric:/TestApp1, ServiceManifestName: SP1, ServiceManifestName: , CodePackageName: CP1.",
"ActionType: RestartReplica, ServiceUri: fabric:/TestApp1/PersistServ_6R_3, PartitionId: baa3a51e-5c42-435e-89d3-6e97b2164661, ReplicaId: 131366172988968762"
]
}
}
]
}