> 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 Creation

Provisions a new InfiniBand Partition Key (PKey) on UFM and records it in Nautobot. The PKey is the IB fabric's per-tenant isolation primitive. Members are attached separately through the [IB PKey Member Add](/switch-infrastructure/config-manager/services/temporal/workflows/ib-pkey-member-add) workflow.

For details on Partition Key creation, see the [InfiniBand PKey Creation](/switch-infrastructure/config-manager/user-guides/infini-band-p-key-lifecycle/ib-p-key-creation) user guide.

The workflow is idempotent on the canonical PKey value. Re-running with the same PKey returns the existing record rather than allocating a duplicate.

## User Interface

### Form Inputs

| Field        | Description                                                                                                  | Required |
| :----------- | :----------------------------------------------------------------------------------------------------------- | :------- |
| **UFM Host** | Nautobot device name of the UFM server that will own the PKey                                                | Yes      |
| **PKey**     | Specific partition key to allocate (`0x` + 1-4 hex digits). Leave blank to auto-assign in `[0x0001, 0x7FFE]` | No       |

![InfiniBand PKey Creation workflow form](https://files.buildwithfern.com/config-manager.docs.buildwithfern.com/switch-infrastructure/config-manager/077dea140c573abb1c7bfeec533790d6a7b3321c4b7ea88e058dc638a4684ccb/_dot_dot_/assets/images/workflows/ibpkeycreationworkflow-form.png)

## Workflow Execution

### Execution Stages

1. Resolve site from host via Nautobot
2. Validate PKey availability on UFM
3. Create PKey partition on UFM
4. Verify the PKey was propagated by the SM
5. Record the PKey in Nautobot