Mulai Kehilangan Kuorum

Artikel
08/05/2023

Mendorong kehilangan kuorum untuk partisi layanan stateful yang ada.

API ini berguna untuk situasi kehilangan kuorum sementara pada layanan Anda.

Panggil GetQuorumLossProgress API dengan OperationId yang sama untuk mengembalikan informasi tentang operasi yang dimulai dengan API ini.

Ini hanya dapat dipanggil pada layanan stateful persisten (HasPersistedState==true). Jangan gunakan API ini pada layanan stateless atau layanan stateful dalam memori saja.

Minta

Metode	URI Permintaan
POST	`/Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/StartQuorumLoss?api-version=6.0&OperationId={OperationId}&QuorumLossMode={QuorumLossMode}&QuorumLossDuration={QuorumLossDuration}&timeout={timeout}`

Parameter

Nama	Jenis	Diperlukan	Lokasi
`serviceId`	string	Ya	Jalur
`partitionId`	string (uuid)	Ya	Jalur
`api-version`	string	Ya	Kueri
`OperationId`	string (uuid)	Ya	Kueri
`QuorumLossMode`	string (enum)	Ya	Kueri
`QuorumLossDuration`	bilangan bulat	Ya	Kueri
`timeout`	bilangan bulat (int64)	Tidak	Kueri

`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.

`partitionId`

Jenis: string (uuid)
Diperlukan: Ya

Identitas partisi.

`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.

`OperationId`

Jenis: string (uuid)
Diperlukan: Ya

GUID yang mengidentifikasi panggilan API ini. Ini diteruskan ke GETProgress API yang sesuai

`QuorumLossMode`

Jenis: string (enum)
Diperlukan: Ya

Enum ini diteruskan ke API StartQuorumLoss untuk menunjukkan jenis kerugian kuorum apa yang harus didorong. Nilai yang mungkin termasuk: 'Invalid', 'QuorumReplicas', 'AllReplicas'

`QuorumLossDuration`

Jenis: bilangan bulat
Diperlukan: Ya

Jumlah waktu saat partisi akan disimpan dalam kerugian kuorum. Ini harus ditentukan dalam hitungan detik.

`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
202 (Diterima)	Kode status 202 menunjukkan operasi diterima. Hubungi GetQuorumLossProgress API untuk mendapatkan kemajuan.
Semua kode status lainnya	Respons kesalahan terperinci.	FabricError

Bagikan melalui