Defines storage as either a volume or a snapshot and lists the available operations for managing it.
Volumes and snapshots are the two types of storage devices that are managed by a cloud user.
The APIs and CLI provide operations for:
Use either the cloud infrastructure API actions or the cloud infrastructure CLI command to perform these operations.
Describes the purpose of a volume and its snapshots.
The virtual block storage devices are called volumes. Volumes are serially shareable and can be attached to or detached from a vServer.
A snapshot captures the current state of a volume. Snapshots are immutable. The snapshot exists independently of the volume.
Snapshot creation and management is available if it is supported by the storage of the vDC.
Creating a snapshot serves two purposes:
Backup of data stored on a volume
Creation of new volumes from a snapshot
Lists the API action and CLI command for creating a volume.
A cloud user can create a shared or non-shared empty volume with a given size. A cloud user can also create a shared or non-shared volume from a snapshot. The new volume can be attached to vServers. Shared volumes can be attached to more than one vServer.
| Cloud Infrastructure API Action | Cloud Infrastructure CLI Command |
|---|---|
Example 3-39 Creating a volume using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=CreateVolume&Version=1&Timestamp=1318462897126&Expires=1318463197126&name=myVol2&size=1&AccessKeyId=AK_2&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST&SignatureMethod=SHA512withRSA&SignatureVersion=1
Example 3-40 Creating a volume using the Cloud Infrastructure CLI
iaas-create-volume --base-url https://<EnterpriseControllerHostname>/ --access-key-file ak.file --name firstVol --size 2
Lists the API action and CLI command for deleting a volume.
A cloud user can delete a volume. Only volumes that are not currently attached to a vServer can be deleted. The process of deleting a volume does not affect any snapshot that has been created previously based on that volume.
| Cloud Infrastructure API Action | Cloud Infrastructure CLI Command |
|---|---|
Example 3-41 Deleting a volume using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=DeleteVolume&Version=1&Timestamp=1318463692509&Expires=1318463992509&volumeId=VOL-3bbc8f1c-bb4c-4a70-a370-4b6c06d990dc&AccessKeyId=AK_2&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST&SignatureMethod=SHA512withRSA&SignatureVersion=1
Example 3-42 Deleting a volume using the Cloud Infrastructure CLI
iaas-delete-volume --base-url https://<EnterpriseControllerHostname>/ -a ak.file --volume-id VOL-82b4661e-de12-4931-b9a4-cce8edd23532
Lists the API action and CLI command for displaying a volume.
A cloud user can get information about the existing volumes in an account. The cloud user can restrict the volumes included in the result by specifying filters. The result includes volumes in all states and has additional information for each volume.
The attributes displayed for each volume are:
ID
Name
Description
Status
Shared
vServers
| Cloud Infrastructure API Action | Cloud Infrastructure CLI Command |
|---|---|
Example 3-43 Viewing volume information using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=DescribeVolumes&Version=1&Timestamp=1318463287921&Expires=1318463587921&AccessKeyId=AK_2&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST&SignatureMethod=SHA512withRSA&SignatureVersion=1
Example 3-44 Viewing volume information using the Cloud Infrastructure CLI
iaas-describe-volumes --base-url https://<EnterpriseControllerHostname>/ -a ak.file -H
Lists the API action and CLI command for attaching a volume to a vServer.
A cloud user can attach volumes to an existing vServer. A cloud user might also attach volumes to a vServer during the vServer creation process. The volume attached is available as a device in the vServer. Depending on the virtualization type of the virtual datacenter, the cloud user might need to stop the vServer before attaching a volume.
| Cloud Infrastructure API Action | Cloud Infrastructure CLI Command |
|---|---|
Example 3-45 Attaching a volume to a vServer using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=AttachVolumesToVserver&Version=1&Timestamp=1321384886152&Expires=1321385186152&volumeIds.1=VOL-052cb4b4-5e56-4303-8b3a-82d6ba743a15&vserverId=VSRV-8ae29df9-ccfe-4184-acb8-10080665d7f6&AccessKeyId=AK_1&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST&SignatureMethod=SHA512withRSA&SignatureVersion=1
Example 3-46 Attaching a volume to a vServer using the Cloud Infrastructure CLI
iaas-attach-volumes-to-vserver --base-url https://<EnterpriseControllerHostname>/ -a ~/ak.file -vserver-id VSRV-0fb57293-347c-4717-96ef-6dd23154596f --volume-ids VOL-052cb4b4-5e56-4303-8b3a-82d6ba743a15
Lists the API action and CLI command for detaching a volume from a vServer.
A cloud user can detach a volume from a vServer. After it is detached, the volume is no longer available as a device in the vServer. Depending on the virtualization type of the vDC, cloud user might need to stop the vServer before detaching a volume.
Caution:
Before detaching a volume from a vServer, ensure that the disk being detached is not longer in use to avoid services instability or disk data corruption. Ensure that the vServer properly unmounts the device for the volume; otherwise, data loss or file system corruption might occur
| Cloud Infrastructure API Action | Cloud Infrastructure CLI Command |
|---|---|
Example 3-47 Detaching a volume to a vServer using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=DetachVolumesFromVserver&Version=1&Timestamp=1321385229679&Expires=1321385529679&volumeIds.1=VOL-052cb4b4-5e56-4303-8b3a-82d6ba743a15&force=true&vserverId=VSRV-8ae29df9-ccfe-4184-acb8-10080665d7f6&AccessKeyId=AK_1&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST&SignatureMethod=SHA512withRSA&SignatureVersion=1
Example 3-48 Detaching a volume to a vServer using the Cloud Infrastructure CLI
iaas-detach-volumes-from-vserver --base-url https://<EnterpriseControllerHostname>/ -a ~/ak.file -vserver-id VSRV-0fb57293-347c-4717-96ef-6dd23154596f --volume-ids VOL-052cb4b4-5e56-4303-8b3a-82d6ba743a15 --force
Lists the API action and CLI command for importing a volume.
A cloud user can import a volume from another location. Volumes must be contained in a file of the format .img. The volume must be accessible through a URL. The file is uploaded to the vDC, and the volume is created and stored physically. The imported volume is only accessible within the target account.
| Cloud Infrastructure API Action | Cloud Infrastructure CLI Command |
|---|---|
Example 3-49 Importing a volume using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=ImportVolume&Version=1&Timestamp=1324421943593&Expires=1324422243593&shared=true&name=myVolumeImported&url=http%3A%2F%2Fexample.com%2FES%2FOVM%2Fvolume%2Fvolume1.img&AccessKeyId=AK_1&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST&SignatureMethod=SHA512withRSA&SignatureVersion=1
Example 3-50 Importing a volume using the Cloud Infrastructure CLI
iaas-import-volume --base-url https://<EnterpriseControllerHostname>/ -a ak.file --name myVolume --url http://example.com/volume-image/volume.img
Lists the API action and CLI command for creating a snapshot.
A cloud user can create a snapshot of a volume or a snapshot can be created as a result of uploading an assembly.
There are four types of exposed disks in an assembly's template. When snapshots are created from an assembly, three of the disk types are presented to cloud users as snapshots. This allows cloud users to create a shared volume from the snapshot. The three exposed disks are:
Public Populated: An extra disk with data already present.
Private Raw: Dynamically created as an empty disk with a size but no disk data.
Shared Raw: Dynamically created as an empty disk, with a size but no disk data.
| Cloud Infrastructure API Action | Cloud Infrastructure CLI Command |
|---|---|
Example 3-51 Creating a snapshot using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=CreateSnapshot&Version=1&Timestamp=1318466247111&Expires=1318466547111&volumeId=VOL-246b5c62-4072-41cf-885b-99d6c63583bd&name=mySnapshot&AccessKeyId=AK_2&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST&SignatureMethod=SHA512withRSA&SignatureVersion=1
Example 3-52 Creating a snapshot using the Cloud Infrastructure CLI
iaas-create-snapshot --base-url https://<EnterpriseControllerHostname>/ -a ak.file --volume-id VOL-246b5c62-4072-41cf-885b-99d6c63583bd --name mySnapshot
Lists the API action and CLI command for deleting a snapshot.
A cloud user can delete a snapshot of a volume. The deletion of a snapshot does not affect any volumes or any other snapshots.
| Cloud Infrastructure API Action | Cloud Infrastructure CLI Command |
|---|---|
Example 3-53 Deleting a snapshot using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=DeleteSnapshot&Version=1&Timestamp=1318624338550&Expires=1318624638550&snapshotId=SNAP-2f2039cd-943b-4072-9ded-e96b54b7ca79&AccessKeyId=AK_2&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST&SignatureMethod=SHA512withRSA&SignatureVersion=1
Example 3-54 Deleting a snapshot using the Cloud Infrastructure CLI
iaas-delete-snapshot --base-url https://<EnterpriseControllerHostname>/ -a ak.file --snapshot-id SNAP-d743e90c-53c5-4b01-a297-e2c944755c48
Lists the API action and CLI command for displaying a snapshot.
A cloud user can get information about the existing snapshots in an account. The cloud user can restrict the snapshots included in the result by specifying filters. The result includes a list of the snapshots found and additional information for each snapshot.
The attributes displayed for each snapshot are:
ID
Name
Description
Status
| Cloud Infrastructure API Action | Cloud Infrastructure CLI Command |
|---|---|
Example 3-55 Viewing snapshot information using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=DescribeSnapshots&Version=1&Timestamp=1318467903784&Expires=1318468203784&AccessKeyId=AK_2&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST&SignatureMethod=SHA512withRSA&SignatureVersion=1
Example 3-56 Viewing snapshot information using the Cloud Infrastructure CLI
iaas-describe-snapshots --base-url https://<EnterpriseControllerHostname>/ -a ak.file -H