AsyncOS API

[tblack1100]

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

[amoherek]

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

[tblack1100]

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.

[srg1]

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

[tblack1100]

Thanks, I figured it out.