---
title: "Create InfiniBand Partition"
method: POST
path: "/v2/org/{org}/nico/infiniband-partition"
tags: ["InfiniBand Partition"]
---

# Create InfiniBand Partition

`POST /v2/org/{org}/nico/infiniband-partition`

Create an InfiniBand Partition for the org.

Org must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.

## Request body

- InfiniBandPartitionCreateRequest — Request data to create an InfiniBand Partition
  - `name` string, required — Name of the Partition to create
  - `description` string, nullable — Optional description of the Partition
  - `siteId` string, uuid, required — ID of the Site the Partition should belong to
  - `labels` Labels

## Response `201`

Created

- InfiniBandPartition — InfiniBand Partitions are network segments utilizing InfiniBand topology
  - `id` string, uuid — Unique UUID v4 identifier for the InfiniBand Partition
  - `name` string — Name of the InfiniBand Partition
  - `description` string, nullable — Description of the InfiniBand Partition
  - `siteId` string, uuid — ID of the Site
  - `tenantId` string, uuid — ID of the Tenant
  - `controllerIBPartitionId` string, uuid, nullable — ID of the Site Controller InfiniBand partition corresponding to this InfiniBand Partition
  - `partitionKey` string, nullable — Partition key assigned to the InfiniBand Partition
  - `partitionName` string, nullable — Partition name assigned to the InfiniBand Partition
  - `serviceLevel` integer, nullable — Service level configured for the InfiniBand Partition
  - `rateLimit` 2 | 5 | 10 | 14 | 20 | 25 | 30 | 40 | 56 | 60 | 80 | 100 | 112 | 120 | 168 | 200 | 300, nullable — Rate limit configured for the InfiniBand Partition
  - `mtu` 4000 | 8000, nullable — MTU configured for the InfiniBand Partition
  - `enableSharp` boolean — Whether SHARP is enabled for the InfiniBand Partition
  - `labels` Labels
  - `status` 'Pending' | 'Provisioning' | 'Ready' | 'Configuring' | 'Deleting' | 'Error' — Status values for InfiniBand Partition objects
  - `statusHistory` StatusDetail[] — Chronological status history for the InfiniBand Partition
    - `status` string — State of the associated entity at a particular time
    - `message` string, nullable — Description of the state and cause/remedy in case of error
    - `created` string, date-time — Date/time when the associated entity assumed the status
    - `updated` string, date-time — Date/time when the associated entity was last observed with this status
  - `created` string, date-time — Date/time when the InfiniBand Partition was created
  - `updated` string, date-time — Date/time when the InfiniBand Partition was last updated

## Other responses

- `400` — Error response when request data cannot be validated
- `403` — Error response when user is not authorized to call an endpoint or retrieve/modify objects

---

[API](https://skmtc.net/nvidia/apis/nvidia-infra-controller-rest-api.md) · [All operations](https://skmtc.net/nvidia/apis/nvidia-infra-controller-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nvidia/nvidia-infra-controller-rest-api/versions/69e00804e732/schema)