HP 3PAR Web Service API 1.3.1 Developer's Guide

Table 143 QoS Rule Creation and Modification Error Codes (continued)
DescriptionHTTP CodeAPI Code
The bandwidth maximum limit
should be greater than the
minimum goal.
400 Bad RequestINV_INPUT_BW_MIN_GOAL_GRT_MAX_LIMIT
Since WSAPI 1.3
I/O-per-second limit is below
range.
400 Bad RequestINV_INPUT_BELOW_RANGE
Bandwidth limit is below
range.
Since WSAPI 1.3
This system is not licensed for
QoS.
400 Bad RequestUNLICENSED_FEATURE
Modifying QoS Rules
To create a QoS rule, use the HTTP PUT method on one of the following URIs:
https://<storage_system>:8080/api/v1/qos/targetType:{targetName}
where:
• targetType can be vvset or sys.
• targetName is the name of the target. When targetType is sys, targetName must be
sys:all_others.
Message body members are shown in Table 144 (page 143)
QOS Rule Modification:
• The QoS rule can be applied to VV sets. By using sys:all_others, you can apply the rule
to all volumes in the system for which no QoS rule has been defined.
• ioMinGoal and ioMaxLimit must be used together to set I/O limits. Similarly,
bwMinGoalKB and bwMaxLimitKB must be used together.
• If ioMaxLimitOP is set to 2 (no limit), ioMinGoalOP must also be to set to 2 (no limit) and
vice versa. They cannot be set to “none” individually. Similarly, if bwMaxLimitOP is set to
2 (no limit), then bwMinGoalOP must also be set to 2.
• If ioMaxLimitOP is set to 1 (zero), ioMinGoalOP must also be to set to 1 (zero) and vice
versa. Similarly, if bwMaxLimitOP is set to 1 (zero), then bwMinGoalOP must also be set to
1.
• The ioMinGoalOP and ioMaxLimitOP fields take precedence over the ioMinGoal and
ioMaxLimit fields.
• The bwMinGoalOP and bwMaxLimitOP fields take precedence over the bwMinGoalKB and
bwMaxLimitKB fields.
Table 144 Message Body JSON Object Members for QoS Rule Modification
DescriptionIgnored ValuesAPI TypeJSON TypeMember
QoS priority.Zero and negative
values.
priority Enumnumberpriority
Since WSAPI 1.3
Bandwidth rate minimum goal in
kilobytes per second.
Zero and negative
values.
uint64numberbwMinGoalKB
Since WSAPI 1.3
Modifying QoS Rules 143