REST API Reference Version 5.2.1.0Search

Read

GET v1/access_control_records

Query parameters

Parameter Type
startRow NsUnsignedLong
endRow NsUnsignedLong
sortBy NsString
iSortBy NsString
pageSize NsUnsignedInt
id NsObjectID
apply_to NsAccessApplyTo
chap_user_id NsObjectID
chap_user_name NsObjectNameOrAny
initiator_group_id NsObjectID
initiator_group_name NsObjectNameOrAny
lun NsUnsignedLong
vol_id NsObjectID
vol_name NsVolSnapName
vol_agent_type NsAgentType
pe_id NsObjectID
pe_name NsVolSnapName
pe_lun NsUnsignedLong
snap_id NsObjectID
snap_name NsVolSnapName
creation_time NsTime
last_modified NsTime
access_protocol NsAccessProtocol

GET v1/access_control_records/detail

Query parameters

Parameter Type
startRow NsUnsignedLong
endRow NsUnsignedLong
sortBy NsString
iSortBy NsString
fields NsCommaSeparatedList
pageSize NsUnsignedInt
id NsObjectID
apply_to NsAccessApplyTo
chap_user_id NsObjectID
chap_user_name NsObjectNameOrAny
initiator_group_id NsObjectID
initiator_group_name NsObjectNameOrAny
lun NsUnsignedLong
vol_id NsObjectID
vol_name NsVolSnapName
vol_agent_type NsAgentType
pe_id NsObjectID
pe_name NsVolSnapName
pe_lun NsUnsignedLong
snap_id NsObjectID
snap_name NsVolSnapName
creation_time NsTime
last_modified NsTime
access_protocol NsAccessProtocol

GET v1/access_control_records/id

Query parameters

Parameter Type
fields NsCommaSeparatedList

Description

List one or more access control records.

Normal Response Codes

200 206

HTTP Error Codes

400 401 403 404 500 503

Detail Codes

SM_complex_type_query_param

SM_invalid_path_variable

SM_invalid_query_param

SM_malformed_url

SM_no_method_for_URL_pattern

SM_no_operation_found

SM_no_path_found

SM_start_row_beyond_end_row

SM_start_row_beyond_total_rows

SM_unexpected_query_param

SM_unsupported_query_operator

SM_version_name

Response

Parameter Type JSON Type Description Deprecated
id NsObjectID string Identifier for the access control record. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'.  
apply_to NsAccessApplyTo string enum Type of object this access control record applies to. Possible values: 'volume', 'snapshot', 'both', 'pe', 'vvol_volume', 'vvol_snapshot'.  
chap_user_id NsObjectID string Identifier for the CHAP user. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'.  
chap_user_name NsObjectNameOrAny string Name of the CHAP user. String of up to 64 alphanumeric characters or standalone wildcard character '*' to represent any object name, - and . and : are allowed after first character. Examples: 'myobject-5', '*'.  
initiator_group_id NsObjectID string Identifier for the initiator group. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'.  
initiator_group_name NsObjectNameOrAny string Name of the initiator group. String of up to 64 alphanumeric characters or standalone wildcard character '*' to represent any object name, - and . and : are allowed after first character. Examples: 'myobject-5', '*'.  
lun NsUnsignedLong number If this access control record applies to a regular volume, this attribute is the volume's LUN (Logical Unit Number). If the access protocol is iSCSI, the LUN will be 0. However, if the access protocol is Fibre Channel, the LUN will be in the range from 0 to 2047. If this record applies to a Virtual Volume, this attribute is the volume's secondary LUN in the range from 0 to 199999, for both iSCSI and Fibre Channel. If the record applies to a OpenstackV2 volume, the LUN will be in the range from 0 to 2047, for both iSCSI and Fibre Channel. If this record applies to a protocol endpoint, this attribute is not meaningful. Unsigned 64-bit integer. Example: 1234.  
vol_id NsObjectID string Identifier for the volume this access control record applies to. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'.  
vol_name NsVolSnapName string Name of the volume this access control record applies to. String of up to 215 alphanumeric, hyphenated, colon, or period-separated characters; but cannot begin with hyphen, colon or period. This type is used for object sets containing volumes, snapshots, snapshot collections and protocol endpoints.  
vol_agent_type NsAgentType string enum External management agent type. Possible values: 'none', 'smis', 'vvol', 'openstack', 'openstackv2'.  
pe_id NsObjectID string Identifier for the protocol endpoint this access control record applies to. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'.  
pe_name NsVolSnapName string Name of the protocol endpoint this access control record applies to. String of up to 215 alphanumeric, hyphenated, colon, or period-separated characters; but cannot begin with hyphen, colon or period. This type is used for object sets containing volumes, snapshots, snapshot collections and protocol endpoints.  
pe_lun NsUnsignedLong number LUN (Logical Unit Number) to associate with this protocol endpoint. Valid LUNs are in the 0-2047 range. Unsigned 64-bit integer. Example: 1234.  
snap_id NsObjectID string Identifier for the snapshot this access control record applies to. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'.  
snap_name NsVolSnapName string Name of the snapshot this access control record applies to. String of up to 215 alphanumeric, hyphenated, colon, or period-separated characters; but cannot begin with hyphen, colon or period. This type is used for object sets containing volumes, snapshots, snapshot collections and protocol endpoints.  
pe_ids NsObjectIDList Array of NsObjectID List of candidate protocol endpoints that may be used to access the Virtual Volume. One of them will be selected for the access control record. This field is required only when creating an access control record for a Virtual Volume. A list of object ids.  
snapluns NsSnapLunInfoList Array of NsSnapLunInfo Information about the snapshot LUNs associated with this access control record. This field is meaningful when the online snapshot can be accessed as a LUN in the group. Information about the snapshot LUNs as presented in the access_control_records object set. This information is available only for Fibre Channel.  
creation_time NsTime number Time when this access control record was created. Seconds since last epoch i.e. 00:00 January 1, 1970. Example: '3400'.  
last_modified NsTime number Time when this access control record was last modified. Seconds since last epoch i.e. 00:00 January 1, 1970. Example: '3400'.  
access_protocol NsAccessProtocol string enum Access protocol of the volume. Possible values: 'iscsi', 'fc'.  

JSON Response 

            

{
   "data" : {
      "apply_to" : "both",
      "initiator_group_name" : "initiatorgrp0.227931934731664",
      "last_modified" : 1426776528,
      "access_protocol" : "iscsi",
      "initiator_group_id" : "0200000000000004d3000000000000000000000005",
      "chap_user_name" : "chapuser0.649425628633377",
      "vol_id" : "0600000000000004d3000000000000000000000017",
      "lun" : 0,
      "chap_user_id" : "0100000000000004d3000000000000000000000004",
      "vol_name" : "vol0.512194647294567",
      "creation_time" : 1426776528,
      "id" : "0d00000000000004d3000000000000000000000001"
   }
}
Parent topic: access_control_records