Batalkan Operasi
Membatalkan operasi kesalahan yang diinduksi pengguna.
API berikut memulai operasi kesalahan yang mungkin dibatalkan dengan menggunakan CancelOperation: StartDataLoss, StartQuorumLoss, StartPartitionRestart, StartNodeTransition.
Jika nilai force false, maka operasi yang diinduksi pengguna yang ditentukan akan dihentikan sesuai prosedur dan dibersihkan. Jika nilai forse true, perintah akan dibatalkan, dan beberapa keadaan internal mungkin tertinggal. Menentukan forse sebagai benar harus digunakan dengan hati-hati. Memanggil API ini dengan force diatur ke true tidak diperbolehkan sampai API ini telah dipanggil pada perintah pengujian yang sama dengan force diatur ke false terlebih dahulu, atau kecuali jika perintah pengujian sudah memiliki OperationState of OperationState.RollingBack. Klarifikasi: OperationState.RollingBack berarti sistem akan/sedang membersihkan status sistem internal yang disebabkan oleh eksekusi perintah. Tindakan ini tidak akan memulihkan data jika perintah pengujian menyebabkan kehilangan data. Misalnya, jika Anda memanggil StartDataLoss, maka panggil API ini, sistem hanya akan membersihkan status internal agar tidak menjalankan perintah. Ini tidak akan mengembalikan data partisi target, jika perintah berkembang cukup jauh untuk menyebabkan kehilangan data.
Catatan penting: jika API ini dipanggil dengan force==true, status internal mungkin tertinggal.
Minta
| Metode | URI Permintaan |
|---|---|
| POST | /Faults/$/Cancel?api-version=6.0&OperationId={OperationId}&Force={Force}&timeout={timeout} |
Parameter
| Nama | Jenis | Diperlukan | Lokasi |
|---|---|---|---|
api-version |
string | Ya | Kueri |
OperationId |
string (uuid) | Ya | Kueri |
Force |
boolean | Ya | Kueri |
timeout |
bilangan bulat (int64) | Tidak | Kueri |
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.
OperationId
Jenis: string (uuid)
Diperlukan: Ya
GUID yang mengidentifikasi panggilan API ini. Ini diteruskan ke GetProgress API yang sesuai
Force
Jenis: boolean
Diperlukan: Ya
Default: false
Menunjukkan apakah akan dengan sesuai prosedur menggulung balik dan membersihkan status sistem internal yang dimodifikasi dengan menjalankan operasi yang diinduksi pengguna.
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 kode status 200. |
|
| Semua kode status lainnya | Respons kesalahan terperinci. |
FabricError |