Block Storage examples¶
Before you start using examples, be sure to enter your username and API key and store them locally by running the rack configure
command. For more information, see Installation and configuration.
You can get help for any command and its options by adding --help
to the series of commands:
$ rack block-storage snapshot create --help
Create a volume¶
Create a volume by using the rack block-storage volume create --size
command and specifying the size and name for the volume. In the following example, a volume named Store
is created.
$ rack block-storage volume create --size 75 --name Store
ID 81c7a7e5-01a5-44bb-9b43-0cc9f7c4e423
Name
Description
Size 75
VolumeType SATA
SnapshotID
Attachments []
CreatedAt 2015-07-31T17:49:41.752349
You can also attach the new volume to a server by using the volume-id
flag. In the following example, the newly created volume is attached to a server named RACK
.
$ rack servers volume-attachment create --server-name RACK --volume-id 81c7a7e5-01a5-44bb-9b43-0cc9f7c4e423
ID 81c7a7e5-01a5-44bb-9b43-0cc9f7c4e423
Device /dev/vvdc
VolumeID81c7a7e5-01a5-44bb-9b43-0cc9f7c4e423
ServerID8a254ea3-77b5-4f74-a893-8d2d51ae2cca
Create a snapshot¶
Create a snapshot by detaching the volume from its server. You use the volume's attachment ID, which you can find by using the following command.
$ rack servers volume-attachment list --server-name RACK
ID Device VolumeID ServerID
81c7a7e5-01a5-44bb-9b43-0cc9f7c4e423 /dev/xvdc 81c7a7e5-01a5-44bb-9b43-0cc9f7c4e423 8a254ea3-77b5-4f74-a893-8d2d51ae2cca
Use the following command, followed by the server name and the attachment ID, to detach the volume from the server.
$ rack servers volume-attachment delete --server-name RACK --id 81c7a7e5-01a5-44bb-9b43-0cc9f7c4e423
After the volume is detached, you can create a snapshot by using the following command and specifying the ID of the volume and a name for the snapshot. In the following example, a snapshot called Store1
is created.
$ rack block-storage snapshot create --volume-id 81c7a7e5-01a5-44bb-9b43-0cc9f7c4e423
ID 180a6c5c-ad6d-4cb6-846f-d500d67e59a5
Name Store1
Description
Size 75
VolumeType
SnapshotID
Attachments
CreatedAt 2015-07-31T18:57:34.652136