HP 3PAR CIM API Programming Reference (OS 3.1.2 MU2) (QL226-97015, June 2013)

Supported Method For Creating a Storage Volume
Table 29 Method for TPD_StorageConfigurationService
DescriptionMethod
Allows clients to create a StorageVolume.CreateOrModifyElementFromStoragePool()
Method Signature
The method signature is described as follows:
uint32 CreateOrModifyElementFromStoragePool (
[In] String ElementName,
[In,
Values {"StorageVolume", "StorageExtent", "LogicalDisk",
"ThinlyProvisionedStorageVolume",
“ThinlyProvisionedLogicalDisk",
"ThinlyProvisionedAllocatedStoragePool",
"ThinlyProvisionedQuotaStoragePool",
"ThinlyProvisionedLimitlessStoragePool"},
ValueMap{"2","3","4","5","6","7","8","9"}]
Uint16 ElementType,
[Out] CIM_ConcreteJob ref Job,
[In] CIM_StorageSetting ref Goal,
[In, Out] Uint64 Size,
[In] CIM_StoragePool ref InPool,
[In, Out] CIM_LogicalElement ref TheElement);
• ElementName: The name of the volume to be created or expanded.
• ElementType: This enumeration specifies what type of object to create.
◦ StorageVolume(2)and ThinlyProvisionedStorageVolume(5) are supported.
If the InPool parameter contains a reference to a concrete pool, this can only be
StorageVolume(2).
• Job: If a Job was created as a side-effect of the execution of the method, then a reference to
that Job is returned through this parameter. Job control is not supported. This output parameter
is always NULL.
• Goal: This is the Service Level that the StorageVolume option is expected to provide. The
Setting is a subset of the Capabilities available from the parent StoragePool. The Goal can
be a null value, in which case the default Setting for the Pool is used. The Goal can refer to
one of the preexisting StorageSetting instances representing RAID types, or the
StorageSetting generated by a CreateSetting method, or from a StorageSetting
option that is associated with another existing StorageVolume option.
• Size: As an input, this is the desired logical size in bytes of the StorageVolume. If it is not
possible to create a volume of the desired size, a return code of Size not supported is
returned with the size set to the nearest supported size. If it is a growing volume request, the
size is the new size of the volume. As an output, size is the actual size allocated for the volume.
It might be a little larger than the input size because the allocation unit is based on chunklet
size (256 MB).
32 CIM API SMI-S Support