CH·02CLI reference

gpu community machines delist

Remove a machine you own from Community Cloud supply

Remove a machine you own from Community Cloud supply

Synopsis

Removes a machine you own from Community Cloud supply. Delisting stops new provisions to the machine immediately, so it stops being matched to customers.

It is drain-not-kill: if a rental is in flight when you delist, that rental is never terminated. The machine becomes draining and the customer's instance keeps running until it ends naturally. An idle machine is delisted right away.

gpu community machines delist <machine-id>

Examples

# Delist an idle machine (returns status "delisted")
gpu community machines delist mach-9

# Delist a machine with an in-flight rental (returns status "draining")
gpu community machines delist mach-9 --output json

Options

  -h, --help   help for delist

Options inherited from parent commands

      --api-base string   API base URL (override with GPUAI_API_BASE env) (default "https://api.gpu.ai/v1")
      --debug             Enable debug logging to stderr
  -o, --output string     Output format: table|json (default table on TTY, json otherwise)

SEE ALSO

← The gpu CLI