ModifyVolumeAccessGroupLunAssignments

05/25/2022 Contributors

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.

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.

CAUTION:

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.

Parameters

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

New since version

9.6