Skip to content

metalcloud-cli bucket create

Create a new bucket with specified configuration

Create a new bucket within the specified infrastructure using provided configuration.

This command creates a new bucket with the configuration specified through either a JSON file or piped input. The configuration must include all required bucket parameters such as name, region, and any specific bucket settings.

Required Arguments: infrastructure_id_or_label The ID or label of the infrastructure where the bucket will be created

Required Flags: —config-source string Source of the new bucket configuration Accepts either ‘pipe’ for piped JSON input or a path to a JSON file

Examples:

Create bucket using configuration from a JSON file

Section titled “Create bucket using configuration from a JSON file”

metalcloud-cli bucket create 100 —config-source bucket-config.json

echo ’{“name”: “my-bucket”, “region”: “us-east-1”}’ | metalcloud-cli bucket create production —config-source pipe

Create bucket with configuration file in different directory

Section titled “Create bucket with configuration file in different directory”

metalcloud-cli bucket create staging —config-source /path/to/configs/bucket.json

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