Getting information about a specific LU path

Execution permission

Storage Administrator (View Only)

Request line

GET base-URL/v1/objects/luns/object-ID

Request message

Object ID

Specify the lunId value obtained by getting information about the LU path. You can also specify the following attributes and connect them with commas:

portId,hostGroupNumber,lun

Attribute	Type	Description
portId	string	(Required) Port number
hostGroupNumber	int	(Required) Host group number (target ID for an iSCSI port)
lun	int	(Required) LUN

Query parameters

None.

Body

None.

Response message

Body

{
  "lunId": "CL1-A,1,1",
  "portId": "CL1-A",
  "hostGroupNumber": 1,
  "hostMode": "LINUX/IRIX",
  "lun": 1,
  "ldevId": 1,
  "isCommandDevice": false,
  "luHostReserve": {
    "openSystem": false,
    "persistent": false,
    "pgrKey": false,
    "mainframe": false,
    "acaReserve": false
  },
  "hostModeOptions": [
    2,
    6
  ]
}

Attribute	Type	Description
lunId	string	Object ID for the LUN
portId	string	Port number
hostGroupNumber	int	Host group number of the port (for an iSCSI target, this is the target ID)
hostMode	string	Host mode for setting the host adapter of the host group For details on the values to be obtained, see Changing the host group or iSCSI target settings.
lun	int	LUN between the host group and the mapped LDEV
ldevId	int	LDEV number
isCommandDevice	boolean	Information about whether the device is a command device is output.
luHostReserve	object	Host reservation status of the LU openSystem (boolean) Indicates whether the LU is reserved for open systems. persistent (boolean) Indicates whether the LU is in the persistent reservation status. pgrKey (boolean) Indicates whether the LU is reserved by a PGR key. mainframe (boolean) Indicates whether the LU is reserved for mainframes. acaReserve (boolean) Indicates whether the LU is in the ACA reservation status.
hostModeOptions	int[]	Number of the host mode option set for the host group This is not output if a host mode option is not set. For details on the number to be obtained, see the Provisioning Guide for Open Systems, or the Provisioning Guide.

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 GET https://192.0.2.100/ConfigurationManager/v1/objects/luns/CL1-A,1,1