Sign in
DPU Machine

Retrieve all DPU Machines

Retrieve all DPU Machines for a Site in deterministic DPU Machine ID order.

DPU network configuration is not included when listing DPU Machines, please fetch the DPU Machine by ID to get the network configuration.

User must have authorization role with PROVIDER_ADMIN suffix on the org that owns the Site.

get/v2/org/{org}/nico/dpu

Query parameters

siteIdstring uuid required

ID of the Site

pageNumberinteger

One-indexed page number.

Page number for pagination query

pageSizeinteger
Example:20

Page size for pagination query

orderBy'ID_ASC' | 'ID_DESC'

DPU Machine ID ordering

Response

OK

idstring required

ID of the DPU Machine

infrastructureProviderIdstring uuid required

ID of the Infrastructure Provider that owns the host Machine

siteIdstring uuid required

ID of the Site that the host Machine belongs to

hostMachineIdstring required

ID of the host Machine that this DPU is attached to

dpuAgentVersionstring required

Version of the DPU agent running on the DPU

labelsobject nullable required

Labels associated with the DPU

statestring required

Lifecycle state of the DPU

lastRebootedstring date-time nullable required

Last reboot timestamp

Example response

[
  {
    "bmcInfo": {
      "ip": "10.217.133.5",
      "mac": "C8:4B:D6:7A:C9:8A",
      "version": "1",
      "firmwareRevision": "6.00"
    },
    "dmiData": {
      "boardName": "7Z23CTOLWB",
      "boardSerial": ".C1KS2CS002G.",
      "boardVersion": "06",
      "biosDate": "03/30/2023",
      "biosVersion": "U8E122J-1.51",
      "productSerial": "J1050ACR",
      "chassisSerial": "J1050ACR"
    },
    "health": {
      "source": "aggregate-host-health",
      "observedAt": null,
      "successes": [
        {
          "id": "BgpDaemonEnabled",
          "target": null
        },
        {
          "id": "BgpStats",
          "target": null
        },
        {
          "id": "DhcpServer",
          "target": null
        },
        {
          "id": "DpuDiskUtilizationCheck",
          "target": null
        },
        {
          "id": "FanSpeed",
          "target": "System Board Fan1A"
        },
        {
          "id": "PowerSupply",
          "target": "PS1 Status"
        },
        {
          "id": "Temperature",
          "target": "CPU1 Temp"
        },
        {
          "id": "Temperature",
          "target": "System Board Exhaust Temp"
        },
        {
          "id": "Voltage",
          "target": "CPU1 1P8 PG"
        }
      ],
      "alerts": [
        {
          "id": "FailedValidationTest",
          "target": "DcgmFullShort",
          "inAlertSince": null,
          "message": "Failed validation test:\nName:DcgmFullShort\nCommand:dcgmi\nArgs:diag -r 2",
          "tenantMessage": null,
          "classifications": [
            "PreventAllocations"
          ]
        }
      ]
    },
    "dpuNetworkConfig": {
      "adminInterface": {
        "networkSecurityGroup": {
          "rules": [
            {
              "rule": {
                "direction": "INGRESS",
                "sourcePortRange": "80-81",
                "destinationPortRange": "80-81",
                "protocol": "TCP",
                "action": "PERMIT",
                "sourcePrefix": "10.5.44.0/24",
                "destinationPrefix": "10.5.44.0/24"
              }
            }
          ]
        }
      },
      "tenantInterfaces": [
        {
          "networkSecurityGroup": {
            "rules": [
              {
                "rule": {
                  "direction": "INGRESS",
                  "sourcePortRange": "80-81",
                  "destinationPortRange": "80-81",
                  "protocol": "TCP",
                  "action": "PERMIT",
                  "sourcePrefix": "10.5.44.0/24",
                  "destinationPrefix": "10.5.44.0/24"
                }
              }
            ]
          }
        }
      ]
    },
    "placementInRack": {
      "slotNumber": 1,
      "trayIndex": 0
    }
  }
]

Changes