Skip to content

metalcloud-cli file-share update-hosts

Update hosts configuration for a file share

Update the hosts configuration for an existing file share.

This command allows you to modify which hosts have access to the file share and their mount configurations. You can add new hosts, remove existing ones, or update their access permissions and mount settings.

Required Arguments: infrastructure_id_or_label The infrastructure ID (numeric) or label containing the file share file_share_id The ID of the file share to update hosts for

Required Flags: —config-source Source of the file share hosts configuration Can be ‘pipe’ for stdin input or path to a JSON file

Hosts Configuration Format: The configuration should be a JSON object containing the hosts configuration:

  • hosts: Array of host objects with their access settings
  • mount_path: Default mount path for hosts
  • access_permissions: Default access permissions (read, write, read-write)

Examples:

Update hosts configuration from a JSON file

Section titled “Update hosts configuration from a JSON file”

metalcloud-cli file-share update-hosts my-infrastructure 12345 —config-source hosts.json

echo ’{“hosts”:[{“id”:“host1”,“access”:“read-write”}]}’ | metalcloud-cli file-share update-hosts my-infrastructure 12345 —config-source pipe

metalcloud-cli file-share update-hosts 100 12345 —config-source /path/to/hosts.json

metalcloud-cli file-share update-hosts infrastructure_id_or_label file_share_id [flags]
--config-source string Source of the file share hosts configuration. Can be 'pipe' or path to a JSON file.
-h, --help help for update-hosts
-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”