HP 3PAR Web Service API 1.3.1 Developer's Guide

Creating a Storage Volume
This section contains information about creating storage volumes.
NOTE: Any user with Super or Edit role, or any role granted the vv_create right (for base
volumes), the vvcopy_create right (for physical copies of volumes), or the sv_create right
(for snapshots), can create a volume.
For more information about creating snapshots, see “Creating Snapshots” (page 112).
For more information about creating physical copies of volumes, see “Creating a Physical Copy
of a Volume” (page 112).
Creating Base Volumes
To create a storage volume, use the HTTP POST method in the URI:
https://<storage_system>:8080/api/v1/volumes
NOTE: The <storage_system> parameter will be replaced with the actual storage system’s
host name or IP address.
Message Body Members
The message body is a JSON object with the members shown in Table 34 (page 55).
Most of the message-body JSON object members are optional. The definition of members can be
found in the HP 3PAR Command Line Interface Reference or in the column help for the CLI command
createvv.
Table 34 Message Body JSON Objects for Base-volume Creation
DescriptionIgnored ValuesAPI TypeJSON TypeMember
Specifies a VV name up
to 31 characters in
length.
None (Required)name31stringname
Specifies the name of the
CPG from which the
None (Required)name31stringcpg
volume user space will
be allocated.
Specifies the size for the
volume in MiB. The
None (Required)uint32numbersizeMiB
volume size is rounded
up to the next multiple of
256 MiB.
Specifies the ID of the
volume. If not specified,
Negative valuesigint32numberid
the next available ID is
chosen.
Specifies any additional
information up to 511
Noneprint511stringcomment
characters for the
volume.
Specifies VV policies.None, except caching
and system, which are
ignored if false.
policies objectobjectpolicies
Specifies the name of the
CPG from which the
Nonename31stringsnapCPG
snapshot space will be
allocated.
Creating a Storage Volume 55