Panggil Perintah Infrastruktur
Meminta perintah administratif pada instans Infrastructure Service yang ada.
Untuk kluster yang memiliki satu atau beberapa instans Infrastructure Service yang dikonfigurasi, API ini menyediakan cara untuk mengirim perintah khusus infrastruktur ke instans 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 |
---|---|
POST | /$/InvokeInfrastructureCommand?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 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.
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 |