Mulai Kehilangan Data
API ini akan mendorong kehilangan data untuk partisi yang ditentukan. Ini akan memicu panggilan ke API OnDataLossAsync dari partisi.
API ini akan mendorong kehilangan data untuk partisi yang ditentukan. Ini akan memicu panggilan ke OnDataLoss API dari partisi. Kehilangan data aktual akan tergantung pada DataLossMode yang ditentukan.
- PartialDataLoss - Hanya kuorum replika yang dihapus dan OnDataLoss dipicu untuk partisi tetapi kehilangan data aktual tergantung pada adanya replikasi dalam penerbangan.
- FullDataLoss - Semua replika dihapus karenanya semua data hilang dan OnDataLoss dipicu.
API ini hanya boleh dipanggil dengan layanan yang stateful sebagai target.
Memanggil API ini dengan layanan sistem karena target tidak disarankan.
Catatan: Setelah API ini dipanggil, API tidak dapat dibalik. Memanggil CancelOperation hanya akan menghentikan eksekusi dan membersihkan status sistem internal. Ini tidak akan memulihkan data jika perintah telah berkembang cukup jauh untuk menyebabkan kehilangan data.
Hubungi GetDataLossProgress API dengan OperationId yang sama untuk mengembalikan informasi tentang operasi yang dimulai dengan API ini.
Minta
| Metode | URI Permintaan |
|---|---|
| POST | /Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/StartDataLoss?api-version=6.0&OperationId={OperationId}&DataLossMode={DataLossMode}&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 |
DataLossMode |
string (enum) | 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
DataLossMode
Jenis: string (enum)
Diperlukan: Ya
Enum ini diteruskan ke StartDataLoss API untuk menunjukkan jenis kehilangan data yang harus didorong. Nilai yang mungkin termasuk: 'Invalid', 'PartialDataLoss', 'FullDataLoss'
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 GetDataLossProgress API untuk mendapatkan kemajuannya. |
|
| Semua kode status lainnya | Respons kesalahan terperinci. |
FabricError |