You can use the ModifyVolumeAccessGroupLunAssignments method to define custom LUN assignments for specific volumes.

This method changes only LUN values set on the lunAssignments parameter in the volume access group. All other LUN assignments remain unchanged.

LUN assignment values must be unique for volumes in a volume access group. You cannot define duplicate LUN values within a volume access group. However, you can use the same LUN values again in different volume access groups.

Note: Valid LUN values are 0 through 16383. The system generates an exception if you pass a LUN value outside of this range. None of the specified LUN assignments are modified if there is an exception.
If you change a LUN assignment for a volume with active I/O, the I/O can be disrupted. You should change the server configuration before changing volume LUN assignments.


This method has the following input parameters:

Name Description Type Default value Required
volumeAccessGroupID Unique volume access group ID for which the LUN assignments will be modified. integer None Yes
lunAssignments The volume IDs with new assigned LUN values. integer array None Yes

Return value

This method has the following return value:

Name Description Type
volumeAccessGroupLunAssignments An object containing details of the modified volume access group LUN assignments. JSON object

Request example

Requests for this method are similar to the following example:

   "method": "ModifyVolumeAccessGroupLunAssignments",
   "params": {
       "volumeAccessGroupID" : 218,
       "lunAssignments" : [
           {"volumeID" : 832, "lun" : 0},
           {"volumeID" : 834, "lun" : 1}
    "id" : 1

Response example

This method returns a response similar to the following example:

  "id": 1,
  "result": {
    "volumeAccessGroupLunAssignments": {
      "deletedLunAssignments": [],
      "lunAssignments": [
          "lun": 0,
          "volumeID": 832
          "lun": 1,
          "volumeID": 834
      "volumeAccessGroupID": 218