blink_device_leds
Blink the locator LEDs of a network device to find it physically. Specify the device serial and optional blink duration.
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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| serial | Yes | ||
| target | No | ||
| duration | No |