MIMIC REST API
  1. Agent
MIMIC REST API
  • Access
    • Adds/Overwrites the user entry in the access control database.
    • Clears a users entry from access control database.
    • Returns the current access control database in use.
    • Returns the current admin directory.
    • Returns the current administrator.
    • Returns the state of access control checking.
    • Returns an array of entries.
    • Loads the specified file for access control data.
    • Saves current access control data in specified file.
    • Allows setting the name of the current access control database.
    • Allows the user to enable/disable the access control check.
  • Agent
    • Add an agent.
      POST
    • Add a source address that the agent will accept messages from.
      POST
    • delete a source address that the agent will accept messages from.
      DELETE
    • List the source addresses that the agent will accept messages from.
      GET
    • has the agent value space changed?
      GET
    • has the lab configuration changed?
      GET
    • one-way transit delay in msec.
      GET
    • drop rate (every N-th PDU). 0 means no drops.
      GET
    • host address of the agent.
      GET
    • timeout in seconds for retransmitting INFORM PDUs.
      GET
    • network interface card for the agent.
      GET
    • subnet mask of the agent.
      GET
    • set of MIBs, simulations and scenarios
      GET
    • number of starts for the agent.
      GET
    • MIB directory of the agent.
      GET
    • owner of the agent.
      GET
    • maximum PDU size.
      GET
    • port number
      GET
    • private directory of the agent.
      GET
    • protocols supported by agent
      GET
    • read community string
      GET
    • first scenario name
      GET
    • first simulation name
      GET
    • relative start time
      GET
    • current running state of the agent
      GET
    • has the agent state changed?
      GET
    • current statistics of the agent instance
      GET
    • SNMP PDU tracing
      GET
    • SNMP SET validation policy.
      GET
    • write community string
      GET
    • Halt the current agent.
      PUT
    • Adds a new ipalias for the agent.
      POST
    • Deletes an existing ipalias from the agent.
      DELETE
    • Lists all the additional ipaliases configured for the agent.
      GET
    • Starts an existing ipalias for the agent.
      PUT
    • Returns the status (0=down, 1=up) of an existing ipalias for the agent.
      GET
    • Stops an existing ipalias for the agent.
      PUT
    • Pause the current agent.
      PUT
    • Returns the protocol's configuration.
      GET
    • Reload the current agent.
      PUT
    • Remove the current agent.
      DELETE
    • Resume the current agent.
      PUT
    • Save agent MIB values.
      PUT
    • one-way transit delay in msec
      PUT
    • drop rate (every N-th PDU)
      PUT
    • host address of the agent.
      PUT
    • timeout in seconds for retransmitting INFORM PDUs
      PUT
    • network interface card for the agent
      PUT
    • subnet mask of the agent.
      PUT
    • set of MIBs, simulations and scenarios
      PUT
    • MIB directory of the agent.
      PUT
    • owner of the agent
      PUT
    • maximum PDU size
      PUT
    • port number
      PUT
    • private directory of the agent.
      PUT
    • protocols supported by agent as a comma-separated list
      PUT
    • read community string
      PUT
    • relative start time
      PUT
    • SNMP PDU tracing
      PUT
    • SNMP SET validation policy
      PUT
    • write community string
      PUT
    • Start the current agent.
      PUT
    • Show the agent's primary IP address
      PUT
    • This command copies the variable store from the other agent to this agent.
      PUT
    • This command can be used as a predicate to ascertain the existence of a given variable.
      GET
    • Fetches the value associated with a variable.
      GET
    • This command will return the list of variables in the said scope.
      GET
    • These commands treat the variable as a list, and allow to replace an entry in the list at the specified index with the specified value. The variable has to already exist.
      PUT
    • This command can be used as a predicate to ascertain the persistence of a given variable.
      GET
    • These commands allow the creation of a new variable, or changing an existing value.
      PUT
    • Deletes a variable which is currently defined.
      PUT
    • Add a new timer script to be executed at specified interval (in msec) with the specified argument.
      POST
    • Remove a timer script from the execution list.
      DELETE
    • List the timer scripts currently running along with the their intervals.
      GET
    • Add a trap destination to the set of destinations.
      POST
    • Remove a trap destination from the set of destinations.
      DELETE
    • List the set of trap destinations for this agent instance.
      GET
    • List the outstanding asynchronous traps for this agent instance.
      GET
  • COAP
    • Show the agent's COAP argument structure
    • Show the agent's COAP configuration
    • Show the agent's COAP statistics
    • Show the agent's COAP traffic tracing
    • Set the agent's COAP configuration
    • Set the agent's COAP traffic tracing
    • Show the COAP statistics headers
  • DHCP
    • Show the agent's DHCP argument structure
    • Show the agent's DHCP configuration
    • Show the agent's DHCP statistics
    • Show the agent's DHCP traffic tracing
    • Show the parameters configured by the server in its DHCP-OFFER message
    • Set the agent's DHCP configuration
    • Set the agent's DHCP traffic tracing
    • Show the DHCP statistics headers
  • IPMI
    • Show the agent's IPMI argument structure
    • Show the agent's IPMI configuration
    • Show the agent's IPMI statistics
    • Show the agent's IPMI traffic tracing
    • Show the outgoing message's attributes
    • Set the agent's IPMI configuration
    • Set the agent's IPMI traffic tracing
    • Set the outgoing message's attributes
    • Show the IPMI statistics headers
  • MQTT
    • Show the agent's MQTT TCP connection state
    • Show the agent's MQTT state
    • Show the agent's current messages' cardinality
    • Show the agent's message attributes
    • Set the agent's message attributes
    • Restart receiving messages from a subcription of the agent
    • Abort agent's MQTT TCP session without sending DISCONNECT command
    • Start agent's MQTT TCP session
    • Disconnect agent's MQTT TCP session by sending DISCONNECT command
    • Set the agent's MQTT TCP connection target broker
    • Set the agent's MQTT session
    • Set the agent's MQTT client ID
    • Set the agent's MQTT TCP keepalive
    • Set the agent's MQTT disconnection action
    • Set the agent's MQTT client password
    • Set the agent's MQTT TCP connection target port
    • Set the agent's MQTT client username
    • Set the agent's MQTT client's will
    • Set the agent's MQTT will message's QOS field
    • Set the agent's MQTT retained will
    • Set the agent's MQTT client will's topic
    • Show the agent's current subscriptions' cardinality
    • Show the agent's subscription attributes
    • Set the agent's subscribe attributes
    • Stops receiving messages from a subcription of the agent
    • Show the agent's MQTT argument structure
    • Show the agent's MQTT configuration
    • Show the agent's MQTT statistics
    • Show the agent's MQTT traffic tracing
    • Set the agent's MQTT configuration
    • Set the agent's MQTT traffic tracing
    • Show the MQTT statistics headers
  • NETFLOW
    • Change NETFLOW data export interval
    • Change NETFLOW template export interval
    • Change NETFLOW export attributes
    • Show list of NETFLOW exports
    • Show the agent's NETFLOW argument structure
    • Show the agent's NETFLOW configuration
    • Show the agent's NETFLOW statistics
    • Show the agent's NETFLOW traffic tracing
    • Halt NETFLOW traffic
    • Reload NETFLOW configuration before resuming traffic
    • Resuming traffic
    • Swap NETFLOW collector
    • Set the agent's NETFLOW configuration
    • Swap NETFLOW configuration file
    • Set the agent's NETFLOW traffic tracing
    • Show the NETFLOW statistics headers
  • PROXY
    • Show the agent's PROXY argument structure
    • Show the agent's PROXY configuration
    • Show the agent's PROXY statistics
    • Show the agent's PROXY traffic tracing
    • Add individual proxy target on the agent and the simulator host
    • Check individual target
    • List all proxy targets
    • Remove individual proxy target on the agent and the simulator host
    • Start additional target
    • Stop additional target
    • Set the agent's PROXY configuration
    • Set the agent's PROXY traffic tracing
    • Show the PROXY statistics headers
  • SFLOW
    • Show the agent's SFLOW argument structure
    • Show the agent's SFLOW configuration
    • Show the agent's SFLOW statistics
    • Show the agent's SFLOW traffic tracing
    • Halt SFLOW traffic
    • Reload SFLOW configuration before resuming traffic
    • Resuming traffic
    • Set the agent's SFLOW configuration
    • Set the agent's SFLOW traffic tracing
    • Show the SFLOW statistics headers
  • SNMPTCP
    • Show the agent's SNMPTCP argument structure
    • Show the agent's SNMPTCP configuration
    • Show the agent's SNMPTCP statistics
    • Show the agent's SNMPTCP traffic tracing
    • Disable individual IP aliases on the agent and the simulator host
    • Enable individual IP aliases on the agent and the simulator host
    • Check individual IP aliases on the agent and the simulator host
    • List all IP aliases on the agent and the simulator host
    • Set the agent's SNMPTCP configuration
    • Set the agent's SNMPTCP traffic tracing
    • Show the SNMPTCP statistics headers
  • SNMPv3
    • Adds a new access entry with the specified parameters.
    • Clears all access entries.
    • Deletes the specified access entry.
    • Returns the current acccess entries as an array of strings.
    • Returns the SNMPv3 configuration.
    • Retrieves the contextEngineID for the agent instance.
    • Retrieves the number of times the agent has been restarted.
    • For started agents, retrieves the current engineID in use by the snmpv3 module.
    • Retrieves the time in seconds for which the agent has been running.
    • Adds a new group entry with the specified parameters.
    • Clears all group entries.
    • Deletes the specified group entry.
    • Returns the current group entries as an array of strings.
    • Changes the SNMPv3 configuration.
    • Adds a new user entry with the specified parameters.
    • Clears all user entries.
    • Deletes the specified user entry.
    • Returns the current user entries as a Tcl list.
    • Saves current user settings in the currently loaded USM config file.
    • Saves current user settings in the specified USM config file.
    • Saves current group, access, view settings in the currently loaded VACM config file.
    • Saves current group, access, view settings in the specified VACM config file.
    • Adds a new view entry with the specified parameters.
    • Clears all view entries.
    • Deletes the specified view entry.
    • Returns the current view entries as an array of strings.
  • SSH
    • Show the agent's SSH argument structure
    • Show the agent's SSH configuration
    • Show the agent's SSH statistics
    • Show the agent's SSH traffic tracing
    • Disable individual IP aliases on the agent and the simulator host
    • Enable individual IP aliases on the agent and the simulator host
    • Check individual IP aliases on the agent and the simulator host
    • List all IP aliases on the agent and the simulator host
    • Set the agent's SSH configuration
    • Set the agent's SSH traffic tracing
    • Show the SSH statistics headers
  • SYSLOG
    • Show the agent's SYSLOG argument structure
    • Show the agent's SYSLOG configuration
    • Show the agent's SYSLOG statistics
    • Show the agent's SYSLOG traffic tracing
    • Show the outgoing message's attributes
    • Set the agent's SYSLOG traffic tracing
    • Set the agent's SYSLOG configuration
    • Set the agent's SYSLOG traffic tracing
    • Set the outgoing message's attributes
    • Show the SYSLOG statistics headers
  • TELNET
    • Changes the connection's current logon.
    • Executes the command asynchronously .
    • Triggers the asynchronous signal event with the specified signal name
    • Show the agent's TELNET argument structure
    • Show the agent's TELNET configuration
    • Show the agent's TELNET statistics
    • Show the agent's TELNET traffic tracing
    • Disable individual IP aliases on the agent and the simulator host
    • Enable individual IP aliases on the agent and the simulator host
    • Check individual IP aliases on the agent and the simulator host
    • List all IP aliases on the agent and the simulator host
    • Show the agent's TELNET connections
    • Show the agent's TELNET keymap file name
    • Show the agent's TELNET rules db file name
    • Show the agent's TELNET server state
    • Show the agent's TELNET user db file name
    • Show the agent's TELNET users
    • Set the agent's TELNET configuration
    • Set the agent's TELNET traffic tracing
    • Show the TELNET statistics headers
  • TFTP
    • Show the agent's TFTP argument structure
    • Show the agent's TFTP configuration
    • Show the agent's TFTP statistics
    • Show the agent's TFTP traffic tracing
    • Create a read session to download srcfile from server
    • Create a read session to upload srcfile to server
    • Set the agent's TFTP configuration
    • Set the agent's TFTP traffic tracing
    • Show a parameter of a TFTP sesssion
    • Set a parameter of a TFTP sesssion
    • Start a TFTP sesssion
    • Check a TFTP sesssion's status
    • Stop a TFTP sesssion
    • Show the TFTP statistics headers
  • TOD
    • Show the agent's TOD argument structure
    • Show the agent's TOD configuration
    • Show the agent's TOD statistics
    • Show the agent's TOD traffic tracing
    • Retrieve TOD time
    • Set the agent's TOD configuration
    • Set the agent's TOD traffic tracing
    • Show the TOD statistics headers
  • WEB
    • Show the agent's WEB argument structure
    • Show the agent's WEB configuration
    • Show the agent's WEB statistics
    • Show the agent's WEB traffic tracing
    • Add the agent's WEB port
    • Show the agent's WEB port
    • Remove the agent's WEB port
    • Set the agent's WEB port attribute
    • Start the agent's WEB port
    • Stop the agent's WEB port
    • Set the agent's WEB configuration
    • Set the agent's WEB traffic tracing
    • Show the WEB statistics headers
  • Valuespace
    • Add an entry to a table.
    • Evaluate the values of the specified instance instance for each specified MIB object object and return it as it would through SNMP requests.
    • Get a variable in the Value Space.
    • Return the syntactical information for the specified object, such as type, size, range, enumerations, and ACCESS.
    • Display the MIB object instances for the specified object.
    • Display the MIB objects below the current position
    • Evaluate the values of the specified instance instance for each specified MIB object object and return it as it would through SNMP requests.
    • Get multiple variables in the Value Space.
    • Return the MIB that defines the specified object.
    • Set multiple variables in the Value Space.
    • Unset multiple variables in the Value Space
    • Return the symbolic name of the specified object identifier.
    • Return the numeric OID of the specified object.
    • Remove an entry from a table.
    • Set a variable in the Value Space.
    • Split the numerical OID into the object OID and instance OID.
    • Get the state of a MIB object object.
    • Set the state of a MIB object object
    • Unset a variable in the Value Space in order to free its memory.
    • Display the variables for the specified instance instance for the specified MIB object object
  • Daemon
    • Clear the lab configuration.
    • The list of {agentnum {statistics}} for agents that are currently active and whose statistics have changed since the last invocation of this command.
    • The list of {agentnum} that are currently active (running or paused).
    • The currently loaded lab configuration file for the particular user.
    • This predicate indicates if the currently loaded agent configuration file has changed.
    • The list of {agentnum} for which a configurable parameter changed.
    • The list of {agentnum state} for which the state changed.
    • The number of clients currently connected to the daemon.
    • The list of {agentnum} that are currently configured.
    • The set of network interfaces that can be used for simulations.
    • The last configured agent instance.
    • The current log file for the Simulator.
    • The maximum number of agent instances.
    • The network address of the host where the MIMIC simulator is running.
    • The default network device to be used for agent addresses.
    • The product number that is licensed.
    • The set of protocols supported by the Simulator.
    • The return mode.
    • The version of the MIMIC command interface.
    • Load the lab configuration file file.
    • Get multiple sets of information about MIMIC, where infoArray is one of the parameters defined in the mimic get command.
    • Save the lab configuration.
    • Save the lab configuration in file.
    • The current log file for the Simulator.
    • The network address of the host where the MIMIC simulator is running.
    • This operation flushes all global objects which need to be made persistent to disk.
    • Start MIMIC.
    • Stop MIMIC.
    • This command can be used as a predicate to ascertain the existence of a given variable.
    • Fetches the value associated with a variable.
    • This command will return the list of variables in the said scope.
    • These commands treat the variable as a list, and allow to replace an entry in the list at the specified index with the specified value. The variable has to already exist.
    • This command can be used as a predicate to ascertain the persistence of a given variable.
    • Set the variable store for the global storage
    • Deletes a variable which is currently defined.
    • Terminate the MIMIC daemon.
    • Add a new timer script to be executed at specified interval (in msec) with the specified argument.
    • Remove a timer script from the execution list.
    • List the timer scripts currently running along with the their intervals.
  1. Agent

Add a source address that the agent will accept messages from.

http://gambitcomm.local
http://gambitcomm.local
http://gambitcomm.local
http://gambitcomm.local
POST
/mimic/agent/{agentNum}/from/add/{IP}/{port}
An empty ipaddress or 0.0.0.0 both imply any address. Similarly an empty port or 0 both imply any port. For agents with source-address-indexing enabled, messages which do not match any source address will be discarded with an ERROR message, similar to community string mismatches.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://gambitcomm.local/mimic/agent//from/add//'
Response Response Example
200 - Example 1
"string"

Request

Path Params

Responses

🟢200successful operation
application/json
Body

🟠400Invalid agent number value
Modified at 2022-09-10 22:56:54
Previous
Add an agent.
Next
delete a source address that the agent will accept messages from.
Built with