You can use the AddInitiatorsToVolumeAccessGroup method to add initiators to a specified volume access group.

The accepted format of an initiator IQN is iqn.yyyy-mm, where y and m are digits, followed by text which must only contain digits, lower-case alphabetic characters, a period (.), colon (:) or dash (-). See the following example:
The accepted format of a Fibre Channel initiator WWPN is Aa:bB:CC:dd:11:22:33:44, or AabBCCdd11223344. See the following example:


This method has the following input parameters:

Name Description Type Default value Required
initiators List of initiator IDs or names (IQNs and WWPNs) to include in the volume access group. If you pass a list of initiator names, the initiators are created if they do not already exist.

If you pass a list of initiator IDs, the method returns an error if any of the initiators does not already exist.

Passing initiator names is deprecated; you should use initiator IDs whenever possible.

integer array or string array (deprecated) [] Yes
volumeAccessGroupID The ID of the volume access group to add the initiator. integer None Yes

Return value

This method has the following return value:

Name Description Type
volumeAccessGroup An object containing information about the newly modified volume access group. volumeAccessGroup

Request example

Requests for this method are similar to the following example:

  "id": 13171,
  "method": "AddInitiatorsToVolumeAccessGroup",
  "params": {
    "initiators": [116,117],
    "volumeAccessGroupID": 96

Response example

This method returns a response similar to the following example:

  "id": 13171,
  "result": {
    "volumeAccessGroup": {
      "attributes": {},
      "deletedVolumes": [
      "initiatorIDs": [
      "initiators": [
      "name": "northbanktest",
      "volumeAccessGroupID": 96,
      "volumes": [

New since version