Setting Server Priority Manager information by specifying a volume and the WWN or iSCSI name of the HBA

REST API Reference Guide for Virtual Storage Platform 5000, Virtual Storage Platform E Series, and Virtual Storage Platform G/F Series

Version
93-07-0x
90-09-0x
88-08-10
Audience
anonymous
Part Number
MK-98RD9014-17
The following request sets, in Server Priority Manager, the upper limit on the transfer rate or IOPS of a low-priority host by specifying the LDEV number of the volume and the WWN or iSCSI name of the HBA.
Note:

If the number of volumes for which Server Priority Manager has been configured exceeds 4,096, the hosts of volumes configured after the 4,096th volume will have lower I/O response be lower than the hosts of the first 4,096 volumes to be configured.

Make sure the number of volumes for which Server Priority Manager has been configured does not exceed 4,096.

Execution permission

Storage Administrator (System Resource Management)

Request line

POST base-URL/v1/objects/io-control-ldev-wwns-iscsis

Request message

Object ID

None.

Query parameters

None.

Body
The following coding example sets the upper limit on IOPS:
{
 "ldevId" : 0,
 "hostWwn" : "210003e08b0256f9",
 "upperLimitForIops" : 9999
}
The following coding example sets the upper limit on the transfer rate:
{
 "ldevId" : 0,
 "iscsiName" : "iqn.myrestapiiscsi20150907",
 "upperLimitForTransferRate" : 30
}

Attribute

Type

Description

ldevId

int

(Required) Specify the LDEV number as a decimal (base 10) number.

hostWwn

string

(Optional) WWN of the HBA

Specify a hexadecimal number consisting of 16 characters.

You must specify either the hostWwn attribute or the iscsiName attribute.

iscsiName

string

(Optional) iSCSI name of the HBA (iSCSI initiator)

Specify the name in iqn format or eui format.

  • iqn format

    Specify a value consisting of 5 to 223 characters. You can use the following characters:

    Alphanumeric characters, hyphens (-), periods (.), and colons (:)

    Specification example: iqn.rest.example.of.iqn.form

  • eui format

    Specify eui. followed by a hexadecimal number. The specified value must consist of a total of 20 characters.

    Specification example: eui.0900ABDC32598D26

You must specify either the hostWwn attribute or the iscsiName attribute.

upperLimitForIops

int

(Optional) Upper limit on the IOPS (IOPS)

Specify a value in the range from 1 to 65535.

You must specify either the upperLimitForIops attribute or the upperLimitForTransferRate attribute.

upperLimitForTransferRate

int

(Optional) Upper limit on the transfer rate (MBps)

Specify a value in the range from 1 to 31.

You must specify either the upperLimitForIops attribute or the upperLimitForTransferRate attribute.

Response message

Body

A job object is returned. For details on attributes other than affectedResources, see the description of job objects.

Attribute

Description

affectedResources

URL of the specified SPM information

Status codes

For details on the status codes of the request for this operation, see the description of HTTP status codes.

Coding example

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X POST --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/v1/objects/io-control-ldev-wwns-iscsis/