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

Reload the current agent.

http://gambitcomm.local
http://gambitcomm.local
http://gambitcomm.local
http://gambitcomm.local
PUT
/mimic/agent/{agentNum}/reload
This only works for halted agents. The net effect is the same as restarting an agent (ie. stop, start, halt), but without disconnecting the network (and thus existing connections).
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'http://gambitcomm.local/mimic/agent//reload'
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
Returns the protocol's configuration.
Next
Remove the current agent.
Built with