Changing the Server Priority Manager information

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 changes the upper limit on the transfer rate or IOPS for hosts for which the LDEV number of a volume and the WWN or iSCSI name of the HBA are already specified in Server Priority Manager.

Execution permission

Storage Administrator (System Resource Management)

Request line

PATCH base-URL/v1/objects/io-control-ldev-wwns-iscsis/object-ID

Request message

Object ID

Specify the value of ioControlLdevWwnIscsiId that was obtained by the processing to get the Server Priority Manager list. You can also specify the following attributes, delimited by commas:

For the WWN:

ldevId,hostWwn

For the iSCSI name:

ldevId,iscsiName

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 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.

Query parameters

None.

Body
The following coding example changes the upper limit on IOPS:
{
  "upperLimitForIops" : 9999
}
The following coding example changes the upper limit on the transfer rate:
{
  "upperLimitForTransferRate": 30
}

Attribute

Type

Description

upperLimitForIops

int

(Optional) Upper limit (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 (transfer rate in 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 changed SPM information

Action template

None.

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 PATCH --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/v1/objects/io-control-ldev-wwns-iscsis/0,210003e08b0256f9