Therefore, be aware that large running configurations can produce exceptions in various memory-intensive situations such asĪ large number of concurrent requests, or large request volumes. The Rest API limits are 450 KB and 500 KB for the ASAv5 and ASAv10, respectively. Total memory on the ASAv5 can be 1.5 GB, while The ASA Rest API also has memory constraints on the virtual ASA platforms. Maximum supported running configuration size has increased over the release cycle to approximately 2 MB on The ASA Rest API is an “on-board” application running inside the physical ASA, and as such has a limitation on the memoryĪllocated to it. The JSON error/warning response schema is as follows:ĭetailed message corresponding to Error/Warning/Info In the case of an error, in addition to the error code, the return response may include an error object containing more detailsĪbout the error. For example, an HTTP DELETE may fail because the resource is unavailable.Ĥ05 Method not Allowed – An HTTP request was presented that is not allowed on the resource for example, a POST on a read-only resource.ĥxx - A five-hundred series code indicates a server-side error. Available codes fall into these categories:Ģ0x - A two-hundred series code indicates successful operation, including:Ģ00 OK – Standard response for successful requests.Ģ01 Created – Request completed new resource created.Ģ02 Accepted– Request accepted, but processing not complete.Ģ04 No Content– Server successfully processed request no content is being returned.Ĥxx - A four-hundred series code indicates a client-side error, including:Ĥ00 Bad Request – Invalid query parameters, including unrecognized parameters, missing parameters, or invalid values.Ĥ04 Not Found – The provided URL does not match an existing resource. LOCATION – Newly created resource ID for POST only-holds the new resource ID (as a URI representation).ĬONTENT-TYPE – Media type describing the response message body describes the representation and syntax of the response messageĮach response includes an HTTP status or error code. PATCH – Applies partial modifications to the specified object.Įach request produces an HTTPS response from the ASA with the standard headers, response content, and status code. POST – Creates the object with the supplied information. PUT – Adds the supplied information to the specified object returns a 404 Resource Not Found error if the object does not GET – Retrieves data from the specified object. This section provides an overview of how requests are structured, and the expected responses, Request Structure On the HTTPS protocol and REST methodology.Īll API requests are sent over HTTPS to the ASA, and a response is returned. The API allows external clients to perform CRUD (Create, Read, Update, Delete) operations on ASA resources it is based The ASA REST API gives you programmatic access to managing individual ASAs through a Representational State Transfer (REST)ĪPI. To access current configuration information, and issue additional configuration parameters. Interface (API), based on “RESTful” principles, which you can quickly download and enable on any ASA on which the API is running.Īfter installing a REST client in your browser, you can contact the specific ASA’s REST agent and use standard HTTP methods With the release of Cisco’s ASA REST API, you now have another light-weight, easy-to-use option. Use to configure, manage and monitor an ASA.Ĭisco Security Manager – while intended for medium to large networks of many security devices, this graphical applicationĬan be used to configure, manage and monitor individual ASAs. Several options are available for configuring and managing individual Cisco ASAs:Ĭommand Line Interface (CLI) – you send control commands directly to the ASA via a connected console.Īdaptive Security Device Manager (ASDM) – an “on-box” management application with a graphical user interface that you can
0 Comments
Leave a Reply. |
Details
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |