菜单
Update NetBox object fields using nbox's PATCH write commands — interface set description and device set status. Use when the user wants to change an interface description or a device's status in NetBox.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Query and modify NetBox (DCIM/IPAM) from the shell with the `nbox` CLI — look up devices, interfaces, IPs, prefixes, VLANs, sites, racks, circuits, VRFs, tenants, VMs, and clusters; run cross-object search; use IPAM helpers (next free IP/prefix, prefix utilization, cable-path traces); and safely write (reserve IPs/prefixes, set status/description, manage tags) behind a dry-run/confirm gate. Use when the user asks about NetBox, network inventory, IP addressing, or device/interface/cable details, or wants machine-readable network data or safe mutations. Read-only by default; supports `-o json` / `-o csv` and an MCP server.
Run nbox as an MCP server (read-only by default; optional local stdio writes with --local-writes, or shared HTTP/OIDC writes with --allow-writes + nbox:write + [serve.vault]) so an agent host can query NetBox over JSON-RPC — stdio or HTTP+OIDC transport, the read tools (search/get/get_interface/history/…), the nbox://{kind}/{ref} resource template, the investigation prompts catalog, and --print-config for install recipes. Use when the user wants to wire NetBox into an MCP host or stand up the server.
How to safely modify NetBox through nbox's write commands — the universal dry-run / confirm / audit lifecycle shared by all seven safe-write commands (interface description, device status, IP/prefix/ip-range reserve, tag add/remove). Use when the user wants to change NetBox objects, reserve IPs, or manage tags.
Pull the full physical context of a device or interface from NetBox with nbox — a device's interfaces/IPs/cables/VLANs/services, an interface's cable-path A↔Z trace, a MAC reverse-resolved to its carrying interface/device, plus rack and site context. Use when the user asks how a device is connected, what's on an interface, where a MAC lives, or what's in a rack/site.
Answer IP addressing questions from NetBox with nbox's IPAM read commands — look up an IP and its parent prefix/VLAN/scope, check prefix utilization and the prefix tree, preview the next free IP/prefix, and inspect VLANs, IP ranges, aggregates, VRFs, and route targets. Use when the user asks about addressing, allocation, or routing context.
Find NetBox objects across kinds in one query with nbox's ranked, deduped cross-object search — the entry point when the kind or exact reference isn't known yet. Use when the user wants to locate a device/IP/prefix/VLAN/site/etc. by a name fragment, or narrow by site/tenant/role/tag/status/VRF before a detail lookup.
基于 SOC 职业分类
| name | nbox-patch-writes |
| description | Update NetBox object fields using nbox's PATCH write commands — interface set description and device set status. Use when the user wants to change an interface description or a device's status in NetBox. |
Two update write commands modify specific fields on NetBox objects via
minimal PATCH bodies. Both follow the same dry-run / confirm / audit lifecycle
(see the safe writes skill).
nbox interface <device> <interface> set description "…"Set an interface's description.
nbox --no-tui interface edge01 xe-0/0/1 set description "uplink to core" --dry-run --json
nbox --no-tui interface edge01 xe-0/0/1 set description "uplink to core" --allow-writes --confirm --json
Optional: --message. Run nbox interface <device> <interface> set description --help for the full flag set.
nbox device <name> set status <value>Set a device's status. The status value is validated live against NetBox's
OPTIONS choices before any PATCH — a label (e.g. "active") is accepted
case-insensitively when it maps unambiguously to one canonical value; an
unknown or ambiguous status is a usage error (exit 2) naming the input and
listing the allowed values, before any PATCH.
nbox --no-tui device edge01 set status active --dry-run --json
nbox --no-tui device edge01 set status active --allow-writes --confirm --json
Optional: --message. Run nbox device <name> set status --help for the full
flag set.
{"description": "…"} or {"status": "active"}. No other fields are sent.PATCH — the receipt
reports no_op: true.last_updated + before-hash
on pre-4.6. A concurrent writer is caught (412 / hash mismatch) and the write
is refused with a "re-run dry-run" message (exit 1).OPTIONS request, so nbox
never sends an invalid status. The normalization mechanism
(src/netbox/choices.rs) is reusable for future REST choice fields.