> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/infra-controller/_mcp/server.

# Machine

Machine is a physical server that contains CPUs, GPUs, memory, storage, and networking hardware. Machines are the physical building blocks of a Site.

Machine-scoped operations manage attached DPUs, health reports, validation runs and results, BMC and chassis resets, power, decommissioning, and status history.


## API Docs

- Inventory [Retrieve all Machines](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/get-all-machine.md)
- Inventory [Retrieve Machine label keys](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/get-all-machine-label-keys.md)
- Inventory [Retrieve Machine label values](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/get-all-machine-label-values.md)
- Inventory [Retrieve a Machine](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/get-machine.md)
- Inventory [Update Machine](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/update-machine.md)
- Inventory [Delete a Machine from a Site](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/delete-machine.md)
- Inventory [Retrieve all Machine Capabilities](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/get-all-machine-capabilities.md)
- Power and Lifecycle [Machine power control](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/power-control-machine.md)
- Power and Lifecycle [Reset Machine BMC](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/reset-machine-bmc.md)
- Power and Lifecycle [Reset Machine Chassis](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/reset-machine-chassis.md)
- Power and Lifecycle [Decommission a Machine](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/decommission-machine.md)
- DPU [Retrieve DPU Machines attached to a host Machine](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/get-dpu-machines.md)
- DPU [Reprovision Machine DPUs](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/reprovision-machine-dpu.md)
- Health and Status [Retrieve all Machine health reports](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/get-all-machine-health-report.md)
- Health and Status [Create or update Machine health report](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/create-or-update-machine-health-report.md)
- Health and Status [Delete Machine health report](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/delete-machine-health-report.md)
- Health and Status [Retrieve Machine status history](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/get-machine-status-history.md)
- Validation [Retrieve Machine validation runs](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/get-all-machine-validation-runs.md)
- Validation [Create an on-demand Machine validation run](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/start-machine-validation.md)
- Validation [Retrieve Machine validation results](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/get-all-machine-validation-results.md)
- Statistics [Retrieve GPU stats for machines at a site](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/get-machine-gpu-stats.md)
- Statistics [Retrieve machine instance type assignment summary for a site](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/get-machine-instance-type-stats-summary.md)
- Statistics [Retrieve detailed per-instance-type machine stats for a site](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/machine/get-machine-instance-type-stats.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.nvidia.com/infra-controller/openapi.json)
- [OpenAPI YAML](https://docs.nvidia.com/infra-controller/openapi.yaml)