Memanggil Kueri Infrastruktur

  • Artikel

Memanggil kueri baca-saja pada instans layanan infrastruktur yang ada.

Untuk kluster yang memiliki satu atau beberapa instans Infrastructure Service yang dikonfigurasi, API ini menyediakan cara untuk mengirim kueri khusus infrastruktur ke contoh tertentu dari Infrastructure Service.

Perintah yang tersedia dan format respons yang sesuai bervariasi, bergantung pada infrastruktur tempat kluster berjalan.

API ini mendukung platform Service Fabric; hal ini tidak untuk digunakan langsung dari kode Anda.

Minta

Metode URI Permintaan
GET /$/InvokeInfrastructureQuery?api-version=6.0&Command={Command}&ServiceId={ServiceId}&timeout={timeout}

Parameter

Nama Jenis Diperlukan Lokasi
api-version string Ya Kueri
Command string Ya Kueri
ServiceId string Tidak 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.

Command

Jenis: string
Diperlukan: Ya

Teks perintah yang akan diminta. Isi perintah ini khusus infrastruktur.

ServiceId

Jenis: string
Diperlukan: Tidak

Identitas layanan infrastruktur. Ini biasanya merupakan nama lengkap infrastruktur tanpa skema URI 'fabric'. Parameter ini hanya diperlukan untuk kluster yang memiliki lebih dari satu contoh layanan infrastruktur yang berjalan.

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) Respons dari layanan infrastruktur. Format respons adalah aliran JSON.
Konten respons bergantung pada perintah mana yang dikeluarkan.
 string
Semua kode status lainnya Respons kesalahan terperinci.
 FabricError