> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/switch-infrastructure/config-manager/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/switch-infrastructure/config-manager/_mcp/server.

# InfiniBand PKey Member Add

Adds device interface GUIDs to an existing InfiniBand PKey partition on UFM and records the matching `OverlayAssignment` rows in Nautobot. Members can be specified by Nautobot interface or by raw IB GUID.

For details on adding members to a Partition Key, see the [InfiniBand PKey Member Add](/switch-infrastructure/config-manager/user-guides/infini-band-p-key-lifecycle/ib-p-key-member-add) user guide.

Members already attached to the PKey are not re-added. The workflow is additive — it never removes existing members.

## User Interface

### Form Inputs

| Field               | Description                                                         | Required                                  |
| :------------------ | :------------------------------------------------------------------ | :---------------------------------------- |
| **UFM Host**        | Nautobot device name of the UFM server that owns the PKey           | Yes                                       |
| **PKey**            | Partition key the members are joining (`0x` + 1-4 hex digits)       | Yes                                       |
| **Membership Type** | `full` (read/write) or `limited` (read-only). Defaults to `full`.   | Yes                                       |
| **Member Source**   | `By Interfaces` for device/interface rows, `By GUIDs` for raw GUIDs | Yes                                       |
| **Interfaces**      | Device + interface name rows (one per member)                       | When **Member Source** is `By Interfaces` |
| **GUIDs**           | One `0x` + 16 hex GUID per line, or comma-separated                 | When **Member Source** is `By GUIDs`      |

![InfiniBand PKey Member Add workflow form](https://files.buildwithfern.com/config-manager.docs.buildwithfern.com/switch-infrastructure/config-manager/fb7f6fc7beddfc59750d64380a7e05168e442183627405b4a1f2e531ffea775b/_dot_dot_/assets/images/workflows/ibpkeymemberaddworkflow-form.png)

## Workflow Execution

### Execution Stages

1. Resolve site, overlay, and canonical PKey from Nautobot
2. Resolve IB GUIDs for the submitted interfaces (or validate raw GUIDs)
3. Add GUIDs to the PKey partition on UFM
4. Verify the GUIDs are present in the PKey on UFM
5. Record `OverlayAssignment` entries in Nautobot