stratumctl volumes

Manage block volumes

stratumctl volumes [flags]

Aliases: volume, vol

Subcommands

• stratumctl volumes attach: Attach a volume to an instance
• stratumctl volumes create: Create a volume (returns 202; poll volumes get until state=available)
• stratumctl volumes delete: Soft-delete a volume
• stratumctl volumes detach: Detach a volume from its instance
• stratumctl volumes get: Describe a volume
• stratumctl volumes list: List volumes in a project
• stratumctl volumes resize: Grow a volume online
• stratumctl volumes set-limits: Change a volume’s I/O limits (; applies at the instance’s next start)

stratumctl volumes attach

Attach a volume to an instance

stratumctl volumes attach <volume-id> [flags]

Examples

stratumctl volumes attach vol-3k8m2x7q9a --instance i-uy3ureaklq
stratumctl volumes attach vol-3k8m2x7q9a --instance i-uy3ureaklq --mode rwx

Flags

Flag	Type	Default	Description
--instance	string		Target instance ID (required)
--mode	string	rw	Attachment mode (rw | rwx)
--project	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl volumes create

Create a volume (returns 202; poll volumes get until state=available)

stratumctl volumes create <name> [flags]

Examples

stratumctl volumes create data-01 --size-gib 100
stratumctl volumes create data-02 --size-gib 500 --storage-class replicated --az lab-1a

Flags

Flag	Type	Default	Description
--az	string		Availability zone override
--description	string		Free-form description
--display-name	string		Human-friendly display name
--iops-limit	int	0	IOPS ceiling (default: the storage class default)
--project	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)
--size-gib	int64	0	Volume size in GiB (required, minimum 1)
--storage-class	string		Storage class name (default: the install’s default class)
--throughput-limit-mbps	int	0	Throughput ceiling in MB/s (default: the class default)

stratumctl volumes delete

Soft-delete a volume

stratumctl volumes delete <volume-id> [flags]

Examples

stratumctl volumes delete vol-3k8m2x7q9a

Flags

Flag	Type	Default	Description
--project	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl volumes detach

Detach a volume from its instance

stratumctl volumes detach <volume-id> [flags]

Examples

stratumctl volumes detach vol-3k8m2x7q9a

Flags

Flag	Type	Default	Description
--project	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl volumes get

Describe a volume

stratumctl volumes get <volume-id> [flags]

Examples

stratumctl volumes get vol-3k8m2x7q9a
stratumctl volumes get vol-3k8m2x7q9a --output json

Flags

Flag	Type	Default	Description
--project	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl volumes list

List volumes in a project

stratumctl volumes list [flags]

Examples

stratumctl volumes list
stratumctl volumes list --project p-team-a --output json

Flags

Flag	Type	Default	Description
--project	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl volumes resize

Grow a volume online

stratumctl volumes resize <volume-id> [flags]

Grow a volume to a larger size. The volume moves to “resizing” and the lifecycle worker grows the backend; an attached volume is grown with the instance running and the guest sees the new capacity at once. Grow the filesystem inside the guest afterwards (xfs_growfs / resize2fs). A volume never shrinks.

Examples

stratumctl volumes resize vol-3k8m2x7q9a --size-gib 200

Flags

Flag	Type	Default	Description
--project	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)
--size-gib	int64	0	New size in GiB (required; at least the current size)

stratumctl volumes set-limits

Change a volume’s I/O limits (; applies at the instance’s next start)

stratumctl volumes set-limits <volume-id> [flags]

Examples

stratumctl volumes set-limits vol-3k8m2x7q9a --iops-limit 3000 --throughput-limit-mbps 125
stratumctl volumes set-limits vol-3k8m2x7q9a --iops-limit 6000

Flags

Flag	Type	Default	Description
--iops-limit	int	0	IOPS ceiling (at most the storage class maximum)
--project	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)
--throughput-limit-mbps	int	0	Throughput ceiling in MB/s (at most the class maximum)