CLIBlock Storage
hudl volume create <name>
Create a new block storage volume.
Create a new block storage volume. You must specify at least a name and a size. Optionally create a volume from an existing image, snapshot, or another volume.
Usage
hudl volume create <name> --size <gb> [flags]Flags
| Flag | Description |
|---|---|
--size <gb> | (required) Volume size in GB (minimum 1). |
--description <text> | Human-readable description for the volume. |
--type <volume_type> | Volume type (e.g. ssd, hdd). Defaults to the region default. |
--image <image_id> | Create the volume from an existing image. |
--source <volume_id> | Clone an existing volume. |
--snapshot <snapshot_id> | Restore from a snapshot. |
--bootable | Mark the volume as bootable. |
Common flags
| Flag | Description |
|---|---|
--region <code> | Override the active region for this call only. |
--workspace <slug> | Override the active workspace for this call only. |
-o, --output | Output format: table (default), json, yaml, wide, name. |
--idempotency-key <key> | Attach an idempotency key so retries are safe. |
Examples
Create a basic 20 GB volume:
hudl volume create scratch-disk --size 20Create a 100 GB SSD volume with a description:
hudl volume create pg-data --size 100 --type ssd --description "PostgreSQL data directory"Create a bootable volume from an image:
hudl volume create boot-vol --size 30 --image img-ubuntu2404 --bootableClone an existing volume:
hudl volume create pg-data-copy --size 100 --source vol-abc123Return JSON output for scripting:
hudl volume create tmp-disk --size 10 -o jsonAPI reference
This command calls POST /volumes under the hood. See the full request and response schema in the API reference.