---
title: node-device
description: Canonical makes open source secure, reliable and easy to use, providing
  support for Ubuntu and a portfolio of enterprise-grade technologies. Founded in
  2004, Canonical operates globally with team members in over 80 countries.
url: https://canonical-com-2934.demos.haus/maas/docs/node-device?format=md
---

*Submit*

# node-device

Enter keyword arguments in the form `key=value`.

## [Return node devices](https://canonical-com-2934.demos.haus/maas/docs/node-device?format=md#p-23307-return-node-devices)

```
maas $PROFILE node-devices read [--help] [-d] [-k] system_id [data ...]
```

#### Positional arguments

* system\_id

Return a list of devices attached to the node given by a system\_id.

#### Keyword “bus”

Optional String. Only return devices attached to the specified bus. Can be PCIE or USB. Defaults to all.

#### Keyword “hardware\_type”

Optional String. Only return scripts for the given hardware type. Can be `node`, `cpu`, `memory`, `storage` or `gpu`. Defaults to all.

#### Keyword “vendor\_id”

Optional String. Only return devices which have the specified vendor id.

#### Keyword “product\_id”

Optional String. Only return devices which have the specified product id.

#### Keyword “vendor\_name”

Optional String. Only return devices which have the specified vendor\_name.

#### Keyword “product\_name”

Optional String. Only return devices which have the specified product\_name.

#### Keyword “commissioning\_driver”

Optional String. Only return devices which use the specified driver when commissioning.

#### Command-line options

| Option | Effect |
| --- | --- |
| –help, -h | Show this help message and exit. |
| -d, --debug | Display more information about API responses. |
| -k, --insecure | Disable SSL certificate check |

---

[Previous

node](https://canonical-com-2934.demos.haus/maas/docs/node)
[Next

node-result](https://canonical-com-2934.demos.haus/maas/docs/node-result)

Last updated 1 year, 4 months ago. [Help improve this document in the forum](https://discourse.maas.io/t/node-device/11410).
