Kaos Olaylarını Alma
Devam belirtecini veya zaman aralığını temel alan Chaos olaylarının sonraki segmentini alır.
Chaos olaylarının sonraki segmentini almak için ContinuationToken değerini belirtebilirsiniz. Chaos olaylarının yeni bir segmentinin başlangıcını almak için StartTimeUtc ve EndTimeUtc aracılığıyla zaman aralığını belirtebilirsiniz. Aynı çağrıda hem ContinuationToken hem de zaman aralığını belirtemezsiniz. 100'den fazla Chaos olayı olduğunda, Chaos olayları bir segmentin 100'den fazla Chaos olayı içermediği birden çok segmentte döndürülür ve devam belirteci ile bu API'ye çağrı yaptığınız sonraki segmenti alırsınız.
İstek
Yöntem | İstek URI'si |
---|---|
GET | /Tools/Chaos/Events?api-version=6.2&ContinuationToken={ContinuationToken}&StartTimeUtc={StartTimeUtc}&EndTimeUtc={EndTimeUtc}&MaxResults={MaxResults}&timeout={timeout} |
Parametreler
Ad | Tür | Gerekli | Konum |
---|---|---|---|
api-version |
string | Yes | Sorgu |
ContinuationToken |
dize | No | Sorgu |
StartTimeUtc |
dize | No | Sorgu |
EndTimeUtc |
dize | No | Sorgu |
MaxResults |
integer (int64) | No | Sorgu |
timeout |
integer (int64) | No | Sorgu |
api-version
Tür: dize
Gerekli: Evet
Varsayılan: 6.2
API sürümü. Bu parametre gereklidir ve değeri '6.2' olmalıdır.
Service Fabric REST API sürümü, API'nin tanıtıldığı veya değiştirildiği çalışma zamanı sürümünü temel alır. Service Fabric çalışma zamanı API'nin birden fazla sürümünü destekler. Bu sürüm, API'nin desteklenen en son sürümüdür. Daha düşük bir API sürümü geçirilirse, döndürülen yanıt bu belirtimde belgelenenden farklı olabilir.
Ayrıca çalışma zamanı, çalışma zamanının geçerli sürümüne kadar desteklenen en son sürümden daha yüksek olan tüm sürümleri kabul eder. Dolayısıyla en son API sürümü 6.0 ve çalışma zamanı 6.1 ise, çalışma zamanı bu API için sürüm 6.1'i kabul eder. Ancak API'nin davranışı, belgelenen 6.0 sürümüne göre olacaktır.
ContinuationToken
Tür: dize
Gerekli: Hayır
Devam belirteci parametresi, sonraki sonuç kümesini almak için kullanılır. Sistemden alınan sonuçlar tek bir yanıta sığmadığında API'nin yanıtına boş olmayan bir değere sahip bir devamlılık belirteci eklenir. Bu değer bir sonraki API çağrısına geçirildiğinde, API bir sonraki sonuç kümesini döndürür. Başka sonuç yoksa, devamlılık belirteci bir değer içermez. Bu parametrenin değeri URL kodlanmış olmamalıdır.
StartTimeUtc
Tür: dize
Gerekli: Hayır
Bir Chaos raporunun oluşturulacağı zaman aralığının başlangıç saatini temsil eden Windows dosya zamanı. Ayrıntılar için DateTime.ToFileTimeUtc Yöntemi'ne başvurun.
EndTimeUtc
Tür: dize
Gerekli: Hayır
Bir Chaos raporunun oluşturulacağı zaman aralığının bitiş saatini temsil eden Windows dosya zamanı. Ayrıntılar için DateTime.ToFileTimeUtc Yöntemi'ne başvurun.
MaxResults
Tür: tamsayı (int64)
Gerekli: Hayır
Varsayılan: 0
InclusiveMinimum: 0
Sayfalanan sorguların bir parçası olarak döndürülecek en fazla sonuç sayısı. Bu parametre, döndürülen sonuç sayısı üzerindeki üst sınırı tanımlar. Döndürülen sonuçlar, yapılandırmada tanımlanan en büyük ileti boyutu kısıtlamalarına göre iletiye sığmıyorsa belirtilen en yüksek sonuçlardan daha az olabilir. Bu parametre sıfırsa veya belirtilmemişse, sayfalanan sorgu dönüş iletisine sığabilecek kadar çok sonuç içerir.
timeout
Tür: tamsayı (int64)
Gerekli: Hayır
Varsayılan: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemeye istekli olduğu süreyi belirtir. Bu parametre için varsayılan değer 60 saniyedir.
Yanıtlar
HTTP Durum Kodu | Description | Yanıt Şeması |
---|---|---|
200 (Tamam) | Kaos olaylarının sonraki bölümü. |
ChaosEventsSegment |
Diğer tüm durum kodları | Ayrıntılı hata yanıtı. |
Doku Oluşturucu |
Örnekler
Zaman aralığı verilen Chaos olaylarını alma
Bu örnekte ContinuationToken parametresi aracılığıyla disk belleğine gerek kalmadan tek bir yanıt iletisinde Chaos olaylarının nasıl alınıyor olduğu gösterilmektedir.
İstek
GET http://localhost:19080/Tools/Chaos/Events?api-version=6.2&StartTimeUtc=0&EndTimeUtc=3155378975999999999
200 Yanıt
Gövde
{
"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"
]
}
}
]
}