Start periodic interface outage
POST
/tasks/interface/flap/schedule/start/{id}Starts successive interface disable-and-restore cycles. The first cycle starts immediately; each subsequent cycle starts only after the current one completes, the Up state is confirmed, and the interval_sec delay elapses.
Contract
Parameter | Value |
|---|---|
| Section | tasks |
| Authentication | CookieAuth |
| Consumes | application/json |
| Produces | application/json |
Parameters
2 parameters
Name | Location | Required | Type | Description |
|---|---|---|---|---|
| id | path | yes | integer | Task ID |
| request | body | no | object | Schedule parameters: interval_sec (>0), agent, interface, down_ms, up_timeout_ms; empty agent/interface values mean all agents and configured task ports |
{}
Responses
4 responses
Status | Description | Type |
|---|---|---|
200 | Response: {status: ok, results: {host: ...}} | object |
400 | Invalid task ID | object |
401 | Unauthorized | object |
500 | Task is not running, has no agents, or the command could not be sent (includes per-agent results) | object |
{}{ "data": {}, "error": "<string>" }{ "data": {}, "error": "<string>" }{}