Obtenir la liste d’événements des réplicas de partition
Obtient tous les événements liés aux réplicas pour une partition.
La réponse est une liste d’objets ReplicaEvent.
Requête
Méthode | URI de demande |
---|---|
GET | /EventsStore/Partitions/{partitionId}/$/Replicas/Events?api-version=6.4&timeout={timeout}&StartTimeUtc={StartTimeUtc}&EndTimeUtc={EndTimeUtc}&EventsTypesFilter={EventsTypesFilter}&ExcludeAnalysisEvents={ExcludeAnalysisEvents}&SkipCorrelationLookup={SkipCorrelationLookup} |
Paramètres
Nom | Type | Obligatoire | Emplacement |
---|---|---|---|
partitionId |
string (uuid) | Oui | Chemin d’accès |
api-version |
string | Oui | Requête |
timeout |
entier (int64) | Non | Requête |
StartTimeUtc |
string | Oui | Requête |
EndTimeUtc |
string | Oui | Requête |
EventsTypesFilter |
string | Non | Requête |
ExcludeAnalysisEvents |
boolean | Non | Requête |
SkipCorrelationLookup |
boolean | Non | Requête |
partitionId
Type : string (uuid)
Obligatoire : Oui
Identité de la partition.
api-version
Type : chaîne
Obligatoire : Oui
Par défaut : 6.4
Version de l’API. Ce paramètre est obligatoire et sa valeur doit être « 6.4 ».
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.
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.
StartTimeUtc
Type : chaîne
Obligatoire : Oui
Heure de début d’une requête de recherche en ISO UTC aaaa-MM-jjTHH:mm:ssZ.
EndTimeUtc
Type : chaîne
Obligatoire : Oui
Heure de fin d’une requête de recherche en ISO UTC aaaa-MM-jjTHH:mm:ssZ.
EventsTypesFilter
Type : chaîne
Obligatoire : Non
Chaîne séparée par des virgules spécifiant les types de FabricEvents qui doivent être inclus uniquement dans la réponse.
ExcludeAnalysisEvents
Type : booléen
Obligatoire : Non
Ce paramètre désactive la récupération d’AnalysisEvents si la valeur true est transmise.
SkipCorrelationLookup
Type : booléen
Obligatoire : Non
Ce paramètre désactive la recherche d’informations CorrelatedEvents si la valeur true est transmise. Dans le cas contraire, CorrelationEvents est traité et le champ HasCorrelatedEvents dans chaque FabricEvent est rempli.
Réponses
Code d’état HTTP | Description | Schéma de réponse |
---|---|---|
200 (OK) | Liste d’objets d’événements avec le type de base ReplicaEvent. |
tableau de ReplicaEvent |
Tous les autres codes status | Réponse d’erreur détaillée. |
FabricError |
Exemples
Obtenir des événements liés aux réplicas de partition
Cet exemple montre comment obtenir tous les événements liés aux réplicas pendant une certaine fenêtre de temps.
Requête
GET http://localhost:19080/EventsStore/Partitions/f2a6a893-39be-4c7d-b07f-72bc2d36de89/$/Replicas/Events?api-version=6.4&StartTimeUtc=2018-04-03T18:00:00Z&EndTimeUtc=2018-04-04T18:00:00Z
Réponse 200
Corps
[
{
"Kind": "StatefulReplicaNewHealthReport",
"ReplicaInstanceId": "131672608994209140",
"SourceId": "TestSource",
"Property": "",
"HealthState": "Error",
"TimeToLiveMs": "922337203685477",
"SequenceNumber": "131672654189677800",
"Description": "",
"RemoveWhenExpired": false,
"SourceUtcTimestamp": "2018-04-03T21:43:38Z",
"PartitionId": "f2a6a893-39be-4c7d-b07f-72bc2d36de89",
"ReplicaId": "131672608994209140",
"EventInstanceId": "b2684da3-df81-4add-8baa-201f73e9195d",
"TimeStamp": "2018-04-03T21:43:38.8904013Z",
"HasCorrelatedEvents": false
},
{
"Kind": "StatefulReplicaNewHealthReport",
"ReplicaInstanceId": "177872608994339550",
"SourceId": "TestSource",
"Property": "",
"HealthState": "Error",
"TimeToLiveMs": "922337203685477",
"SequenceNumber": "131672654189677800",
"Description": "",
"RemoveWhenExpired": false,
"SourceUtcTimestamp": "2018-04-03T21:44:38Z",
"PartitionId": "f549f3b3-08c2-4ec4-adb4-415e024cb0ef",
"ReplicaId": "177872608994339550",
"EventInstanceId": "4a8851d8-35a3-4618-b4ac-03ffa191c350",
"TimeStamp": "2018-04-03T21:44:38.8904013Z",
"HasCorrelatedEvents": false
}
]