Cisco Cisco ASA 5555-X Adaptive Security Appliance

About the ASA REST API v1.2.1 
Monitoring 

 

Monitoring 

These REST APIs can be used to get health, performance and REST agent monitoring statistics.  

In multi-context mode, to get monitoring statistics for a given context, including the System context, append a query 

with a 'context' parameter: https: //<asa_admin_context_ip>/api/cli?context=<context_name>. If the ‘context’ query 

parameter is not present in a monitoring request, the REST agent attempts to determine the target context on its own. 

For resources that are available only in the System context, such as the CPU process usage, the request is directed to 
the System context. The rest of the commands are directed to the admin context. 

For cluster member and resource usage info, queries should be made to the cluster master only. 

Multi-context mode 

Multi-context mode support is limited to the Generic CLI Command Executer API, Token Authentication API and 

monitoring.  At this time, REST API does not support configuring an ASA in multi-context mode, except via the CLI 

command executer API. 

•  The REST agent can be enabled in multi-context mode. The REST agent CLIs are present only in the System 

context.  

•  If token authentication is used, you need to get the authentication token via https: 

//<asa_admin_context_ip>/api/tokenservices before issuing any REST API commands. 

Note that the token received for the admin context can be used to configure/monitor any other context as well.  

•  Generic CLI Command Executer API can be used to configure any context as https: 

//<asa_admin_context_ip>/api/cli?context=<context_name>. If the ‘context’ query parameter is not present, the 

request is directed to the admin context.  

•  If the ‘context’ query parameter is not present in a monitoring request, the REST agent attempts to determine 

the target context on its own.  For resources that are available only in the System context, such as the CPU 

process usage, the request is directed to the System context.  The rest of the commands are directed to the 

admin context. 

Limitations: 

REST API commands are available only in the System context. The REST agent must be restarted when ASA is switched 

from single- to multiple-context mode or vice versa. 

NTP 

Limitations: 

N/A