Düğüm Bilgilerini Alma
Service Fabric kümesindeki belirli bir düğüm hakkındaki bilgileri alır.
Yanıt ad, durum, kimlik, sistem durumu, çalışma süresi ve düğümle ilgili diğer ayrıntıları içerir.
İstek
Yöntem | İstek URI'si |
---|---|
GET | /Nodes/{nodeName}?api-version=6.0&timeout={timeout} |
Parametreler
Ad | Tür | Gerekli | Konum |
---|---|---|---|
nodeName |
string | Yes | Yol |
api-version |
string | Yes | Sorgu |
timeout |
integer (int64) | No | Sorgu |
nodeName
Tür: dize
Gerekli: Evet
Düğümün adı.
api-version
Tür: dize
Gerekli: Evet
Varsayılan: 6.0
API sürümü. Bu parametre gereklidir ve değeri '6.0' 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, 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.
Buna ek olarak ç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 ediyor. Bu nedenle, en son API sürümü 6.0 ise ancak çalışma zamanı 6.1 ise, istemcileri yazmayı kolaylaştırmak için ç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.
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) | Başarılı bir işlem, belirtilen nodeName ile düğüm hakkında bilgi döndürür. |
Nodeınfo |
204 (NoContent) | Belirtilen nodeName bulunamazsa boş bir yanıt döndürülür. |
|
Diğer tüm durum kodları | Ayrıntılı hata yanıtı. |
Doku Oluşturucu |
Örnekler
Düğüm adına göre belirli bir düğümü alma
Bu örnekte, bir düğümün tanımlayıcısını kullanarak düğüm hakkında bilgi alma gösterilmektedir. Düğüm bulunursa, düğüm hakkındaki bilgiler 200 durum koduyla döndürülür. Düğüm bulunamazsa, 204 durum koduyla boş içerik döndürülür.
İstek
GET http://localhost:19080/Nodes/_Node_1?api-version=6.0
200 Yanıt
Gövde
{
"Name": "_testnode_0",
"IpAddressOrFQDN": "10.0.0.4",
"Type": "testnode",
"CodeVersion": "6.3.139.9494",
"ConfigVersion": "5",
"NodeStatus": "Up",
"NodeUpTimeInSeconds": "18688",
"HealthState": "Ok",
"IsSeedNode": true,
"UpgradeDomain": "0",
"FaultDomain": "fd:/0",
"Id": {
"Id": "2acb9f55540659b1c95f27cc128ab326"
},
"InstanceId": "131738240209152398",
"NodeDeactivationInfo": {
"NodeDeactivationIntent": "Invalid",
"NodeDeactivationStatus": "None",
"NodeDeactivationTask": [],
"PendingSafetyChecks": []
},
"IsStopped": false,
"NodeDownTimeInSeconds": "0",
"NodeUpAt": "2018-06-18T19:33:52.944Z",
"NodeDownAt": "2018-06-18T19:33:39.514Z"
}
204 Yanıtı
Gövde
Yanıt gövdesi boş.