Sign in

v57

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-08-012143051018.3 KB
InfiniBand Partition

Retrieve all InfiniBand Interfaces

Get all InfiniBand Interfaces

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

get/v2/org/{org}/nico/infiniband-interface

Query parameters

siteIdstring

Filter InfiniBand Interfaces by Site ID. Can be specified multiple times to filter on more than one ID.

instanceIdstring

Filter InfiniBand Interfaces by Instance ID. Can be specified multiple times to filter on more than one ID.

infinibandPartitionIdstring

Filter InfiniBand Interfaces by InfiniBand Partition ID. Can be specified multiple times to filter on more than one ID.

statusstring

Filter InfiniBand Interfaces by Status. Can be specified multiple times to filter on more than one status.

includeRelation'Instance' | 'InfiniBandPartition' | 'Site'

Related entity to expand

pageNumberinteger
Example:1

Page number for pagination query

pageSizeinteger
Example:20

Page size for pagination query

orderBy'STATUS_ASC' | 'STATUS_DESC' | 'CREATED_ASC' | 'CREATED_DESC' | 'UPDATED_ASC' | 'UPDATED_DESC'

Ordering for pagination query

Response

OK

idstring uuid

Unique UUID v4 identifier for the InfiniBandInterface

instanceIdstring uuid

ID of the associated Instance

partitionIdstring uuid

ID of the InfiniBand Partition associated with this interface

devicestring

Name of the InfiniBand device associated with this interface

vendorstring nullable

Name of the InfiniBand device vendor associated with this interface

deviceInstanceinteger

Index of the device where partition attach to

isPhysicalboolean

Indicates whether this is a physical interface

virtualFunctionIdinteger nullable

Must be specified if isPhysical is false

guidstring nullable

Must be specified if isPhysical is false

status'Pending' | 'Provisioning' | 'Ready' | 'Deleting' | 'Error'

Status values for InfiniBand Interface objects

createdstring date-time

Date/time when the InfiniBandInterface was created

updatedstring date-time

Date/time when the InfiniBandInterface was last updated

Example response

[
  {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "instanceId": "64d2028c-ae87-4069-a624-66089d957ef9",
    "partitionId": "05ef7e84-1d4e-4e4d-980d-38589479a0fe",
    "device": "MT2910 Family [ConnectX-7]",
    "deviceInstance": 0,
    "isPhysical": true,
    "virtualFunctionId": null,
    "guid": "946dae0300339498",
    "status": "Ready",
    "created": "2019-08-24T14:15:22Z",
    "updated": "2019-08-24T14:15:22Z"
  }
]