Dapatkan Informasi Replika Yang Tidak Ditempatkan
Mendapatkan informasi tentang replika layanan yang tidak ditempatkan.
Mengembalikan informasi tentang replika layanan yang tidak ditempatkan. Jika PartitionId ditentukan, hasilnya hanya akan berisi informasi tentang replika yang tidak ditempatkan untuk partisi tersebut. Jika PartitionId tidak ditentukan, hasilnya akan berisi informasi tentang replika yang tidak ditempatkan untuk semua partisi layanan tersebut. Jika OnlyQueryPrimaries diatur ke true, hasilnya hanya akan berisi informasi tentang replika utama, dan akan mengabaikan replika sekunder yang tidak ditempatkan.
Minta
Metode | URI Permintaan |
---|---|
GET | /Services/{serviceId}/$/GetUnplacedReplicaInformation?api-version=6.4&PartitionId={PartitionId}&OnlyQueryPrimaries={OnlyQueryPrimaries}&timeout={timeout} |
Parameter
Nama | Jenis | Diperlukan | Lokasi |
---|---|---|---|
serviceId |
string | Ya | Jalur |
api-version |
string | Ya | Kueri |
PartitionId |
string (uuid) | Tidak | Kueri |
OnlyQueryPrimaries |
boolean | 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.4
Versi API. Parameter ini diperlukan dan nilainya harus '6.4'.
Versi REST API Service Fabric didasarkan pada versi runtime tempat API diperkenalkan atau diubah. Runtime Service Fabric mendukung lebih dari satu versi API. Versi 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 dan runtime adalah 6.1, runtime akan menerima versi 6.1 untuk API tersebut. Namun perilaku API akan sesuai dengan versi 6.0 yang di dokumentasikan.
PartitionId
Jenis: string (uuid)
Diperlukan: Tidak
Identitas partisi.
OnlyQueryPrimaries
Jenis: boolean
Diperlukan: Tidak
Default: false
Menunjukkan bahwa informasi replika yang tidak ditempatkan hanya akan menjadi kueri untuk replika utama.
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) | Informasi tentang layanan yang ditentukan. |
UnplacedReplicaInformation |
Semua kode status lainnya | Respons kesalahan terperinci. |
FabricError |