HP 3PAR StoreServ 7400 2-node HP 3PAR Web Service API 1.2 Developer's - Page 70

VLUN Creation Success, Table 68 Message Body JSON Objects for VLUN Template Request

Get HP 3PAR StoreServ 7400 2-node PDF manuals and user guides View all HP 3PAR StoreServ 7400 2-node manuals
Add to My Manuals
Save this manual to your list of manuals

Page 70 highlights

Table 68 Message Body JSON Objects for VLUN Template Request (continued) Member noVcn JSON Type Boolean overrideLowerPriority Boolean autoLun Boolean API Type Description Ignored Values A VLUN change None* (optional) notification (VCN) not be issued after export (-novcn). Default: False. Existing lower priority VLUNs will be overridden (-ovrd). Use only if hostname member exists. Default: False. None* (optional) States whether the lun number should be autosigned. (Since WSAPI 1.2) maxAutoLun number If autoLun is true, the lun number should be in the range of lun and maxAutoLun. If maxAutoLun is 0, then no max. (Since WSAPI 1.2) *When creating a VLUN, the volumeName and lun members are required. Either hostname or portPos (or both in the case of matched sets) is also required. The noVcn and overrideLowerPriority members are optional. VLUN Creation Success With a successful VLUN creation, the HTTP status code 201 Created is returned, without a message body. Upon successful creation of the VLUN, the Location response header contains the URI for the newly created VLUN in the following format: /api/v1/vluns/,,,[] where: • is the volume that the newly created VLUN exports. • The or [] information, or both (depending on the VLUN type), are the host name and port for the newly created VLUN. The port information will not be displayed for ahost-type VLUN. • If the was not provided, then the location will be: /api/v1/vluns/,,, VLUN Creation Errors Upon failure, the error code and API-specific error information is returned, as shown in Table 69 (page 70). For generic API error codes, see Table 5 (page 17). Table 69 VLUN Creation Error Codes API Error HTTP Code INV_INPUT_MISSING_REQUIRED 400 Bad Request Description Missing volumeName or incomplete port info, specifying override option without hostname. 70 Working with Virtual LUNs

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
Table 68 Message Body JSON Objects for VLUN Template Request
(continued)
Ignored Values
Description
API Type
JSON Type
Member
None* (optional)
A VLUN change
notification (VCN) not be
Boolean
noVcn
issued after export (-novcn).
Default: False.
None* (optional)
Existing lower priority
VLUNs will be overridden
Boolean
overrideLowerPriority
(-ovrd). Use only if
hostname member exists.
Default: False.
States whether the
lun
number should be
autosigned.
Boolean
autoLun
(Since WSAPI 1.2)
If
autoLun
is true, the
lun
number should be in the
number
maxAutoLun
range of
lun
and
maxAutoLun
. If
maxAutoLun
is 0, then no
max.
(Since WSAPI 1.2)
*When creating a VLUN, the
volumeName
and
lun
members are required. Either hostname or
portPos
(or both
in the case of matched sets) is also required. The
noVcn
and
overrideLowerPriority
members are optional.
VLUN Creation Success
With a successful VLUN creation, the HTTP status code
201 Created
is returned, without a
message body.
Upon successful creation of the VLUN, the Location response header contains the URI for the newly
created VLUN in the following format:
/api/v1/vluns/<volume name>,<lun>,<host name>,[<port>]
where:
•
<volume name>
is the volume that the newly created VLUN exports.
•
The
<host name>
or
[<port>]
information, or both (depending on the VLUN type), are
the host name and port for the newly created VLUN. The
port
information will not be displayed
for a
host
-type VLUN.
•
If the
<host name>
was not provided, then the location will be:
/api/v1/vluns/<volume name>,<lun>,,<port>
VLUN Creation Errors
Upon failure, the error code and API-specific error information is returned, as shown in
Table 69 (page 70)
. For generic API error codes, see
Table 5 (page 17)
.
Table 69 VLUN Creation Error Codes
Description
HTTP Code
API Error
Missing
volumeName
or incomplete port info, specifying
override option without hostname.
400 Bad
Request
INV_INPUT_MISSING_REQUIRED
70
Working with Virtual LUNs