metalcloud-cli vm-pool vms

List virtual machines in a VM pool with pagination

Synopsis

List all virtual machines present in a specific VM pool with optional pagination.

This command displays VMs that are currently managed by the specified VM pool, including their status, resource allocation, and basic configuration details.

ARGUMENTS: vm_pool_id The numeric ID of the VM pool

OPTIONAL FLAGS: –limit Number of records to return per page (default: all) –page Page number to retrieve (1-based, default: 1) Only effective when –limit is specified

PAGINATION: When using pagination, specify both –limit and –page for best results. The –limit flag controls how many records are returned, while –page specifies which page of results to retrieve.

EXAMPLES:

List all VMs in VM pool 123

metalcloud-cli vm-pool vms 123

List first 10 VMs

metalcloud-cli vm-pool vms 123 –limit 10

List second page of 10 VMs each

metalcloud-cli vm-pool vms 123 –limit 10 –page 2

metalcloud-cli vm-pool vms vm_pool_id [flags]

Options

  -h, --help           help for vms
      --limit string   Number of records per page
      --page string    Page number

Options inherited from parent commands

  -k, --api_key string         MetalCloud API key
  -c, --config string          Config file path
  -d, --debug                  Set to enable debug logging
  -e, --endpoint string        MetalCloud API endpoint
  -f, --format string          Output format. Supported values are 'text','csv','md','json','yaml'. (default "text")
  -i, --insecure_skip_verify   Set to allow insecure transport
  -l, --log_file string        Log file path
  -v, --verbosity string       Log level verbosity (default "INFO")

SEE ALSO

Auto generated by spf13/cobra on 11-Aug-2025