Atasi Layanan
Selesaikan partisi Service Fabric.
Selesaikan partisi layanan Service Fabric untuk mendapatkan titik akhir replika layanan.
Minta
| Metode | URI Permintaan |
|---|---|
| GET | /Services/{serviceId}/$/ResolvePartition?api-version=6.0&PartitionKeyType={PartitionKeyType}&PartitionKeyValue={PartitionKeyValue}&PreviousRspVersion={PreviousRspVersion}&timeout={timeout} |
Parameter
| Nama | Jenis | Diperlukan | Lokasi |
|---|---|---|---|
serviceId |
string | Ya | Jalur |
api-version |
string | Ya | Kueri |
PartitionKeyType |
bilangan bulat | Tidak | Kueri |
PartitionKeyValue |
string | Tidak | Kueri |
PreviousRspVersion |
string | Tidak | 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.
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.
PartitionKeyType
Jenis: bilangan bulat
Diperlukan: Tidak
Jenis kunci untuk partisi. Parameter ini diperlukan jika skema partisi untuk layanan adalah Int64Range atau Named. Kemungkinan nilainya adalah sebagai berikut.
- Tidak ada (1) - Menunjukkan bahwa parameter PartitionKeyValue tidak ditentukan. Ini berlaku untuk partisi dengan skema partisi sebagai Singleton. Ini adalah nilai default. Nilainya adalah 1.
- Int64Range (2) - Menunjukkan bahwa parameter PartitionKeyValue adalah kunci partisi int64. Ini berlaku untuk partisi dengan skema partisi sebagai Int64Range. Nilainya adalah 2.
- Bernama (3) - Menunjukkan bahwa parameter PartitionKeyValue adalah nama partisi. Ini berlaku untuk partisi dengan skema partisi sebagai Named. Nilainya adalah 3.
PartitionKeyValue
Jenis: string
Diperlukan: Tidak
Kunci partisi. Ini diperlukan jika skema partisi untuk layanan adalah Int64Range atau Named.
Ini bukan ID partisi, melainkan nilai kunci bilangan bulat atau nama ID partisi.
Misalnya, jika layanan Anda menggunakan partisi rentang dari 0 hingga 10, maka PartitionKeyValue akan menjadi bilangan bulat dalam rentang tersebut. Deskripsi layanan kueri untuk melihat rentang atau nama.
PreviousRspVersion
Jenis: string
Diperlukan: Tidak
Nilai di bidang Versi respons yang diterima sebelumnya. Ini diperlukan jika pengguna tahu bahwa hasil yang diperoleh sebelumnya kedaluwarsa.
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. |
ResolvedServicePartition |
| Semua kode status lainnya | Respons kesalahan terperinci. |
FabricError |