---
title: "Get status of an IB device"
method: GET
path: "/ibdevices"
---

# Get status of an IB device

`GET /ibdevices`

Retrieves the current programming status of the specified IB device.

## Query parameters

- `ibmac` string, required

## Response `200`

The request was successful and the status of the IB device is returned.

- GetIBDeviceStatusResponse
  - `IBMACAddress` string, required — MAC address of the IB device
  - `PodNamespace` string, required — namespace of the pod to which the device is assigned, if any
  - `PodName` string, required — name of the pod to which the device is assigned, if any
  - `Status` 'Unprogrammed' | 'Programming' | 'Programmed' | 'Unprogramming' | 'Failed', required — Status of IB device
  - `Message` string, required — Human-readable message or error description

## Other responses

- `404` — The IB device specified by MAC address was not found.

---

[API](https://skmtc.net/azure/apis/container-networking-service-cns.md) · [All operations](https://skmtc.net/azure/apis/container-networking-service-cns/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/container-networking-service-cns/revisions/b4493fe6b8c8/schema)