You can use CreateVolumeAccessGroup to create a new volume access group. When you create the volume access group, you need to give it a name, and you can optionally enter initiators and volumes.
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) | [] | No |
name | Name of the volume access group. Not required to be unique, but recommended. Must be 1 to 64 characters in length. | string | None | Yes |
volumes | List of volumeIDs to include in the volume access group. | integer array | [] | No |
attributes | List of name-value pairs in JSON object format. | JSON object | {} | No |
This method has the following return values:
Name | Description | Type |
---|---|---|
volumeAccessGroup | An object containing information about the newly created volume access group. | volumeAccessGroup |
volumeAccessGroupID | The ID of the newly created volume access group. | integer |
Requests for this method are similar to the following example:
{ "method": "CreateVolumeAccessGroup", "params": { "name": "myaccessgroup", "initiators": ["iqn.1993-08.org.debian: 01: a31b1d799d5c"], "volumes": [327], "attributes": {} } }
This method returns a response similar to the following example:
{ "id": null, "result": { "volumeAccessGroup": { "attributes": {}, "deletedVolumes": [], "initiatorIDs": [ 95 ], "initiators": [ "iqn.1993-08.org.debian: 01: a31b1d799d5c" ], "name": "myaccessgroup", "volumeAccessGroupID": 96, "volumes": [ 327 ] }, "volumeAccessGroupID": 96 } }