Dapatkan Service Health Menggunakan Kebijakan
Mendapatkan kesehatan layanan Service Fabric yang ditentukan, dengan menggunakan kebijakan kesehatan yang ditentukan.
Mendapatkan informasi kesehatan dari layanan yang telah ditentukan. Jika kebijakan kesehatan aplikasi ditentukan, evaluasi kesehatan menggunakannya untuk mendapatkan status kesehatan agregat. Jika kebijakan tidak ditentukan, evaluasi kesehatan menggunakan kebijakan kesehatan aplikasi yang ditentukan dalam manifes aplikasi, atau kebijakan kesehatan default, jika tidak ada kebijakan yang ditentukan dalam manifes. Gunakan EventsHealthStateFilter untuk memfilter pengumpulan peristiwa kesehatan yang dilaporkan pada layanan berdasarkan keadaan kesehatan. Gunakan PartitionsHealthStateFilter untuk memfilter koleksi partisi yang dikembalikan. Jika Anda menentukan layanan yang tidak ada di penyimpanan kesehatan, permintaan ini mengembalikan kesalahan.
Minta
| Metode | URI Permintaan |
|---|---|
| POST | /Services/{serviceId}/$/GetHealth?api-version=6.0&EventsHealthStateFilter={EventsHealthStateFilter}&PartitionsHealthStateFilter={PartitionsHealthStateFilter}&ExcludeHealthStatistics={ExcludeHealthStatistics}&timeout={timeout} |
Parameter
| Nama | Jenis | Diperlukan | Lokasi |
|---|---|---|---|
serviceId |
string | Ya | Jalur |
api-version |
string | Ya | Kueri |
EventsHealthStateFilter |
bilangan bulat | Tidak | Kueri |
PartitionsHealthStateFilter |
bilangan bulat | Tidak | Kueri |
ExcludeHealthStatistics |
boolean | Tidak | Kueri |
timeout |
bilangan bulat (int64) | Tidak | Kueri |
ApplicationHealthPolicy |
ApplicationHealthPolicy | Tidak | Isi |
serviceId
Jenis: string
Diperlukan: Ya
Identitas layanan. ID ini biasanya merupakan nama lengkap layanan tanpa skema URI 'fabric:’.
Mulai dari versi 6.0, nama hierarki dibatasi dengan karakter “~”.
Misalnya, jika nama layanan adalah "fabric:/myapp/app1/svc1", identitas layanan akan menjadi "myapp~app1~svc1" di 6.0+ dan "myapp/app1/svc1" di versi sebelumnya.
api-version
Jenis: string
Diperlukan: Ya
Default: 6.0
Versi API. Parameter ini diperlukan dan nilainya harus '6.0'.
Versi REST API Service Fabric didasarkan pada versi runtime tempat API diperkenalkan atau diubah. Runtime Service Fabric mendukung lebih dari satu versi API. 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, tetapi jika runtime adalah 6.1, untuk mempermudah penulisan klien, runtime akan menerima versi 6.1 untuk API tersebut. Namun perilaku API akan sesuai dengan versi 6.0 yang di dokumentasikan.
EventsHealthStateFilter
Jenis: bilangan bulat
Diperlukan: Tidak
Default: 0
Memungkinkan pemfilteran koleksi objek HealthEvent yang dikembalikan berdasarkan status kesehatan.
Nilai yang mungkin untuk parameter ini termasuk nilai bilangan bulat dari salah satu status kesehatan berikut.
Hanya peristiwa yang cocok dengan filter yang dikembalikan. Semua peristiwa digunakan untuk mengevaluasi status kesehatan agregat.
Jika tidak ditentukan, semua entri akan dikembalikan. Nilai status adalah enumerasi berbasis bendera, sehingga nilainya bisa berupa kombinasi dari nilai-nilai ini, yang diperoleh menggunakan operator 'OR' bitwise. Misalnya, Jika nilai yang diberikan adalah 6, maka semua peristiwa dengan nilai HealthState OK (2) dan Warning (4) dikembalikan.
- Default - Nilai default. Mencocokkan dengan HealthState. Nilainya berbasis nol.
- None - Filter yang tidak cocok dengan nilai HealthState apa pun. Digunakan untuk mengembalikan tanpa hasil pada koleksi status tertentu. Nilainya adalah 1.
- Ok - Filter yang cocok dengan input dengan nilai HealthState Ok. Nilainya adalah 2.
- Peringatan - Filter yang cocok dengan input dengan peringatan nilai HealthState. Nilainya adalah 4.
- Kesalahan - Filter yang cocok dengan input dengan nilai HealthState Kesalahan. Nilainya adalah 8.
- Semua - Filter yang cocok dengan input dengan nilai HealthState apa pun. Nilainya adalah 65535.
PartitionsHealthStateFilter
Jenis: bilangan bulat
Diperlukan: Tidak
Default: 0
Memungkinkan pemfilteran objek status kesehatan partisi yang dikembalikan dalam hasil kueri kesehatan layanan berdasarkan status kesehatannya.
Nilai yang mungkin untuk parameter ini termasuk nilai bilangan bulat dari salah satu status kesehatan berikut.
Hanya partisi yang cocok dengan filter yang dikembalikan. Semua peristiwa digunakan untuk mengevaluasi status kesehatan agregat.
Jika tidak ditentukan, semua entri akan dikembalikan. Nilai status adalah enumerasi berbasis bendera, sehingga nilainya bisa berupa kombinasi dari nilai-nilai ini, yang diperoleh menggunakan operator 'OR' bitwise. Misalnya, jika nilai yang diberikan adalah 6, maka status kesehatan partisi dengan nilai HealthState OK (2) dan Warning (4) akan dikembalikan.
- Default - Nilai default. Mencocokkan dengan HealthState. Nilainya berbasis nol.
- None - Filter yang tidak cocok dengan nilai HealthState apa pun. Digunakan untuk mengembalikan tanpa hasil pada koleksi status tertentu. Nilainya adalah 1.
- Ok - Filter yang cocok dengan input dengan nilai HealthState Ok. Nilainya adalah 2.
- Peringatan - Filter yang cocok dengan input dengan nilai HealthState Peringatan. Nilainya adalah 4.
- Kesalahan - Filter yang cocok dengan input dengan nilai HealthState Kesalahan. Nilainya adalah 8.
- Semua - Filter yang cocok dengan input dengan nilai HealthState apa pun. Nilainya adalah 65535.
ExcludeHealthStatistics
Jenis: boolean
Diperlukan: Tidak
Default: false
Menunjukkan apakah statistik kesehatan harus dikembalikan sebagai bagian dari hasil kueri. Salah secara default.
Statistik menunjukkan jumlah entitas anak dalam keadaan kesehatan Ok, Warning, dan Error.
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.
ApplicationHealthPolicy
Jenis: ApplicationHealthPolicy
Diperlukan: Tidak
Menjelaskan kebijakan kesehatan yang digunakan untuk mengevaluasi kesehatan aplikasi atau salah satu anaknya.
Jika tidak ada, evaluasi kesehatan menggunakan kebijakan kesehatan dari manifes aplikasi atau kebijakan kesehatan default.
Respons
| Kode Status HTTP | Deskripsi | Skema Respons |
|---|---|---|
| 200 (OK) | Operasi yang berhasil akan mengembalikan 200 kode status dan informasi kesehatan dari layanan yang ditentukan. |
ServiceHealth |
| Semua kode status lainnya | Respons kesalahan terperinci. |
FabricError |