Setting the LU path

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 the LU path by mapping the LDEV with the LUN in the host group or in the iSCSI target of the specified port.

Execution permission

Storage Administrator (Provisioning)

Request line

POST base-URL/v1/objects/luns

Request message

Object ID
None.
Query parameters
None.
Body

The following coding example sets an LU path by specifying the LUN:

{
  "portIds": ["CL1-A","CL2-A"],
  "hostGroupNumber": 1,
  "ldevId": 64,
  "lun": 12
}

The following coding example sets an LU path without specifying the LUN:

{
  "portId": "CL1-A",
  "hostGroupNumber": 1,
  "ldevId": 64
}

Attribute

Type

Description

portId

string

(Optional) Port number

Specify this attribute when setting the LU path for one port.

This attribute cannot be specified at the same time as the portIds attribute. You must specify either the portId attribute or the portIds attribute.

portIds

string[]

(Optional) Port number

Specify this attribute when setting the LU paths for multiple ports at the same time. You can specify up to 6 port numbers.

This attribute cannot be specified at the same time as the portId attribute. You must specify either the portId attribute or the portIds attribute.

hostGroupNumber

int

(Required) Host group number (target ID for an iSCSI port)

lun

int

(Optional) LUN

If this attribute is omitted, a value is automatically set.

You cannot specify the same LUN for multiple LDEVs.

ldevId

int

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

An LDEV cannot be mapped to another LUN in the same host group.

For host groups for which host mode option 60 is enabled, if you specify portId but omit lun, automatic configuration of LUNs might fail. If this happens, try the operation again, but specify portIds instead of portId.

Response message

Body

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

Attribute

Description

affectedResources

URL of the created LU path

Status codes

For details on the status codes of the request for this operation, see the description on 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/luns