You can use the ModifyInitiators method to change the attributes of one or more existing initiators.
You cannot change the name of an existing initiator. If you need to change the name of an initiator, delete it first with the DeleteInitiators method and create a new one with the CreateInitiators method.
If ModifyInitiators fails to change one of the initiators provided in the parameter, the method returns an error and does not modify any initiators (no partial completion is possible).
This method has the following input parameter:
Name | Description | Type | Default value | Required |
---|---|---|---|---|
initiators | A list of objects containing characteristics of each initiator to modify. Possible objects:
|
JSON object array | None | Yes |
This method has the following return value:
Name | Description | Type |
---|---|---|
initiators | List of objects describing the newly modified initiators. | initiator array |
Requests for this method are similar to the following example:
{ "id": 6683, "method": "ModifyInitiators", "params": { "initiators": [ { "initiatorID": 2, "alias": "alias1", "volumeAccessGroupID": null }, { "initiatorID": 3, "alias": "alias2", "volumeAccessGroupID": 1 } ] } }
This method returns a response similar to the following example:
{ "id": 6683, "result": { "initiators": [ { "alias": "alias1", "attributes": {}, "initiatorID": 2, "initiatorName": "iqn.1993-08.org.debian:01:395543635", "volumeAccessGroups": [] }, { "alias": "alias2", "attributes": {}, "initiatorID": 3, "initiatorName": "iqn.1993-08.org.debian:01:935573135", "volumeAccessGroups": [ 1 ] } ] } }
9.6