Skip to content

metalcloud-cli storage file-shares

List file shares in a storage pool

List file shares available in a specific storage pool.

This command retrieves all file shares associated with a storage pool, showing their configuration, status, and access information. File shares are typically used for NFS or CIFS/SMB file storage. Results can be paginated using the limit and page flags.

Arguments: storage_id The numeric ID of the storage pool

Optional flags: —limit Number of records per page (default: all records) —page Page number for pagination (requires —limit)

Examples:

metalcloud storage file-shares 123

metalcloud storage file-shares 123 —limit 5

List third page with 5 file shares per page

Section titled “List third page with 5 file shares per page”

metalcloud storage file-shares 123 —limit 5 —page 3

metalcloud-cli storage file-shares storage_id [flags]
-h, --help help for file-shares
--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”