topic Re: AsyncOS API in DevNet General Discussions

AsyncOS API

tblack1100 — Mon, 25 Mar 2019 20:02:52 GMT

Where can I find more information on the AsyncOS API? Specifically, attribute usage for the Top-N reports.

Re: AsyncOS API

amoherek — Fri, 10 Apr 2015 17:12:26 GMT

Hi Tim,

I'm not finding any DevNet pages on AsyncOS API. However, you might want to check this API guide: http://www.cisco.com/c/dam/en/us/td/docs/security/esa/esa9-0/ESA_API_1-0_Getting_Started_Guide.pdf

Thanks,

Adrienne

Re: AsyncOS API

tblack1100 — Fri, 10 Apr 2015 17:23:18 GMT

Thanks! That’s the only information I’ve have found regarding this API.

I’ve slowly discovered how to use the web service methods for what I need right now, but it would be nice to find some additional info.

Re: AsyncOS API

srg1 — Mon, 13 Apr 2015 11:53:00 GMT

Hi Tim,

The Getting started guide has an example of Top-N reports on page 11. Please elaborate if that does not help or if you are looking for something different.

For quick reference, jotting down another sample top-n report to list virus-types seen in the last 24 hours.

Sample curl request:

curl -sk -u <user:passwd> https://<esa-fqdn>:6443/api/v1.0/stats/mail_virus_type_detail?1d

Response from a lab ESA:

{

"data": {

"incoming_total_recipients": {

"Troj/Iframe-Y": 10,

"W32/Klez-H": 10

"outgoing_total_recipients": {},

"total_recipients": {

"Troj/Iframe-Y": 10,

"W32/Klez-H": 10

}

"uri": "/api/v1.0/stats/mail_virus_type_detail?1d"

}

thanks,

Sriram

Re: AsyncOS API

tblack1100 — Mon, 13 Apr 2015 12:06:53 GMT

Thanks, I figured it out.