---
title: "Retrieve InfiniBand Partition"
method: GET
path: "/v2/org/{org}/nico/infiniband-partition/{infiniBandPartitionId}"
tags: ["InfiniBand Partition"]
---

# Retrieve InfiniBand Partition

`GET /v2/org/{org}/nico/infiniband-partition/{infiniBandPartitionId}`

## Request

- Base URL: `https://nico-rest-api.nico.svc.cluster.local`
- URL: `https://nico-rest-api.nico.svc.cluster.local/v2/org/{org}/nico/infiniband-partition/{infiniBandPartitionId}`
- Auth: HTTP bearer

Retrieve a specific InfiniBand Partition

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

Tenant must own the Partition.

## Query parameters

- `includeRelation` 'Site' | 'VPC' | 'Tenant'

## Response `200`

OK

- 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: Label keys must not be empty or whitespace-only. Keys and values may contain at most 255 characters and must not contain the Unicode NUL character (U+0000). Empty values are allowed.
  - `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

- `403`: Error response when user is not authorized to call an endpoint or retrieve/modify objects

## Changes

- **2026-10-15** `293dc126ab73`: 1 info
  - removed the `nico` enum value from the `source` response property for the response status `403`
- **2026-09-29** `78f3b35615a5`: 1 info
  - added the optional property `retryable` to the response with the `403` status

[Operation history](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/changes/v2/org/:org/nico/infiniband-partition/:infiniBandPartitionId/get.md)

---

[API](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api.md) - [All operations](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/revisions/db15b7308121?raw)