Port List Group Form
The Port List Group form creates a new group or edits an existing one. Port list groups bundle multiple port lists into a single named collection so a Scan Template can reference one group instead of every individual list.
Inputs
| Name | Description | Allowed values | Default |
|---|---|---|---|
Name | Human-readable label for this group | Non-empty string, must be unique across port list groups (e.g., "web-stack") | — |
Description | Optional free-text note | Any text, max 10,000 characters | Empty |
Port Lists | Selection of one or more port lists to include in this group. Each row in the picker shows the port list name and its port set. | At least one selection (the form will not save an empty group) | None |
Gotchas
- **When creating:** Choose group names that describe the bundled set ("web-stack" rather than "common"). Port list groups are referenced by name in Scan Templates.
- **When editing:** Removing a port list from this group affects every scan template that uses the group — there is no warning. Confirm which templates depend on this group before saving.
- Port list groups that are referenced by a scan template cannot be deleted — remove the references first.
- A port list can belong to multiple groups simultaneously. There is no exclusivity constraint.
API calls (4)
| Method | Path | Description |
|---|---|---|
| GET | /api/config/port-list-groups/:id | Load an existing port list group (Edit mode) |
| GET | /api/config/port-lists | List available port lists for selection |
| POST | /api/config/port-list-groups | Create a new port list group (Create mode) |
| PUT | /api/config/port-list-groups/:id | Update an existing port list group (Edit mode) |
Related
- Port List Groups — Parent list page — describes filtering, deletion, and group-level operations
- Port Lists — Members of port list groups
- Scan Templates — Consumes port list groups to define what gets scanned