Getting Server Priority Manager information by specifying a volume and the WWN or iSCSI name of an 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 allows you to get Server Priority Manager information by specifying the LDEV number of a volume and the WWN or iSCSI name of an HBA.

Execution permission

Storage Administrator (View Only)

Request line

GET 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

None.

Response message

Body
{
  "ioControlLdevWwnIscsiId" : "0,210003e08b0256f9",
  "ldevId" : 0,
  "hostWwn" : "210003e08b0256f9",
  "priority" : "NonPrioritize",
  "upperLimitForTransferRate" : 30
}

Attribute

Type

Description

ioControlLdevWwnIscsiId

string

Object ID of the SPM information

ldevId

int

LDEV number

hostWwn

string

WWN of the HBA

iscsiName

string

iSCSI name of the HBA (iSCSI initiator)

priority

string

Prioritized or not prioritized

The value of the SPM setting is output.

  • Prioritize: Prioritized
  • NonPrioritize: Not prioritized

upperLimitForIops

int

Upper limit on IOPS

upperLimitForTransferRate

int

Upper limit on the transfer rate (MBps)

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 GET https://192.0.2.100/ConfigurationManager/v1/objects/io-control-ldev-wwns-iscsis/0,210003e08b0256f9