Sign in
DPU Machine

Retrieve a DPU Machine

Retrieve a DPU Machine by ID. By default, DPU network configuration is not included. Set includeNetworkConfig query parameter to true to retrieve the network configuration fields.

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

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

Query parameters

siteIdstring uuid required

ID of the Site

includeNetworkConfigboolean

Include network configuration fields exposed by the REST API

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

Changed in 1 of the 90 revisions of this API.1