Update

Parameter	Type	JSON Type	Description	Mandatory
id	NsObjectID	string	Identifier for initiator group. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'.	true
name	NsObjectName	string	Name of initiator group. String of up to 64 alphanumeric characters, - and . and : are allowed after first character. Example: 'myobject-5'.	false
description	NsDescription	string	Text description of initiator group. String of up to 255 printable ASCII characters. Example: '99.9999% availability'.	false
host_type	NsObjectName	string	Initiator group host type. Available options are auto and hpux. The default option is auto. This attribute will be applied to all the initiators in the initiator group. Initiators with different host OSes should not be kept in the same initiator group having a non-default host type attribute. String of up to 64 alphanumeric characters, - and . and : are allowed after first character. Example: 'myobject-5'.	false
target_subnets	NsTargetSubnets	Array of NsTargetSubnet	List of target subnet labels. If specified, discovery and access to volumes will be restricted to the specified subnets. List of target subnet tables.	false
iscsi_initiators	NsISCSIInitiators	Array of NsISCSIInitiator	List of iSCSI initiators. When create/update iscsi_initiators, either iqn or ip_address is always required with label. List of iSCSI initiators.	false
fc_initiators	NsFCInitiators	Array of NsFCInitiator	List of FC initiators. When create/update fc_initiators, wwpn is required. List of Fibre Channel initiators.	false

JSON Request


            

{
   "data" : {
      "name" : "igroup1",
      "target_subnets" : [
         {
            "id":"0c00000000000004d30000000000000001",
            "label" : "subnet1"
         }
      ],
      "iscsi_initiators" : [
         {
            "label":"itor1",
            "ip_address":"1.1.1.1",
            "iqn":"iqn.1992-01.com.example:storage.tape1.sys1.xyz"
         }
      ],
      "description" : "UZIHtermMeJD2P1V4ec2d6XRLMgdxS1AXLVjaW3D2q9DRCgLv37QPH0GlPXqF1N7"
   }
}


{
   "data" : {
      "name" : "igroup1",
      "fc_initiators" : [
         {
            "wwpn":"11:11:11:11:11:11:11:11",
            "alias":"alias1"
         }
      ],
      "description" : "UZIHtermMeJD2P1V4ec2d6XRLMgdxS1AXLVjaW3D2q9DRCgLv37QPH0GlPXqF1N7"
   }
}

Response

Parameter	Type	JSON Type	Description
id	NsObjectID	string	Identifier for initiator group. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'.
name	NsObjectName	string	Name of initiator group. String of up to 64 alphanumeric characters, - and . and : are allowed after first character. Example: 'myobject-5'.
full_name	NsObjectName	string	Initiator group's full name. String of up to 64 alphanumeric characters, - and . and : are allowed after first character. Example: 'myobject-5'.
search_name	NsSearchName	string	Initiator group name used for search. Alphanumeric string, up to 64 characters including hyphen, period, colon. Example: 'vol:1'.
description	NsDescription	string	Text description of initiator group. String of up to 255 printable ASCII characters. Example: '99.9999% availability'.
host_type	NsObjectName	string	Initiator group host type. Available options are auto and hpux. The default option is auto. This attribute will be applied to all the initiators in the initiator group. Initiators with different host OSes should not be kept in the same initiator group having a non-default host type attribute. String of up to 64 alphanumeric characters, - and . and : are allowed after first character. Example: 'myobject-5'.
target_subnets	NsTargetSubnets	Array of NsTargetSubnet	List of target subnet labels. If specified, discovery and access to volumes will be restricted to the specified subnets. List of target subnet tables.
iscsi_initiators	NsISCSIInitiators	Array of NsISCSIInitiator	List of iSCSI initiators. When create/update iscsi_initiators, either iqn or ip_address is always required with label. List of iSCSI initiators.
fc_initiators	NsFCInitiators	Array of NsFCInitiator	List of FC initiators. When create/update fc_initiators, wwpn is required. List of Fibre Channel initiators.
creation_time	NsTime	number	Time when this initiator group was created. Seconds since last epoch i.e. 00:00 January 1, 1970. Example: '3400'.
last_modified	NsTime	number	Time when this initiator group was last modified. Seconds since last epoch i.e. 00:00 January 1, 1970. Example: '3400'.
app_uuid	NsAppUuid	string	Application identifier of initiator group. String of up to 255 alphanumeric characters, hyphen, colon, dot and underscore are allowed. Example: 'rfc4122.943f7dc1-5853-497c-b530-f689ccf1bf18'.
volume_count	NsUnsignedLong	number	Number of volumes that are accessible by the initiator group. Unsigned 64-bit integer. Example: 1234.
volume_list	NsVolumesWithAppCategoryList	Array of NsVolumeSummaryWithAppCategory	List of volumes that are accessible by the initiator group. List of volumes.
num_connections	NsUnsignedLong	number	Total number of connections from initiators in the initiator group. Unsigned 64-bit integer. Example: 1234.

JSON Response


            

{
   "data" : {
      "search_name" : "igroup1",
      "name" : "igroup1",
      "last_modified" : 1426776709,
      "access_protocol" : "iscsi",
      "full_name" : "igroup1",
      "app_uuid" : "",
      "description" : "UZIHtermMeJD2P1V4ec2d6XRLMgdxS1AXLVjaW3D2q9DRCgLv37QPH0GlPXqF1N7",
      "creation_time" : 1426776708,
      "id" : "0200000000000004d3000000000000000000000008",
      "target_subnets" : [
         {
            "id":"0c00000000000004d30000000000000001",
            "label" : "subnet1"
         }
      ],
      "iscsi_initiators": [
         {
            "id": "0b00000000000004d3000000000000000000000001",
            "initiator_id": "0b00000000000004d3000000000000000000000001",
            "label": "itor1",
            "iqn": "iqn.1992-01.com.example:storage.tape1.sys1.xyz",
            "ip_address": "1.1.1.1"
         }
      ],
      "fc_initiators" : null
   }
}

{
   "data" : {
      "search_name" : "igroup1",
      "name" : "igroup1",
      "last_modified" : 1426776709,
      "access_protocol" : "fc",
      "full_name" : "igroup1",
      "app_uuid" : "",
      "description" : "UZIHtermMeJD2P1V4ec2d6XRLMgdxS1AXLVjaW3D2q9DRCgLv37QPH0GlPXqF1N7",
      "creation_time" : 1426776708,
      "id" : "0200000000000004d3000000000000000000000008",
      "target_subnets" : "null",
      "iscsi_initiators" : null,
      "fc_initiators": [
         {
            "id": "0b00000000000004d3000000000000000000000001",
            "initiator_id": "0b00000000000004d3000000000000000000000001",
            "wwpn": "11:11:11:11:11:11:11:11",
            "alias": "alias1"
         }
      ]
   }
}