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.

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
• Examples → discover
• Dashboard → Billing limits