Dapatkan Info Simpul
Mendapatkan informasi tentang node tertentu di kluster Service Fabric.
Respons mencakup nama, status, ID, kesehatan, waktu aktif, dan detail lainnya tentang node.
Minta
Metode | URI Permintaan |
---|---|
GET | /Nodes/{nodeName}?api-version=6.0&timeout={timeout} |
Parameter
Nama | Jenis | Diperlukan | Lokasi |
---|---|---|---|
nodeName |
string | Ya | Jalur |
api-version |
string | Ya | Kueri |
timeout |
bilangan bulat (int64) | Tidak | Kueri |
nodeName
Jenis: string
Diperlukan: Ya
Nama node.
api-version
Jenis: string
Diperlukan: Ya
Default: 6.0
Versi API. Parameter ini diperlukan dan nilainya harus '6.0'.
Versi SERVICE Fabric REST API didasarkan pada versi runtime tempat API diperkenalkan atau diubah. Runtime Service Fabric mendukung lebih dari satu versi API. Ini adalah versi TERBARU api yang didukung. Jika versi API yang lebih rendah diteruskan, respons yang dikembalikan mungkin berbeda dari yang didokumenkan dalam spesifikasi ini.
Selain itu, runtime menerima versi apa pun yang lebih tinggi dari versi terbaru yang didukung hingga versi runtime saat ini. Jadi jika versi API terbaru adalah 6.0, tetapi jika runtime adalah 6.1, untuk mempermudah penulisan klien, runtime akan menerima versi 6.1 untuk API tersebut. Namun perilaku API akan sesuai versi 6.0 yang didokumentasikan.
timeout
Jenis: bilangan bulat (int64)
Diperlukan: Tidak
Default: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
Batas waktu server untuk melakukan operasi dalam hitungan detik. Batas waktu ini menentukan durasi waktu klien bersedia menunggu operasi yang diminta selesai. Nilai default untuk parameter ini adalah 60 detik.
Respons
Kode Status HTTP | Deskripsi | Skema Respons |
---|---|---|
200 (OK) | Operasi yang berhasil akan mengembalikan informasi tentang simpul dengan nodeName yang ditentukan. |
NodeInfo |
204 (NoContent) | Respons kosong dikembalikan jika nodeName yang ditentukan tidak ditemukan. |
|
Semua kode status lainnya | Respons kesalahan terperinci. |
FabricError |
Contoh
Mendapatkan node tertentu menurut nama node
Contoh ini menunjukkan cara mendapatkan informasi tentang simpul menggunakan pengidentifikasinya. Jika simpul ditemukan, informasi tentang simpul tersebut dikembalikan dengan kode status 200. Jika simpul tidak ditemukan, konten kosong dikembalikan dengan kode status 204.
Minta
GET http://localhost:19080/Nodes/_Node_1?api-version=6.0
Respons 200
Isi
{
"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"
}
Respons 204
Isi
Isi respons kosong.