---
title: "CLI — Catalog, quotas & audit"
description: "Datacenters, capacity, pricing quotes, quota usage, and audit events with the Metalhost CLI."
url: "https://metalhost.net/docs/developers/guides/cli-catalog"
---

# CLI — Catalog, quotas & audit

Discover regions, check capacity, quote prices, inspect quota headroom, and search audit history before provisioning.

## Catalog

| Command | What it does |
| --- | --- |
| `catalog datacenter list` | List datacenters + live capacity summary. |
| `catalog datacenter health NAME` | Health summary for one DC. |
| `catalog datacenter maintenance` | Active maintenance windows. |
| `catalog capacity --datacenter DC` | vCPU / RAM / GPU availability. |
| `catalog pricing quote ...` | Live price for a VM shape. |

```
metalhost catalog datacenter list
metalhost catalog capacity --datacenter datacenters/us-dal-1
metalhost catalog pricing quote \
  --vcpus 4 --ram-gib 16 --cpu-class cascadelake --boot-disk-gib 80 \
  --public-ipv4-count 1
```

The pricing command quotes CPU, RAM, disks, and public IPv4. It does not currently expose the API's GPU quote fields; use the Go SDK or HTTP API when a GPU quote is required.

## Quota

`metalhost quota` — current usage vs limits for the active project's organization (VMs, disks, snapshots, public IPs, networks, etc.).

```
metalhost quota --project projects/my-app -o json
```

To raise limits, open a support ticket — see [CLI → Support](https://metalhost.net/docs/developers/guides/cli-support.md).

## Audit

| Command | What it does |
| --- | --- |
| `audit search` | Search audit events (alias `audit list`). |

```
metalhost audit search --project projects/my-app --since 24h
metalhost audit search --action-prefix compute.vm --principal-prefix users/alice
```

## What's next

- [Go SDK — Catalog & quotas](https://metalhost.net/docs/developers/guides/sdk-catalog.md)
- [Examples → discover](https://metalhost.net/docs/developers/examples.md#discover)
- [Dashboard → Billing limits](https://metalhost.net/docs/dashboard/guides/billing.md)