# metalcloud-cli bucket create

Create a new bucket with specified configuration

## Synopsis

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
  metalcloud-cli bucket create 100 --config-source bucket-config.json

  ## Create bucket using piped configuration
  echo '{"name": "my-bucket", "region": "us-east-1"}' | metalcloud-cli bucket create production --config-source pipe

  ## 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]
```

### Options

```
      --config-source string   Source of the new bucket configuration. Can be 'pipe' or path to a JSON file.
  -h, --help                   help for create
```

### 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

* [metalcloud-cli bucket](/content/configuration/cli/metalcloud-cli_bucket.md)	 - Manage S3-compatible object storage buckets

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