origin storage commands

This page lists every origin storage command. Attaching a volume to an instance is an origin compute command; see attach-volume.

create-volume

Create a volume, empty or from a snapshot.

terminal

origin storage create-volume [OPTIONS] --project-urn <PROJECT_URN>

Option	Required	Description
`--project-urn <PROJECT_URN>`	yes	URN of the project.
`--size <SIZE>`	no	Size in GiB [default: 8].
`--snapshot-urn <SNAPSHOT_URN>`	no	URN of the backing Snapshot.
`--storage-class <STORAGE_CLASS>`	no	Storage class (performance tier). Omitted uses the platform default. Discover the choices with `list-storage-classes`

List every published storage class (performance tier), with display name, backing media, which one is the default and its available flag. Only a class with available: true can be passed to --storage-class.

terminal

origin storage list-storage-classes

This command takes no options.

list-volumes

List the volumes of a project.

terminal

origin storage list-volumes --project-urn <PROJECT_URN>

Option	Required	Description
`--project-urn <PROJECT_URN>`	yes	URN of the project.

get-volume

Get one volume.

terminal

origin storage get-volume --volume-urn <VOLUME_URN>

Option	Required	Description
`--volume-urn <VOLUME_URN>`	yes	URN of the Volume.

import-volume

Create a volume whose initial content is a disk image downloaded from an HTTP(S) URL.

terminal

origin storage import-volume [OPTIONS] --project-urn <PROJECT_URN> --size-in-gib <SIZE_IN_GIB> --source-url <SOURCE_URL>

Option	Required	Description
`--project-urn <PROJECT_URN>`	yes	URN of the project.
`--size-in-gib <SIZE_IN_GIB>`	yes	Size in GiB - must be large enough to hold the source image.
`--source-url <SOURCE_URL>`	yes	HTTP(S) URL the source image is downloaded from. It must be reachable from the internet.
`--storage-class <STORAGE_CLASS>`	no	Storage class (performance tier). Omitted uses the platform default. Discover the choices with `list-storage-classes`

delete-volume

Delete a volume. Refused while it is attached or has snapshots.

terminal

origin storage delete-volume --volume-urn <VOLUME_URN>

Option	Required	Description
`--volume-urn <VOLUME_URN>`	yes	URN of the Volume.

resize-volume

Grow a volume. Volumes only grow.

terminal

origin storage resize-volume --volume-urn <VOLUME_URN> --size-in-gib <SIZE_IN_GIB>

Option	Required	Description
`--volume-urn <VOLUME_URN>`	yes	URN of the Volume.
`--size-in-gib <SIZE_IN_GIB>`	yes	New size in GiB.

create-snapshot

Take a snapshot of a volume.

terminal

origin storage create-snapshot --volume-urn <VOLUME_URN>

Option	Required	Description
`--volume-urn <VOLUME_URN>`	yes	URN of the Volume.

protect-snapshot

Protect a snapshot so it can be used as a clone source.

terminal

origin storage protect-snapshot --snapshot-urn <SNAPSHOT_URN>

Option	Required	Description
`--snapshot-urn <SNAPSHOT_URN>`	yes	URN of the Snapshot.

unprotect-snapshot

Remove a snapshot’s protection so it can be deleted.

terminal

origin storage unprotect-snapshot --snapshot-urn <SNAPSHOT_URN>

Option	Required	Description
`--snapshot-urn <SNAPSHOT_URN>`	yes	URN of the Snapshot.

delete-snapshot

Delete a snapshot. It must be unprotected first.

terminal

origin storage delete-snapshot --snapshot-urn <SNAPSHOT_URN>

Option	Required	Description
`--snapshot-urn <SNAPSHOT_URN>`	yes	URN of the Snapshot.

list-snapshots

List the snapshots of a project.

terminal

origin storage list-snapshots --project-urn <PROJECT_URN>

Option	Required	Description
`--project-urn <PROJECT_URN>`	yes	URN of the project.

get-snapshot

Get one snapshot.

terminal

origin storage get-snapshot --snapshot-urn <SNAPSHOT_URN>

Option	Required	Description
`--snapshot-urn <SNAPSHOT_URN>`	yes	URN of the Snapshot.