blink_device_leds
Blinks locator LEDs on a network device for a set duration to help locate it physically in a rack or site.
Instructions
[WRITE][risk=medium] Blink a device's locator LEDs to find it physically.
No configuration change (a locate aid), so no undo is recorded. It is still
a POST to the controller, so it is tiered as a write: ``risk_level="low"``
is what marks a tool as a *read*. Tiering this "low" would misreport a POST
as a read in the audit trail, contradicting its own [WRITE] tag.
Args:
serial: Device serial.
duration: Blink duration in seconds (5..120, default 20).
target: Target name from config; omit for the default.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"serial": "<serial>"
},
"name": "blink_device_leds"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| serial | Yes | ||
| target | No | ||
| duration | No |