Cisco Cisco ASA 5525-X Adaptive Security Appliance - No Payload Encryption
About the ASA REST API v1.2.1
Monitoring
Monitoring
21
Monitoring
/api/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.
the System context. The rest of the commands are directed to the admin context.
Limitations:
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.
Notes:
• 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
/api/devicesetup/ntp/
Limitations:
N/A