Memulai Transisi Simpul
Memulai atau menghentikan node kluster.
Memulai atau menghentikan node kluster. Node kluster adalah proses, bukan instans OS itu sendiri. Untuk memulai node, teruskan "Mulai" ke parameter NodeTransitionType. Untuk menghentikan node, teruskan "Hentikan" ke parameter NodeTransitionType. API ini memulai operasi - ketika API mengembalikan node mungkin belum selesai bertransisi. Hubungi GetNodeTransitionProgress dengan OperationId yang sama untuk mendapatkan kemajuan operasi.
Minta
| Metode | URI Permintaan |
|---|---|
| POST | /Faults/Nodes/{nodeName}/$/StartTransition/?api-version=6.0&OperationId={OperationId}&NodeTransitionType={NodeTransitionType}&NodeInstanceId={NodeInstanceId}&StopDurationInSeconds={StopDurationInSeconds}&timeout={timeout} |
Parameter
| Nama | Jenis | Diperlukan | Lokasi |
|---|---|---|---|
nodeName |
string | Ya | Jalur |
api-version |
string | Ya | Kueri |
OperationId |
string (uuid) | Ya | Kueri |
NodeTransitionType |
string (enum) | Ya | Kueri |
NodeInstanceId |
string | Ya | Kueri |
StopDurationInSeconds |
bilangan bulat (int32) | Ya | Kueri |
timeout |
bilangan bulat (int64) | Tidak | Kueri |
nodeName
Jenis: string
Diperlukan: Ya
Nama node.
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.
OperationId
Jenis: string (uuid)
Diperlukan: Ya
GUID yang mengidentifikasi panggilan API ini. Ini diteruskan ke GetProgress API yang sesuai
NodeTransitionType
Jenis: string (enum)
Diperlukan: Ya
Menunjukkan tipe transisi yang akan dilakukan. NodeTransitionType.Start akan memulai node yang dihentikan. NodeTransitionType.Stop akan menghentikan node yang naik. Nilai yang mungkin termasuk: 'Invalid', 'Start', 'Stop'
NodeInstanceId
Jenis: string
Diperlukan: Ya
ID instance node dari node target. Hal ini dapat ditentukan melalui GetNodeInfo API.
StopDurationInSeconds
Jenis: bilangan bulat (int32)
Diperlukan: Ya
InclusiveMinimum: 0
Durasi, dalam hitungan detik, agar node berhenti. Nilai minimum adalah 600, maksimum 14400. Setelah waktu ini berakhir, node akan secara otomatis muncul kembali.
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. Panggil GetNodeTransitionProgress API untuk mendapatkan kemajuan. |
|
| Semua kode status lainnya | Respons kesalahan terperinci. |
FabricError |