{"restSchemaVersion":"1.0","errors":[{"error_id":"INTERNAL_ERROR","description":"Internal server error.","http_status":"500"},{"error_id":"AUTH_REQUIRED","description":"The requested resource requires authentication.","http_status":"401"},{"error_id":"AUTH_INVALID_CREDENTIALS","description":"Invalid username and/or password.","http_status":"401"},{"error_id":"AUTH_INVALID_SESSION","description":"Session ID is invalid.","http_status":"401"},{"error_id":"AUTH_EXPIRED_PASSWORD","description":"The password must be changed. Access only to password change resources.","http_status":"403"},{"error_id":"AUTH_DISABLED_ACCOUNT","description":"Account is either temporarily or permanently disabled.","http_status":"403"},{"error_id":"AUTH_FORBIDDEN","description":"User is not authorized to access the requested resource.","http_status":"403"},{"error_id":"AUTH_INVALID_TOKEN","description":"OAuth access token is invalid.","http_status":"401"},{"error_id":"AUTH_EXPIRED_TOKEN","description":"OAuth access token is expired.","http_status":"401"},{"error_id":"AUTH_INVALID_CODE","description":"OAuth access code is invalid.","http_status":"401"},{"error_id":"AUTH_EXPIRED_CODE","description":"OAuth access code is expired.","http_status":"401"},{"error_id":"RESOURCE_NOT_FOUND","description":"Requested resource was not found.","http_status":"404"},{"error_id":"HTTP_INVALID_METHOD","description":"Requested method is not available for this resource.","http_status":"405"},{"error_id":"HTTP_INVALID_HEADER","description":"An HTTP header was malformed.","http_status":"400"},{"error_id":"REQUEST_INVALID_INPUT","description":"Malformed input structure.","http_status":"400"},{"error_id":"URI_INVALID_PARAMETER","description":"URI parameter is not supported or malformed.","http_status":"400"},{"error_id":"URI_MISSING_PARAMETER","description":"Missing required parameter.","http_status":"400"}],"name":"gateway","title":"Riverbed Flow Gateway REST API.","version":"1.5","schemas":[],"defaultAuthorization":"required","servicePath":"/api/gateway/1.5","resources":{"Flow_Sources":{"methods":{"List flow sources":{"description":"Get a list of flow sources.","response":{"description":"List of flow sources.","items":{"properties":{"flows_arrived_last_hr":{"description":"All Flows arrived at FlowGateway last hour(last 60 minutes).","required":false,"type":"number"},"peak_flows_arrived_last_hr":{"description":"Max number of flows arrived at FlowGateway any minute in the last hour(last 60 minutes).","required":false,"type":"number"},"last_min_arrived_timestamp":{"description":"Timestamp for stats arrived last minute.","required":false,"type":"number"},"timeslice_violation":{"description":"Timeslice violation.","required":false,"type":"string"},"status":{"description":"Flow source status.","required":true,"type":"string"},"peak_flows_arrived_last_day":{"description":"Max number of flows arrived at FlowGateway any minute in the last day(last 24*60 minutes).","required":false,"type":"number"},"peak_bits_arrived_last_day":{"description":"Max number of bits arrived at FlowGateway any second in the last day(last 24*60 minutes).","required":false,"type":"number"},"flows_arrived_last_day":{"description":"All Flows arrived at FlowGateway last day(last 24*60 minutes).","required":false,"type":"number"},"peak_flows_arrived_last_min":{"description":"Max number of flows arrived at FlowGateway any second in the last minute where time window snapped to minute boundary.","required":false,"type":"number"},"flows_received_last_min":{"description":"Flows received (last minute).","required":false,"type":"number"},"last_min":{"description":"Last heard from.","required":false,"type":"number"},"ipaddr":{"description":"IP address.","required":true,"type":"string"},"name":{"description":"Device name.","required":true,"type":"string"},"versions":{"description":"Versions.","required":true,"type":"string"},"flow_type":{"description":"Flow type.","required":true,"type":"string"},"flows_arrived_last_min":{"description":"All Flows arrived at FlowGateway last minute where time window snapped to minute boundary.","required":false,"type":"number"},"peak_bytes_arrived_last_day":{"description":"Max number of bytes arrived at FlowGateway any minute in the last day(last 24*60 minutes).","required":false,"type":"number"}},"description":"Flow source.","required":false,"type":"object","id":"GatewayStatsFlowSource"},"type":"array","id":"GatewayStatsFlowSources","example":[{"status":"N/A","flows_arrived_last_hr":1827,"name":"N/A","versions":"9.2","peak_flows_arrived_last_min":30,"peak_flows_arrived_last_day":203,"ipaddr":"10.1.11.175","last_min":1703111220,"flows_received_last_min":22,"last_min_arrived_timestamp":1703111040,"flow_type":"Riverbed SteelFlow","flows_arrived_last_min":68,"peak_bits_arrived_last_day":68992,"timeslice_violation":"false","flows_arrived_last_day":82785,"peak_bytes_arrived_last_day":18668,"peak_flows_arrived_last_hr":88},{"status":"N/A","flows_arrived_last_hr":21502156,"name":"N/A","versions":"1.0","peak_flows_arrived_last_min":65770,"peak_flows_arrived_last_day":762187,"ipaddr":"10.44.67.83","last_min":1703111220,"flows_received_last_min":432645,"last_min_arrived_timestamp":1703111040,"flow_type":"AWS VPC Flow Exporter","flows_arrived_last_min":415374,"peak_bits_arrived_last_day":44667040,"flows_arrived_last_day":561798344,"peak_bytes_arrived_last_day":40646852,"peak_flows_arrived_last_hr":528396}]},"httpmethod":"GET","formats":["xml","json"],"authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"flow_sources","authorization":"required"},"Get flow source":{"description":"Get a flow source by IP Address.","response":{"properties":{"flows_arrived_last_hr":{"description":"All Flows arrived at FlowGateway last hour(last 60 minutes).","required":false,"type":"number"},"peak_flows_arrived_last_hr":{"description":"Max number of flows arrived at FlowGateway any minute in the last hour(last 60 minutes).","required":false,"type":"number"},"last_min_arrived_timestamp":{"description":"Timestamp for stats arrived last minute.","required":false,"type":"number"},"timeslice_violation":{"description":"Timeslice violation.","required":false,"type":"string"},"status":{"description":"Flow source status.","required":true,"type":"string"},"peak_flows_arrived_last_day":{"description":"Max number of flows arrived at FlowGateway any minute in the last day(last 24*60 minutes).","required":false,"type":"number"},"peak_bits_arrived_last_day":{"description":"Max number of bits arrived at FlowGateway any second in the last day(last 24*60 minutes).","required":false,"type":"number"},"flows_arrived_last_day":{"description":"All Flows arrived at FlowGateway last day(last 24*60 minutes).","required":false,"type":"number"},"peak_flows_arrived_last_min":{"description":"Max number of flows arrived at FlowGateway any second in the last minute where time window snapped to minute boundary.","required":false,"type":"number"},"flows_received_last_min":{"description":"Flows received (last minute).","required":false,"type":"number"},"last_min":{"description":"Last heard from.","required":false,"type":"number"},"ipaddr":{"description":"IP address.","required":true,"type":"string"},"name":{"description":"Device name.","required":true,"type":"string"},"versions":{"description":"Versions.","required":true,"type":"string"},"flow_type":{"description":"Flow type.","required":true,"type":"string"},"flows_arrived_last_min":{"description":"All Flows arrived at FlowGateway last minute where time window snapped to minute boundary.","required":false,"type":"number"},"peak_bytes_arrived_last_day":{"description":"Max number of bytes arrived at FlowGateway any minute in the last day(last 24*60 minutes).","required":false,"type":"number"}},"description":"Flow source.","type":"object","id":"GatewayStatsFlowSource","example":{"status":"N/A","name":"N/A","versions":"9.2","ipaddr":"10.32.1.41","last_min":1392392760,"flows_received_last_min":962,"flow_type":"NetFlow"}},"httpmethod":"GET","formats":["xml","json"],"authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"flow_sources/{ipaddr}","authorization":"required"},"Delete flow source":{"description":"Delete a flow source by IP Address.","httpmethod":"DELETE","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"flow_sources/{ipaddr}","authorization":"required"}}},"Ping":{"methods":{"Ping":{"description":"Simple test of service availability.","httpmethod":"GET","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"ping","authorization":"required"}}},"System":{"methods":{"Start all processes (one module)":{"description":"Start all system processes on one module on Enterprise systems. The operation is asynchronous. Use \"GET system/{module}/status\" to poll for status. The {module} can be either the IP Address or the module name.","httpmethod":"POST","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"system/{module}/start","authorization":"required"},"Get status of all processes":{"description":"Get status of all system processes. On Enterprise systems, get system process statuses on all modules.","response":{"description":"SystemStatus object.","items":{"properties":{"process_id":{"description":"Process ID.","required":false,"type":"string"},"process_name":{"description":"Process name.","required":true,"type":"string"},"module_name":{"description":"Module name. Available on Enterprise systems only.","required":false,"type":"string"},"status":{"description":"Process status.","required":true,"type":"string","enum":["Running","Stopped"]},"module_ipaddr":{"description":"Module IP address. Available on Enterprise systems only.","required":false,"type":"string"}},"description":"SystemProcess object.","required":false,"type":"object","id":"SystemProcess"},"type":"array","id":"SystemStatus","example":[{"process_id":"25096","process_name":"memmonitor","status":"Running"},{"process_name":"healthd","status":"Stopped"},{"process_id":"25092","process_name":"diskmon","status":"Running"},{"process_id":"25123","process_name":"dispatcher","status":"Running"},{"process_name":"analyzer","status":"Stopped"}]},"httpmethod":"GET","formats":["xml","json"],"authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"system/status","authorization":"required"},"Kill all processes":{"description":"Kill all system processes. The operation is asynchronous. Use \"GET system/status\" to poll for status. On Enterprise systems, kill system processes on all modules. Warning: this operation can result in data being corrupted.","httpmethod":"POST","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"system/kill","authorization":"required"},"Restart all processes":{"description":"Restart all system processes. The operation is asynchronous. Use \"GET system/status\" to poll for status. On Enterprise systems, stop system processes on all modules.","httpmethod":"POST","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"system/restart","authorization":"required"},"Start all processes":{"description":"Start all system processes. The operation is asynchronous. Use \"GET system/status\" to poll for status. On Enterprise systems, start system processes on all modules.","httpmethod":"POST","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"system/start","authorization":"required"},"Restart all processes (one module)":{"description":"Restart all system processes on one module on Enterprise systems. The operation is asynchronous. Use \"GET system/{module}/status\" to poll for status. The {module} can be either the IP Address or the module name.","httpmethod":"POST","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"system/{module}/restart","authorization":"required"},"Stop all processes (one module)":{"description":"Stop all system processes on one module on Enterprise systems. The operation is asynchronous. Use \"GET system/{module}/status\" to poll for status. The {module} can be either the IP Address or the module name.","httpmethod":"POST","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"system/{module}/stop","authorization":"required"},"Get status of all processes (one module)":{"description":"Get status of all system processes on one module on Enterprise systems. The {module} can be either the IP Address or the module name.","response":{"description":"SystemStatus object.","items":{"properties":{"process_id":{"description":"Process ID.","required":false,"type":"string"},"process_name":{"description":"Process name.","required":true,"type":"string"},"module_name":{"description":"Module name. Available on Enterprise systems only.","required":false,"type":"string"},"status":{"description":"Process status.","required":true,"type":"string","enum":["Running","Stopped"]},"module_ipaddr":{"description":"Module IP address. Available on Enterprise systems only.","required":false,"type":"string"}},"description":"SystemProcess object.","required":false,"type":"object","id":"SystemProcess"},"type":"array","id":"SystemStatus","example":[{"process_id":"25096","process_name":"memmonitor","status":"Running"},{"process_name":"healthd","status":"Stopped"},{"process_id":"25092","process_name":"diskmon","status":"Running"},{"process_id":"25123","process_name":"dispatcher","status":"Running"},{"process_name":"analyzer","status":"Stopped"}]},"httpmethod":"GET","formats":["xml","json"],"authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"system/{module}/status","authorization":"required"},"Shutdown":{"description":"Shutdown the system. The operation is asynchronous.","httpmethod":"POST","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"system/shutdown","authorization":"required"},"Reboot":{"description":"Reboot the system. The operation is asynchronous.","httpmethod":"POST","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"system/reboot","authorization":"required"},"Stop all processes":{"description":"Stop all system processes. The operation is asynchronous. Use \"GET system/status\" to poll for status. On Enterprise systems, stop system processes on all modules.","httpmethod":"POST","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"system/stop","authorization":"required"},"Kill all processes (one module)":{"description":"Kill all system processes on one module on Enterprise systems. The operation is asynchronous. Use \"GET system/{module}/status\" to poll for status. The {module} can be either the IP Address or the module name. Warning: this operation can result in data being corrupted.","httpmethod":"POST","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"system/{module}/kill","authorization":"required"}}},"Stats":{"methods":{"Get Gateway statistics":{"description":"Get Gateway statistics.","response":{"properties":{"flow_sources":{"description":"List of flow sources.","items":{"properties":{"flows_arrived_last_hr":{"description":"All Flows arrived at FlowGateway last hour(last 60 minutes).","required":false,"type":"number"},"peak_flows_arrived_last_hr":{"description":"Max number of flows arrived at FlowGateway any minute in the last hour(last 60 minutes).","required":false,"type":"number"},"last_min_arrived_timestamp":{"description":"Timestamp for stats arrived last minute.","required":false,"type":"number"},"timeslice_violation":{"description":"Timeslice violation.","required":false,"type":"string"},"status":{"description":"Flow source status.","required":true,"type":"string"},"peak_flows_arrived_last_day":{"description":"Max number of flows arrived at FlowGateway any minute in the last day(last 24*60 minutes).","required":false,"type":"number"},"peak_bits_arrived_last_day":{"description":"Max number of bits arrived at FlowGateway any second in the last day(last 24*60 minutes).","required":false,"type":"number"},"flows_arrived_last_day":{"description":"All Flows arrived at FlowGateway last day(last 24*60 minutes).","required":false,"type":"number"},"peak_flows_arrived_last_min":{"description":"Max number of flows arrived at FlowGateway any second in the last minute where time window snapped to minute boundary.","required":false,"type":"number"},"flows_received_last_min":{"description":"Flows received (last minute).","required":false,"type":"number"},"last_min":{"description":"Last heard from.","required":false,"type":"number"},"ipaddr":{"description":"IP address.","required":true,"type":"string"},"name":{"description":"Device name.","required":true,"type":"string"},"versions":{"description":"Versions.","required":true,"type":"string"},"flow_type":{"description":"Flow type.","required":true,"type":"string"},"flows_arrived_last_min":{"description":"All Flows arrived at FlowGateway last minute where time window snapped to minute boundary.","required":false,"type":"number"},"peak_bytes_arrived_last_day":{"description":"Max number of bytes arrived at FlowGateway any minute in the last day(last 24*60 minutes).","required":false,"type":"number"}},"description":"Flow source.","required":false,"type":"object","id":"GatewayStatsFlowSource"},"required":true,"type":"array","id":"GatewayStatsFlowSources"},"overflow_limit":{"description":"Overflow limit of the gateway.","required":false,"type":"number"},"capacity":{"description":"Licensed flow capacity post de-duplication (per minute).","required":false,"type":"number"},"stat_timespan":{"description":"Timespan for computing average and peak values.","required":true,"type":"number"},"profilers":{"description":"List of Profilers.","items":{"properties":{"overflows_last_min":{"description":"Number of dropped flow (last minute).","required":false,"type":"number"},"capacity":{"description":"Licensed flow capacity post de-duplication (per minute).","required":false,"type":"number"},"status":{"description":"Current Profiler status.","required":true,"type":"string"},"flows_received_last_min":{"description":"Number of de-duplicated flows received (last minute).","required":false,"type":"number"},"last_min":{"description":"Last minute timestamp.","required":false,"type":"number"},"ipaddr":{"description":"IP address.","required":true,"type":"string"},"flows_sent_last_min":{"description":"Number of flows sent (last minute).","required":false,"type":"number"},"name":{"description":"Name.","required":true,"type":"string"}},"description":"Profiler information.","required":false,"type":"object","id":"GatewayStatsProfiler"},"required":true,"type":"array","id":"GatewayStatsProfilers"},"raw_flows_received_last_min":{"description":"Number of raw flows received (last minute).","required":false,"type":"number"},"status":{"description":"Gateway current status.","required":true,"type":"string"},"flows_received_last_min":{"description":"Number of de-duplicated flows received (last minute).","required":false,"type":"number"},"last_min":{"description":"Timestamp of the statistics data.","required":false,"type":"number"},"name":{"description":"Gateway name.","required":true,"type":"string"},"peak_flows_received":{"description":"Peak number of de-duplicated flows received during the timespan (per minute).","required":false,"type":"number"},"avg_flows_received":{"description":"Average number of de-duplicated flows received during the timespan (per minute).","required":false,"type":"number"},"flow_destinations":{"description":"List of flow destinations.","items":{"properties":{"port":{"description":"Port.","required":true,"type":"number"},"overwrite_source_address":{"description":"Overwrite source address.","required":true,"type":"string"},"ipaddr":{"description":"IP address.","required":true,"type":"string"},"flows_sent_last_min":{"description":"Number of flows (packets for sFlow) sent (last minute).","required":false,"type":"number"},"flow_type":{"description":"Flow type.","required":true,"type":"string"}},"description":"Flow destination.","required":false,"type":"object","id":"GatewayStatsFlowDestination"},"required":true,"type":"array","id":"GatewayStatsFlowDestinations"}},"description":"Gateway statistics.","type":"object","id":"GatewayStats","example":{"status":"up","raw_flows_received_last_min":19908,"capacity":16777216,"name":"gateway1","stat_timespan":604800,"last_min":1392393198,"profilers":[{"status":"up","flows_sent_last_min":0,"capacity":0,"name":"NetProfiler","ipaddr":"10.38.1.17","last_min":1392333168,"flows_received_last_min":0}],"flows_received_last_min":0,"peak_flows_received":4194304,"flow_sources":[{"status":"N/A","name":"N/A","versions":"9.2","ipaddr":"10.32.1.41","last_min":1392392760,"flows_received_last_min":962,"flow_type":"NetFlow"},{"status":"up","name":"cam-qaesx24-1.lab.nbttech.com.","versions":"9(S8.4)","ipaddr":"10.38.128.36","last_min":1450732819,"flows_received_last_min":100000,"flow_type":"Riverbed SteelFlow"}],"avg_flows_received":2097152,"flow_destinations":[{"overwrite_source_address":"no","flows_sent_last_min":15903,"ipaddr":"10.38.1.24","port":2055,"flow_type":"NetFlow"}]}},"httpmethod":"GET","formats":["xml","json"],"authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"stats","authorization":"required"}}},"Users":{"methods":{"List users":{"description":"Get a list of user accounts.","parameters":{"filter":{"required":false,"type":"string","description":"[Missing resource 'GET:/api/gateway/1.5/users?filter' in bundle 'rest_info']"}},"response":{"description":"List of user accounts on the system.","items":{"properties":{"enabled":{"description":"Boolean flag indicating if the user account is enabled.","required":true,"type":"string"},"last_name":{"description":"Last name of the user.","required":true,"type":"string"},"id":{"description":"Numeric ID of the user that the system uses internally and in the API.","required":true,"type":"number"},"last_login":{"description":"Time of last login. Unix time (epoch).","required":true,"type":"number"},"authentication_type":{"description":"Type of authentication for the user, such as Local or RADIUS.","required":true,"type":"string","enum":["Local","Remote","SAML"]},"username":{"description":"User name (short name) that identifies the user to the system, such as 'admin'.","required":true,"type":"string"},"authorization_type":{"description":"Type of authorization for the user, such as Local or RADIUS.","required":true,"type":"string","enum":["Local","Remote"]},"role":{"description":"Role of the user. Defines permissions.","required":true,"type":"string","enum":["Developer","Administrator","Operator","Monitor","Event_Viewer","Dashboard_Viewer","Restricted","Shared_Link_Viewer"]},"first_name":{"description":"First name of the user.","required":true,"type":"string"},"edit_dashboards":{"description":"Boolean flag indicating if the user has permission to administrate dashboards.","required":false,"type":"string"},"traffic_filter":{"description":"Traffic expression. Only applicable to Restricted role.","required":false,"type":"string"},"last_access":{"description":"Time of last access to the system. Unix time (epoch).","required":true,"type":"number"},"view_packet_details":{"description":"Boolean flag indicating if the user has access to packet data.","required":false,"type":"string"},"last_authentication":{"description":"Time of last authentication. Unix time (epoch).","required":true,"type":"number"},"auto_resolution":{"description":"Force to use auto resolution. Only applicable to Restricted role.","required":false,"type":"string"},"view_user_information":{"description":"Boolean flag indicating if the user has access to identity information, such as Active Directory information.","required":false,"type":"string"},"login_timeout":{"description":"Timeout (in seconds) during which the user cannot log in to the system because of security policies.","required":true,"type":"number"}},"description":"User account.","required":false,"type":"object","id":"User"},"type":"array","id":"Users","example":[{"last_authentication":1352313328,"first_name":"Jonh","last_name":"Smith","authorization_type":"Local","username":"admin","enabled":true,"view_user_information":true,"authentication_type":"Local","last_login":1352313328,"login_timeout":900,"role":"Administrator","last_access":1352313328,"id":123},{"last_authentication":1352313328,"first_name":"Mark","last_name":"Greg","authorization_type":"Local","username":"admin2","enabled":true,"view_user_information":true,"authentication_type":"Local","last_login":1352313328,"login_timeout":900,"role":"Administrator","last_access":1352313328,"id":124}]},"httpmethod":"GET","formats":["xml","json"],"authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"users","authorization":"required"},"[Missing resource 'DELETE:/api/gateway/1.5/users/{user_id}' in bundle 'rest_short_info']":{"description":"[Missing resource 'DELETE:/api/gateway/1.5/users/{user_id}' in bundle 'rest_info']","httpmethod":"DELETE","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"users/{user_id}","authorization":"required"},"[Missing resource 'PUT:/api/gateway/1.5/users/{user_id}' in bundle 'rest_short_info']":{"description":"[Missing resource 'PUT:/api/gateway/1.5/users/{user_id}' in bundle 'rest_info']","request":{"properties":{"last_name":{"description":"Last name of the user.","required":false,"type":"string"},"new_password":{"properties":{"cleartext":{"description":"Set the user's password in plain text.","required":true,"type":"string"}},"description":"Set the user's password.","required":false,"type":"object","id":"NewUserPass"},"role":{"description":"Role of the user. Defines permissions.","required":false,"type":"string","enum":["Developer","Administrator","Operator","Monitor","Event_Viewer","Dashboard_Viewer","Restricted","Shared_Link_Viewer"]},"first_name":{"description":"First name of the user.","required":false,"type":"string"},"edit_dashboards":{"description":"Boolean flag indicating if the user has permission to administrate dashboards.","required":false,"type":"string"},"traffic_filter":{"description":"Traffic expression. Only applicable to Restricted role.","required":false,"type":"string"},"view_packet_details":{"description":"Boolean flag indicating if the user has access to packet data.","required":false,"type":"string"},"strict_password_exempt":{"description":"Boolean flag indicating if the user is exempt from strict password requirements.","required":false,"type":"string"},"auto_resolution":{"description":"Force to use auto resolution. Only applicable to Restricted role.","required":false,"type":"string"},"view_user_information":{"description":"Boolean flag indicating if the user has access to identity information, such as Active Directory information.","required":false,"type":"string"}},"description":"Update User account object. Only properties that are specified will be updated.","type":"object","id":"UserUpdate","example":{"first_name":"Jonh","last_name":"Smith","new_password":{"cleartext":"mypassword"},"role":"Administrator"}},"response":{"properties":{"enabled":{"description":"Boolean flag indicating if the user account is enabled.","required":true,"type":"string"},"last_name":{"description":"Last name of the user.","required":true,"type":"string"},"id":{"description":"Numeric ID of the user that the system uses internally and in the API.","required":true,"type":"number"},"last_login":{"description":"Time of last login. Unix time (epoch).","required":true,"type":"number"},"authentication_type":{"description":"Type of authentication for the user, such as Local or RADIUS.","required":true,"type":"string","enum":["Local","Remote","SAML"]},"username":{"description":"User name (short name) that identifies the user to the system, such as 'admin'.","required":true,"type":"string"},"authorization_type":{"description":"Type of authorization for the user, such as Local or RADIUS.","required":true,"type":"string","enum":["Local","Remote"]},"role":{"description":"Role of the user. Defines permissions.","required":true,"type":"string","enum":["Developer","Administrator","Operator","Monitor","Event_Viewer","Dashboard_Viewer","Restricted","Shared_Link_Viewer"]},"first_name":{"description":"First name of the user.","required":true,"type":"string"},"edit_dashboards":{"description":"Boolean flag indicating if the user has permission to administrate dashboards.","required":false,"type":"string"},"traffic_filter":{"description":"Traffic expression. Only applicable to Restricted role.","required":false,"type":"string"},"last_access":{"description":"Time of last access to the system. Unix time (epoch).","required":true,"type":"number"},"view_packet_details":{"description":"Boolean flag indicating if the user has access to packet data.","required":false,"type":"string"},"last_authentication":{"description":"Time of last authentication. Unix time (epoch).","required":true,"type":"number"},"auto_resolution":{"description":"Force to use auto resolution. Only applicable to Restricted role.","required":false,"type":"string"},"view_user_information":{"description":"Boolean flag indicating if the user has access to identity information, such as Active Directory information.","required":false,"type":"string"},"login_timeout":{"description":"Timeout (in seconds) during which the user cannot log in to the system because of security policies.","required":true,"type":"number"}},"description":"User account.","type":"object","id":"User","example":{"last_authentication":1352313328,"first_name":"Jonh","last_name":"Smith","authorization_type":"Local","username":"admin","enabled":true,"view_user_information":true,"authentication_type":"Local","last_login":1352313328,"login_timeout":900,"role":"Administrator","last_access":1352313328,"id":123}},"httpmethod":"PUT","formats":["xml","json"],"authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"users/{user_id}","authorization":"required"},"Re-authenticate user":{"description":"Re-authenticate user account. Requires basic authentication.","httpmethod":"GET","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"users/re_authenticate","authorization":"required"},"Get user":{"description":"User account by user ID.","response":{"properties":{"enabled":{"description":"Boolean flag indicating if the user account is enabled.","required":true,"type":"string"},"last_name":{"description":"Last name of the user.","required":true,"type":"string"},"id":{"description":"Numeric ID of the user that the system uses internally and in the API.","required":true,"type":"number"},"last_login":{"description":"Time of last login. Unix time (epoch).","required":true,"type":"number"},"authentication_type":{"description":"Type of authentication for the user, such as Local or RADIUS.","required":true,"type":"string","enum":["Local","Remote","SAML"]},"username":{"description":"User name (short name) that identifies the user to the system, such as 'admin'.","required":true,"type":"string"},"authorization_type":{"description":"Type of authorization for the user, such as Local or RADIUS.","required":true,"type":"string","enum":["Local","Remote"]},"role":{"description":"Role of the user. Defines permissions.","required":true,"type":"string","enum":["Developer","Administrator","Operator","Monitor","Event_Viewer","Dashboard_Viewer","Restricted","Shared_Link_Viewer"]},"first_name":{"description":"First name of the user.","required":true,"type":"string"},"edit_dashboards":{"description":"Boolean flag indicating if the user has permission to administrate dashboards.","required":false,"type":"string"},"traffic_filter":{"description":"Traffic expression. Only applicable to Restricted role.","required":false,"type":"string"},"last_access":{"description":"Time of last access to the system. Unix time (epoch).","required":true,"type":"number"},"view_packet_details":{"description":"Boolean flag indicating if the user has access to packet data.","required":false,"type":"string"},"last_authentication":{"description":"Time of last authentication. Unix time (epoch).","required":true,"type":"number"},"auto_resolution":{"description":"Force to use auto resolution. Only applicable to Restricted role.","required":false,"type":"string"},"view_user_information":{"description":"Boolean flag indicating if the user has access to identity information, such as Active Directory information.","required":false,"type":"string"},"login_timeout":{"description":"Timeout (in seconds) during which the user cannot log in to the system because of security policies.","required":true,"type":"number"}},"description":"User account.","type":"object","id":"User","example":{"last_authentication":1352313328,"first_name":"Jonh","last_name":"Smith","authorization_type":"Local","username":"admin","enabled":true,"view_user_information":true,"authentication_type":"Local","last_login":1352313328,"login_timeout":900,"role":"Administrator","last_access":1352313328,"id":123}},"httpmethod":"GET","formats":["xml","json"],"authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"users/{user_id}","authorization":"required"},"[Missing resource 'POST:/api/gateway/1.5/users' in bundle 'rest_short_info']":{"description":"[Missing resource 'POST:/api/gateway/1.5/users' in bundle 'rest_info']","request":{"properties":{"last_name":{"description":"Last name of the user.","required":false,"type":"string"},"new_password":{"properties":{"cleartext":{"description":"Set the user's password in plain text.","required":true,"type":"string"}},"description":"Set the user's password.","required":true,"type":"object","id":"NewUserPass"},"username":{"description":"User name (short name) that identifies the user to the system, such as 'admin'.","required":true,"type":"string"},"role":{"description":"Role of the user. Defines permissions.","required":true,"type":"string","enum":["Developer","Administrator","Operator","Monitor","Event_Viewer","Dashboard_Viewer","Restricted","Shared_Link_Viewer"]},"first_name":{"description":"First name of the user.","required":false,"type":"string"},"edit_dashboards":{"description":"Boolean flag indicating if the user has permission to administrate dashboards.","required":false,"type":"string"},"traffic_filter":{"description":"Traffic expression. Only applicable to Restricted role.","required":false,"type":"string"},"view_packet_details":{"description":"Boolean flag indicating if the user has access to packet data.","required":false,"type":"string"},"strict_password_exempt":{"description":"Boolean flag indicating if the user is exempt from strict password requirements.","required":false,"type":"string"},"auto_resolution":{"description":"Force to use auto resolution. Only applicable to Restricted role.","required":false,"type":"string"},"view_user_information":{"description":"Boolean flag indicating if the user has access to identity information, such as Active Directory information.","required":false,"type":"string"}},"description":"Create User account object.","type":"object","id":"UserCreate","example":{"username":"myuser","first_name":"Jonh","last_name":"Smith","new_password":{"cleartext":"mypassword"},"role":"Administrator","view_user_information":true}},"response":{"properties":{"enabled":{"description":"Boolean flag indicating if the user account is enabled.","required":true,"type":"string"},"last_name":{"description":"Last name of the user.","required":true,"type":"string"},"id":{"description":"Numeric ID of the user that the system uses internally and in the API.","required":true,"type":"number"},"last_login":{"description":"Time of last login. Unix time (epoch).","required":true,"type":"number"},"authentication_type":{"description":"Type of authentication for the user, such as Local or RADIUS.","required":true,"type":"string","enum":["Local","Remote","SAML"]},"username":{"description":"User name (short name) that identifies the user to the system, such as 'admin'.","required":true,"type":"string"},"authorization_type":{"description":"Type of authorization for the user, such as Local or RADIUS.","required":true,"type":"string","enum":["Local","Remote"]},"role":{"description":"Role of the user. Defines permissions.","required":true,"type":"string","enum":["Developer","Administrator","Operator","Monitor","Event_Viewer","Dashboard_Viewer","Restricted","Shared_Link_Viewer"]},"first_name":{"description":"First name of the user.","required":true,"type":"string"},"edit_dashboards":{"description":"Boolean flag indicating if the user has permission to administrate dashboards.","required":false,"type":"string"},"traffic_filter":{"description":"Traffic expression. Only applicable to Restricted role.","required":false,"type":"string"},"last_access":{"description":"Time of last access to the system. Unix time (epoch).","required":true,"type":"number"},"view_packet_details":{"description":"Boolean flag indicating if the user has access to packet data.","required":false,"type":"string"},"last_authentication":{"description":"Time of last authentication. Unix time (epoch).","required":true,"type":"number"},"auto_resolution":{"description":"Force to use auto resolution. Only applicable to Restricted role.","required":false,"type":"string"},"view_user_information":{"description":"Boolean flag indicating if the user has access to identity information, such as Active Directory information.","required":false,"type":"string"},"login_timeout":{"description":"Timeout (in seconds) during which the user cannot log in to the system because of security policies.","required":true,"type":"number"}},"description":"User account.","type":"object","id":"User","example":{"last_authentication":1352313328,"first_name":"Jonh","last_name":"Smith","authorization_type":"Local","username":"admin","enabled":true,"view_user_information":true,"authentication_type":"Local","last_login":1352313328,"login_timeout":900,"role":"Administrator","last_access":1352313328,"id":123}},"httpmethod":"POST","formats":["xml","json"],"authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"users","authorization":"required"},"Test RADIUS user":{"description":"Test a RADIUS user.","parameters":{"password":{"required":true,"type":"string","description":"RADIUS password."},"username":{"required":true,"type":"string","description":"RADIUS username."}},"request":{"properties":{"password":{"description":"password.","required":true,"type":"string"},"username":{"description":"user name.","required":true,"type":"string"}},"description":"RemoteTestUserRequest object.","type":"object","id":"RemoteTestUserRequest","example":{"username":"testusername","password":"testpassword"}},"response":{"properties":{"role_id":{"description":"Matched role ID.","required":true,"type":"number"},"error_message":{"description":"Error message.","required":true,"type":"string"},"server_type":{"description":"Indicates the type of the server being tested: RADIUS(2) or TACACS+(3).","required":true,"type":"number"},"role":{"description":"Matched role name.","required":true,"type":"string"},"permissions":{"description":"Remote permissions.","items":{"properties":{"permission":{"description":"Matched permission name.","required":true,"type":"string"},"permission_id":{"description":"Matched permission ID.","required":true,"type":"string"}},"description":"Remote permissions.","required":false,"type":"object","id":"RemotePermission"},"required":false,"type":"array","id":"RemotePermissions"},"details":{"description":"Remote user test details.","required":true,"type":"string"},"server_ip":{"description":"Remote Server IP address.","required":true,"type":"string"},"authenticated":{"description":"Flag indicating if the remote user was authenticated.","required":true,"type":"string"},"attributes":{"description":"Attributes of Remote Test User Response.","items":{"description":"Remote attribute.","required":false,"additionalProperties":{"description":"Remote attribute value.","required":false,"xmlKeyName":"key","type":"string"},"type":"object","id":"RemoteAttributes"},"required":false,"type":"array","id":"RemoteAttributesList"},"authorized":{"description":"Flag indicating if the remote user was authorized (as Administrator, Monitor, etc).","required":true,"type":"string"}},"description":"RemoteTestUserResponse object.","type":"object","id":"RemoteTestUserResponse"},"httpmethod":"POST","formats":["xml","json"],"authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"users/radius/test_user","authorization":"required"},"Test TACACS+ server":{"description":"Test the connection to a TACACS+ server.","parameters":{"port":{"required":false,"type":"string","description":"Unsupported."},"server":{"required":true,"type":"string","description":"TACACS+ server identifier, example server=IP:PORT."}},"response":{"properties":{"success":{"description":"Flag indicating if the remote server test was successful.","required":true,"type":"string"},"message":{"description":"Response message.","required":true,"type":"string"}},"description":"RemoteTestServerResponse object.","type":"object","id":"RemoteTestServerResponse","example":{"message":"Connection attempt succeeded","success":true}},"httpmethod":"GET","formats":["xml","json"],"authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"users/tacacs/test_server","authorization":"required"},"Test TACACS+ user":{"description":"Test a TACACS+ user.","parameters":{"password":{"required":true,"type":"string","description":"TACACS+ password."},"username":{"required":true,"type":"string","description":"TACACS+ username."}},"request":{"properties":{"password":{"description":"password.","required":true,"type":"string"},"username":{"description":"user name.","required":true,"type":"string"}},"description":"RemoteTestUserRequest object.","type":"object","id":"RemoteTestUserRequest","example":{"username":"testusername","password":"testpassword"}},"response":{"properties":{"role_id":{"description":"Matched role ID.","required":true,"type":"number"},"error_message":{"description":"Error message.","required":true,"type":"string"},"server_type":{"description":"Indicates the type of the server being tested: RADIUS(2) or TACACS+(3).","required":true,"type":"number"},"role":{"description":"Matched role name.","required":true,"type":"string"},"permissions":{"description":"Remote permissions.","items":{"properties":{"permission":{"description":"Matched permission name.","required":true,"type":"string"},"permission_id":{"description":"Matched permission ID.","required":true,"type":"string"}},"description":"Remote permissions.","required":false,"type":"object","id":"RemotePermission"},"required":false,"type":"array","id":"RemotePermissions"},"details":{"description":"Remote user test details.","required":true,"type":"string"},"server_ip":{"description":"Remote Server IP address.","required":true,"type":"string"},"authenticated":{"description":"Flag indicating if the remote user was authenticated.","required":true,"type":"string"},"attributes":{"description":"Attributes of Remote Test User Response.","items":{"description":"Remote attribute.","required":false,"additionalProperties":{"description":"Remote attribute value.","required":false,"xmlKeyName":"key","type":"string"},"type":"object","id":"RemoteAttributes"},"required":false,"type":"array","id":"RemoteAttributesList"},"authorized":{"description":"Flag indicating if the remote user was authorized (as Administrator, Monitor, etc).","required":true,"type":"string"}},"description":"RemoteTestUserResponse object.","type":"object","id":"RemoteTestUserResponse"},"httpmethod":"POST","formats":["xml","json"],"authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"users/tacacs/test_user","authorization":"required"},"Test RADIUS server":{"description":"Test the connection to a RADIUS server.","parameters":{"port":{"required":false,"type":"string","description":"Unsupported."},"server":{"required":true,"type":"string","description":"RADIUS server identifier, example server=IP:PORT."}},"response":{"properties":{"success":{"description":"Flag indicating if the remote server test was successful.","required":true,"type":"string"},"message":{"description":"Response message.","required":true,"type":"string"}},"description":"RemoteTestServerResponse object.","type":"object","id":"RemoteTestServerResponse","example":{"message":"Connection attempt succeeded","success":true}},"httpmethod":"GET","formats":["xml","json"],"authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"path":"users/radius/test_server","authorization":"required"}}}},"description":"\u003Ch2\u003EOverview\u003C/h2\u003E\n\n\u003Cp\u003E\nThe documentation pages in this section describe\nthe RESTful APIs included with Gateway products. It is assumed \nthat the reader has practical knowledge of\nRESTful APIs, so the documentation does not go into detail about what\nREST is and how to use it. Instead the documentation focuses on what\ndata can be accessed and how to access it.\n\u003C/p\u003E\n\n\u003Cp\u003E\nThe following information can be accessed via the API:\n\u003C/p\u003E\n\u003Cul\u003E\n  \u003Cli\u003EPerform System operations\u003C/li\u003E \n  \u003Cli\u003EInformation about system users\u003C/li\u003E\n\u003C/ul\u003E\n\n\u003Cp\u003E\nDetails about REST resources can be found in the \u003Cb\u003EResources\u003C/b\u003E\nsection. This overview continues with how to run reports and retrieve\ndata from them.\n\u003C/p\u003E\n\n\u003Ch2\u003EAuthentication\u003C/h2\u003E\n\n\u003Cp\u003E\nAll REST requests must be authenticated. The \u003Cb\u003EAuthentication\u003C/b\u003E\nsection of the Common 1.0 API describes which authentication methods\nare presently supported. There are also examples that show how to use\neach of the different authentication methods.\n\u003C/p\u003E\n\n"}