This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

List volumes

1 - 1.2

scpcli virtualserver volume list
[--with_count <value>]
[--limit <value>]
[--marker <value>]
[--sort <value>]
[--offset <value>]
[--name <value>]
[--state <value>]
[--bootable <value>]
[--long]

Description

List volumes.

State ACTIVE (CURRENT)

VersionNot Before
1.2-

Parameters

NameTypeDescriptionExample
with_count
optional
booleanWhether to show countTrue
limit
optional
integerPage size of items. Max value is 1000.20
marker
optional
stringThe last item's ID from previous request2a9be312-5d4b-4bc8-b2ae-35100fa9241f
sort
optional
stringComma-separated list of sort keys and optional sort directions in the form of [:]created_at:desc
offset
optional
integerIndex of where to start in the list0
name
optional
stringVolume namevolume01
state
optional
stringVolume stateavailable
bootable
optional
booleanBootableFalse

Responses

NameDescriptionExample
idVolume ID3f500f00-ed80-4566-a057-e31760226f9a
bootableBootableFalse
created_atCreated at
encryptedEncrypted
Requires --long option
True
max_iopsThe number of distinct read or write operations a volume can process in a single second.
Requires --long option
10000
max_throughputThe actual amount of data (volume) transferred to or from the storage device per second.
Requires --long option
500
modified_atModified at
Requires --long option
2025-07-26T12:00:00Z
multiattachConnect to two or more servers, no restriction on the number of connected servers per volume, and Virtual Server can connect up to 26 volumes.
Requires --long option
False
nameVolume namevolume01
serversAttached servers
Requires --long option
sizeVolume size104
snapshot_idSnapshot ID
Requires --long option
cceed636-1f1e-4bb0-b85c-4e5b9e0bf790
stateVolume stateavailable
user_idUser ID
Requires --long option
570907805e5447be84b618450ef52o0t
volume_image_metadataVolume Image metadata
Requires --long option
volume_typeVolume typeSSD
volume_type_idVolume type ID
Requires --long option
c643ac35-3aec-43e6-b97a-3d6f666c5207

2 - 1.1

scpcli virtualserver volume list
[--with_count <value>]
[--limit <value>]
[--marker <value>]
[--sort <value>]
[--offset <value>]
[--name <value>]
[--state <value>]
[--bootable <value>]
[--long]

Description

List volumes.

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

VersionNot Before
1.120260531

Parameters

NameTypeDescriptionExample
with_count
optional
booleanWhether to show countTrue
limit
optional
integerPage size of items. Max value is 1000.20
marker
optional
stringThe last item's ID from previous request2a9be312-5d4b-4bc8-b2ae-35100fa9241f
sort
optional
stringComma-separated list of sort keys and optional sort directions in the form of [:]created_at:desc
offset
optional
integerIndex of where to start in the list0
name
optional
stringVolume namevolume01
state
optional
stringVolume stateavailable
bootable
optional
booleanBootableFalse

Responses

NameDescriptionExample
idVolume ID3f500f00-ed80-4566-a057-e31760226f9a
bootableBootableFalse
created_atCreated at
encryptedEncrypted
Requires --long option
True
modified_atModified at
Requires --long option
2025-07-26T12:00:00Z
multiattachConnect to two or more servers, no restriction on the number of connected servers per volume, and Virtual Server can connect up to 26 volumes.
Requires --long option
False
nameVolume namevolume01
serversAttached servers
Requires --long option
sizeVolume size104
snapshot_idSnapshot ID
Requires --long option
cceed636-1f1e-4bb0-b85c-4e5b9e0bf790
stateVolume stateavailable
user_idUser ID
Requires --long option
570907805e5447be84b618450ef52o0t
volume_image_metadataVolume Image metadata
Requires --long option
volume_typeVolume typeSSD
volume_type_idVolume type ID
Requires --long option
c643ac35-3aec-43e6-b97a-3d6f666c5207

3 - 1.0

scpcli virtualserver volume list
[--with_count <value>]
[--limit <value>]
[--marker <value>]
[--sort <value>]
[--offset <value>]
[--name <value>]
[--state <value>]
[--bootable <value>]
[--long]

Description

List volumes.

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

VersionNot Before
1.020251231

Parameters

NameTypeDescriptionExample
with_count
optional
booleanWhether to show countTrue
limit
optional
integerPage size of items. Max value is 1000.20
marker
optional
stringThe last item's ID from previous request2a9be312-5d4b-4bc8-b2ae-35100fa9241f
sort
optional
stringComma-separated list of sort keys and optional sort directions in the form of [:]created_at:desc
offset
optional
integerIndex of where to start in the list0
name
optional
stringVolume namevolume01
state
optional
stringVolume stateavailable
bootable
optional
booleanBootableFalse

Responses

NameDescriptionExample
idVolume ID3f500f00-ed80-4566-a057-e31760226f9a
bootableBootableFalse
created_atCreated at
encryptedEncrypted
Requires --long option
True
modified_atModified at
Requires --long option
2025-07-26T12:00:00Z
multiattachConnect to two or more servers, no restriction on the number of connected servers per volume, and Virtual Server can connect up to 26 volumes.
Requires --long option
False
nameVolume namevolume01
serversAttached servers
Requires --long option
sizeVolume size104
snapshot_idSnapshot ID
Requires --long option
cceed636-1f1e-4bb0-b85c-4e5b9e0bf790
stateVolume stateavailable
user_idUser ID
Requires --long option
570907805e5447be84b618450ef52o0t
volume_image_metadataVolume Image metadata
Requires --long option
volume_typeVolume typeSSD
volume_type_idVolume type ID
Requires --long option
c643ac35-3aec-43e6-b97a-3d6f666c5207