Read
GET v1/initiator_groups
Query parameters
| Parameter | Type |
|---|---|
| startRow | NsUnsignedLong |
| endRow | NsUnsignedLong |
| sortBy | NsString |
| iSortBy | NsString |
| pageSize | NsUnsignedInt |
| id | NsObjectID |
| name | NsObjectName |
| full_name | NsObjectName |
| search_name | NsSearchName |
| description | NsDescription |
| access_protocol | NsAccessProtocol |
| host_type | NsObjectName |
| creation_time | NsTime |
| last_modified | NsTime |
| app_uuid | NsAppUuid |
| volume_count | NsUnsignedLong |
| num_connections | NsUnsignedLong |
GET v1/initiator_groups/detail
Query parameters
| Parameter | Type |
|---|---|
| startRow | NsUnsignedLong |
| endRow | NsUnsignedLong |
| sortBy | NsString |
| iSortBy | NsString |
| fields | NsCommaSeparatedList |
| pageSize | NsUnsignedInt |
| id | NsObjectID |
| name | NsObjectName |
| full_name | NsObjectName |
| search_name | NsSearchName |
| description | NsDescription |
| access_protocol | NsAccessProtocol |
| host_type | NsObjectName |
| creation_time | NsTime |
| last_modified | NsTime |
| app_uuid | NsAppUuid |
| volume_count | NsUnsignedLong |
| num_connections | NsUnsignedLong |
Description
List a set of initiator groups used for authentication.
Normal Response Codes
200 206
HTTP Error Codes
400 401 403 404 500 503
Detail Codes
Response
| Parameter | Type | JSON Type | Description | Deprecated |
|---|---|---|---|---|
| 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'. | |
| access_protocol | NsAccessProtocol | string enum | Initiator group access protocol. Possible values: 'iscsi', 'fc'. | |
| 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" : 1426776461,
"app_uuid" : "abcd",
"fc_initiators" : null,
"access_protocol" : "iscsi",
"iscsi_initiators" : null,
"full_name" : "igroup1",
"description" : "wtuNSNWYXWKznxsLIBZndxctuEEkoEtarxaXW0K3IAUbK0FtLgKkJ4pzNR1NhZXE",
"creation_time" : 1426776461,
"id" : "0200000000000004d3000000000000000000000001",
"target_subnets" : [
{
"id":"0c00000000000004d30000000000000001",
"label" : "subnet1"
}
]
}
}