Skip to content

metalcloud-cli vm-pool cluster-hosts

List cluster hosts in a VM pool with pagination

List all cluster hosts (ESXi hosts, Hyper-V servers, etc.) in a specific VM pool with optional pagination.

This command displays the hypervisor hosts that are part of the specified VM pool, including their status, resource utilization, and connection 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:

metalcloud-cli vm-pool cluster-hosts 123

metalcloud-cli vm-pool cluster-hosts 123 —limit 5

metalcloud-cli vm-pool cluster-hosts 123 —limit 5 —page 2

metalcloud-cli vm-pool cluster-hosts vm_pool_id [flags]
-h, --help help for cluster-hosts
--limit string Number of records per page
--page string Page number
-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")

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

Section titled “Auto generated by spf13/cobra on 11-Aug-2025”