Dapatkan Daftar Info Simpul
Mendapatkan daftar node di kluster Service Fabric.
Respons mencakup nama, status, ID, kesehatan, waktu aktif, dan detail lainnya tentang node.
Minta
Metode | URI Permintaan |
---|---|
GET | /Nodes?api-version=6.3&ContinuationToken={ContinuationToken}&NodeStatusFilter={NodeStatusFilter}&MaxResults={MaxResults}&timeout={timeout} |
Parameter
Nama | Jenis | Diperlukan | Lokasi |
---|---|---|---|
api-version |
string | Ya | Kueri |
ContinuationToken |
string | Tidak | Kueri |
NodeStatusFilter |
string (enum) | Tidak | Kueri |
MaxResults |
bilangan bulat (int64) | Tidak | Kueri |
timeout |
bilangan bulat (int64) | Tidak | Kueri |
api-version
Jenis: string
Diperlukan: Ya
Default: 6.3
Versi API. Parameter ini diperlukan dan nilainya harus '6.3'.
Versi REST API Service Fabric didasarkan pada versi runtime tempat API diperkenalkan atau diubah. Runtime Service Fabric mendukung lebih dari satu versi API. Versi ini adalah versi API terbaru yang didukung. Jika versi API yang lebih rendah diteruskan, respons yang dikembalikan mungkin berbeda dari yang di dokumentasikan 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 dan runtime adalah 6.1, runtime akan menerima versi 6.1 untuk API tersebut. Namun perilaku API akan sesuai dengan versi 6.0 yang di dokumentasikan.
ContinuationToken
Jenis: string
Diperlukan: Tidak
Parameter token kelanjutan digunakan untuk mendapatkan serangkaian hasil berikutnya. Token kelanjutan dengan nilai tidak kosong disertakan dalam respons API ketika hasil dari sistem tidak sesuai dalam respons tunggal. Ketika nilai ini diteruskan ke panggilan API berikutnya, API mengembalikan serangkaian hasil berikutnya. Jika tidak ada hasil lebih lanjut, maka token kelanjutan tidak berisi nilai. Nilai parameter ini tidak boleh dikodekan URL.
NodeStatusFilter
Jenis: string (enum)
Diperlukan: Tidak
Default: default
Memungkinkan pemfilteran node berdasarkan NodeStatus. Hanya node yang cocok dengan nilai filter yang ditentukan yang akan dikembalikan. Nilai filter bisa menjadi salah satu hal berikut ini. Nilai yang mungkin termasuk: 'default', 'all', 'up', 'down', 'enabling', 'disabling', 'disabled', 'unknown', 'removed'
MaxResults
Jenis: bilangan bulat (int64)
Diperlukan: Tidak
Default: 0
InclusiveMinimum: 0
Jumlah maksimum hasil yang akan dikembalikan sebagai bagian dari kueri halaman. Parameter ini menentukan batas atas pada jumlah hasil yang dikembalikan. Hasil yang dikembalikan dapat kurang dari hasil maksimum yang ditentukan jika tidak cocok dalam pesan berdasarkan pembatasan ukuran pesan maksimum yang ditentukan dalam konfigurasi. Jika parameter ini nol atau tidak ditentukan, kueri halaman mencakup hasil sebanyak mungkin yang cocok dalam pesan kembali.
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) | Daftar simpul dalam kluster. |
PagedNodeInfoList |
Semua kode status lainnya | Respons kesalahan terperinci. |
FabricError |
Contoh
Mendapatkan informasi tentang semua simpul
Contoh ini menunjukkan cara mendapatkan informasi tentang semua simpul dalam kluster ketika informasi cocok dalam satu pesan respons tanpa perlu penomor melalui parameter ContinuationToken.
Minta
GET http://localhost:19080/Nodes?api-version=6.3
Respons 200
Isi
{
"ContinuationToken": "",
"Items": [
{
"Name": "_Node_1",
"IpAddressOrFQDN": "10.0.0.5",
"Type": "testnode",
"CodeVersion": "6.3.139.9494",
"ConfigVersion": "5",
"NodeStatus": "Up",
"NodeUpTimeInSeconds": "15275",
"HealthState": "Ok",
"IsSeedNode": true,
"UpgradeDomain": "1",
"FaultDomain": "fd:/1",
"Id": {
"Id": "ebd986a1134b3643a8117fb41b259bf"
},
"InstanceId": "131738274982501335",
"NodeDeactivationInfo": {
"NodeDeactivationIntent": "Invalid",
"NodeDeactivationStatus": "None",
"NodeDeactivationTask": [],
"PendingSafetyChecks": []
},
"IsStopped": false,
"NodeDownTimeInSeconds": "0",
"NodeUpAt": "2018-06-18T20:31:39.842Z",
"NodeDownAt": "2018-06-18T20:31:37.374Z"
},
{
"Name": "_Node_0",
"IpAddressOrFQDN": "10.0.0.4",
"Type": "testnode",
"CodeVersion": "6.3.139.9494",
"ConfigVersion": "5",
"NodeStatus": "Up",
"NodeUpTimeInSeconds": "18742",
"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"
},
{
"Name": "_Node_4",
"IpAddressOrFQDN": "10.0.0.8",
"Type": "testnode",
"CodeVersion": "6.3.139.9494",
"ConfigVersion": "5",
"NodeStatus": "Up",
"NodeUpTimeInSeconds": "101168",
"HealthState": "Ok",
"IsSeedNode": true,
"UpgradeDomain": "4",
"FaultDomain": "fd:/4",
"Id": {
"Id": "ba9383d728221add7fa996bf67b757fb"
},
"InstanceId": "131737415865259763",
"NodeDeactivationInfo": {
"NodeDeactivationIntent": "Invalid",
"NodeDeactivationStatus": "None",
"NodeDeactivationTask": [],
"PendingSafetyChecks": []
},
"IsStopped": false,
"NodeDownTimeInSeconds": "0",
"NodeUpAt": "2018-06-17T20:40:07.378Z",
"NodeDownAt": "2018-06-17T20:33:11.877Z"
},
{
"Name": "_Node_3",
"IpAddressOrFQDN": "10.0.0.7",
"Type": "testnode",
"CodeVersion": "6.3.139.9494",
"ConfigVersion": "5",
"NodeStatus": "Up",
"NodeUpTimeInSeconds": "15236",
"HealthState": "Ok",
"IsSeedNode": true,
"UpgradeDomain": "3",
"FaultDomain": "fd:/3",
"Id": {
"Id": "d6a18a0935a3e39aeae2a049eb97255d"
},
"InstanceId": "131738275300526952",
"NodeDeactivationInfo": {
"NodeDeactivationIntent": "Invalid",
"NodeDeactivationStatus": "None",
"NodeDeactivationTask": [],
"PendingSafetyChecks": []
},
"IsStopped": false,
"NodeDownTimeInSeconds": "0",
"NodeUpAt": "2018-06-18T20:32:18.884Z",
"NodeDownAt": "2018-06-18T20:31:59.128Z"
},
{
"Name": "_Node_2",
"IpAddressOrFQDN": "10.0.0.6",
"Type": "testnode",
"CodeVersion": "6.3.139.9494",
"ConfigVersion": "5",
"NodeStatus": "Up",
"NodeUpTimeInSeconds": "19440",
"HealthState": "Ok",
"IsSeedNode": true,
"UpgradeDomain": "2",
"FaultDomain": "fd:/2",
"Id": {
"Id": "f2af91e5e9c8254dedb75b1424a9e3fc"
},
"InstanceId": "131738233282843485",
"NodeDeactivationInfo": {
"NodeDeactivationIntent": "Invalid",
"NodeDeactivationStatus": "None",
"NodeDeactivationTask": [],
"PendingSafetyChecks": []
},
"IsStopped": false,
"NodeDownTimeInSeconds": "0",
"NodeUpAt": "2018-06-18T19:22:15.272Z",
"NodeDownAt": "2018-06-18T19:22:02.74Z"
}
]
}
Batasi hasil maksimum
Contoh ini menunjukkan cara mendapatkan informasi tentang simpul dalam kluster ketika jumlah hasil yang dikembalikan dibatasi oleh parameter MaxResults.
Minta
GET http://localhost:19080/Nodes?api-version=6.3&MaxResults=2
Respons 200
Isi
{
"ContinuationToken": "2acb9f55540659b1c95f27cc128ab326",
"Items": [
{
"Name": "_testnode_1",
"IpAddressOrFQDN": "10.0.0.5",
"Type": "testnode",
"CodeVersion": "6.3.139.9494",
"ConfigVersion": "5",
"NodeStatus": "Up",
"NodeUpTimeInSeconds": "102016",
"HealthState": "Ok",
"IsSeedNode": true,
"UpgradeDomain": "1",
"FaultDomain": "fd:/1",
"Id": {
"Id": "ebd986a1134b3643a8117fb41b259bf"
},
"InstanceId": "131738274982501335",
"NodeDeactivationInfo": {
"NodeDeactivationIntent": "Invalid",
"NodeDeactivationStatus": "None",
"NodeDeactivationTask": [],
"PendingSafetyChecks": []
},
"IsStopped": false,
"NodeDownTimeInSeconds": "0",
"NodeUpAt": "2018-06-18T20:31:39.842Z",
"NodeDownAt": "2018-06-18T20:31:37.374Z"
},
{
"Name": "_testnode_0",
"IpAddressOrFQDN": "10.0.0.4",
"Type": "testnode",
"CodeVersion": "6.3.139.9494",
"ConfigVersion": "5",
"NodeStatus": "Up",
"NodeUpTimeInSeconds": "105483",
"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"
}
]
}
Halaman menggunakan token kelanjutan
Contoh ini menunjukkan cara mendapatkan informasi tentang simpul di kluster yang muncul di halaman berurutan, dengan menggunakan parameter ContinuationToken.
Minta
GET http://localhost:19080/Nodes?api-version=6.3&ContinuationToken=2acb9f55540659b1c95f27cc128ab326
Respons 200
Isi
{
"ContinuationToken": "",
"Items": [
{
"Name": "_Node_4",
"IpAddressOrFQDN": "10.0.0.8",
"Type": "testnode",
"CodeVersion": "6.3.139.9494",
"ConfigVersion": "5",
"NodeStatus": "Up",
"NodeUpTimeInSeconds": "101547",
"HealthState": "Ok",
"IsSeedNode": true,
"UpgradeDomain": "4",
"FaultDomain": "fd:/4",
"Id": {
"Id": "ba9383d728221add7fa996bf67b757fb"
},
"InstanceId": "131737415865259763",
"NodeDeactivationInfo": {
"NodeDeactivationIntent": "Invalid",
"NodeDeactivationStatus": "None",
"NodeDeactivationTask": [],
"PendingSafetyChecks": []
},
"IsStopped": false,
"NodeDownTimeInSeconds": "0",
"NodeUpAt": "2018-06-17T20:40:07.378Z",
"NodeDownAt": "2018-06-17T20:33:11.877Z"
},
{
"Name": "_Node_3",
"IpAddressOrFQDN": "10.0.0.7",
"Type": "testnode",
"CodeVersion": "6.3.139.9494",
"ConfigVersion": "5",
"NodeStatus": "Up",
"NodeUpTimeInSeconds": "15615",
"HealthState": "Ok",
"IsSeedNode": true,
"UpgradeDomain": "3",
"FaultDomain": "fd:/3",
"Id": {
"Id": "d6a18a0935a3e39aeae2a049eb97255d"
},
"InstanceId": "131738275300526952",
"NodeDeactivationInfo": {
"NodeDeactivationIntent": "Invalid",
"NodeDeactivationStatus": "None",
"NodeDeactivationTask": [],
"PendingSafetyChecks": []
},
"IsStopped": false,
"NodeDownTimeInSeconds": "0",
"NodeUpAt": "2018-06-18T20:32:18.884Z",
"NodeDownAt": "2018-06-18T20:31:59.128Z"
},
{
"Name": "_Node_2",
"IpAddressOrFQDN": "10.0.0.6",
"Type": "testnode",
"CodeVersion": "6.3.139.9494",
"ConfigVersion": "5",
"NodeStatus": "Up",
"NodeUpTimeInSeconds": "19819",
"HealthState": "Ok",
"IsSeedNode": true,
"UpgradeDomain": "2",
"FaultDomain": "fd:/2",
"Id": {
"Id": "f2af91e5e9c8254dedb75b1424a9e3fc"
},
"InstanceId": "131738233282843485",
"NodeDeactivationInfo": {
"NodeDeactivationIntent": "Invalid",
"NodeDeactivationStatus": "None",
"NodeDeactivationTask": [],
"PendingSafetyChecks": []
},
"IsStopped": false,
"NodeDownTimeInSeconds": "0",
"NodeUpAt": "2018-06-18T19:22:15.272Z",
"NodeDownAt": "2018-06-18T19:22:02.74Z"
}
]
}