HP 3PAR Web Service API 1.3.1 Developer's Guide

8 Working with Virtual LUNs
This chapter describes the API operations you can perform on virtual logical unit numbers (VLUNs).
A VLUN is a pairing between a virtual volume (VV) and a logical unit number (LUN), expressed
as either a VLUN template or an active VLUN.
A VLUN template sets up an association between a VV and one of the following combinations by
establishing the export rule, the manner in which the volume is exported. If, when a VLUN template
is created, the current system state meets the conditions established by the template, then active
VLUNs—for example, exports that are seen as LUNs by the host—are the result. Depending on
the conditions of the VLUN template, a single template can produce more than one active VLUN.
The sections that follow describe the APIs to perform VLUN operations.
VLUN Configuration and Enumeration Objects
Several enumerations and configuration objects are used for managing VLUNs. These configuration
objects are defined in this section.
VLUN portPos Configuration Object
The API server communicates port position as a portPos object, as defined in Table 89 (page
100).
Table 89 VLUN portPos JSON Objects
DescriptionAPI TypeJSON TypeMembers
System node (0-7).igint32numbernode
PCI bus slot in the node (0-5).igint32numberslot
Port number on the FC card (0-4).igint32numbercardPort
VLUNtype Enumeration
This component enumerates the type of VLUNs (VLUNType) assigned in the system, as defined in
Table 90 (page 100).
Table 90 VLUNType Enumeration
DescriptionValueSymbol
Empty.1EMPTY
Port.2PORT
Host.3HOST
Matched set.4MATCHED_SET
Host set.5HOST_SET
VLUN multipathing Enumeration
The API server will communicate the multipathing configuration, enumerated as shown in
Table 91 (page 101).
100 Working with Virtual LUNs