{"restSchemaVersion":"1.0","errors":[{"error_id":"INTERNAL_ERROR","description":"Internal server error.","http_status":"500"},{"error_id":"AUTH_REQUIRED","description":"The requested resource requires authentication.","http_status":"401"},{"error_id":"AUTH_INVALID_CREDENTIALS","description":"Invalid username and\/or password.","http_status":"401"},{"error_id":"AUTH_INVALID_SESSION","description":"Session ID is invalid.","http_status":"401"},{"error_id":"AUTH_EXPIRED_PASSWORD","description":"The password must be changed. Access only to password change resources.","http_status":"403"},{"error_id":"AUTH_DISABLED_ACCOUNT","description":"Account is either temporarily or permanently disabled.","http_status":"403"},{"error_id":"AUTH_FORBIDDEN","description":"User is not authorized to access the requested resource.","http_status":"403"},{"error_id":"AUTH_INVALID_TOKEN","description":"OAuth access token is invalid.","http_status":"401"},{"error_id":"AUTH_EXPIRED_TOKEN","description":"OAuth access token is expired.","http_status":"401"},{"error_id":"AUTH_INVALID_CODE","description":"OAuth access code is invalid.","http_status":"401"},{"error_id":"AUTH_EXPIRED_CODE","description":"OAuth access code is expired.","http_status":"401"},{"error_id":"RESOURCE_NOT_FOUND","description":"Requested resource was not found.","http_status":"404"},{"error_id":"HTTP_INVALID_METHOD","description":"Requested method is not available for this resource.","http_status":"405"},{"error_id":"HTTP_INVALID_HEADER","description":"An HTTP header was malformed.","http_status":"400"},{"error_id":"REQUEST_INVALID_INPUT","description":"Malformed input structure.","http_status":"400"},{"error_id":"URI_INVALID_PARAMETER","description":"URI parameter is not supported or malformed.","http_status":"400"},{"error_id":"URI_MISSING_PARAMETER","description":"Missing required parameter.","http_status":"400"}],"title":"Riverbed Cascade Profiler REST API.","description":"<h2>Overview<\/h2>\n\n<p>\nThe documentation pages in this section describe\nthe RESTful APIs included with Cascade Profiler and Cascade Express\nproducts. It is assumed that the reader has practical knowledge of\nRESTful APIs, so the documentation does not go into detail about what\nREST is and how to use it. Instead the documentation focuses on what\ndata can be accessed and how to access it.\n<\/p>\n\n<p>\nThe primary focus of the current version of the API is on providing\naccess to reporting data. The following information can be accessed\nvia the API:\n<\/p>\n<ul>\n  <li>Reporting data (traffic data, service data, event list data, and user data)<\/li>\n  <li>Information about network devices<\/li>\n  <li>Control over SDN virtual network settings (SDN virtual network settings are a licensed feature)<\/li>\n  <li>Information about system users<\/li>\n<\/ul>\n\n<p>\nDetails about REST resources can be found in the <b>Resources<\/b>\nsection. This overview continues with how to run reports and retrieve\ndata from them.\n<\/p>\n\n<h2>Running a report<\/h2>\n\n<p>\nThe steps for running a report are described below. An easy way to\nlearn how to run reports and get data is to use the <b>Demo\nReports<\/b> section of this documentation. In that section a number of\nexample reports are listed. If you click on any of the examples, the\nreport will run along with a listing on the right side of the screen\nfor each step in the process. It displays the REST resource, HTTP\nmethod, headers and body for both the request and response.\n<\/p>\n\n<p>\nFollow these steps to run a report:\n<\/p>\n\n<h3>1. Create a new report by posting report criteria to the server.<\/h3>\n\n<p>\nA criteria structure in either JSON or XML is submitted to the server\nusing the HTTP POST method. The resource to which the criteria\nstructure is posted is\ncalled <b>\/profiler\/1.0\/reporting\/reports<\/b>. The details are\ndescribed in the <b>Resources<\/b> section of this documentation.\n<\/p>\n\n<p>\nA key part of the report criteria is the ID of the template that\nshould be used to run the report. A special system template ID 184\nthat provides a high degree of flexibility is used in demo reports in\nthis documentation. Additionally, any template that is saved via the\nuser interface of the product can be used to run a report. In order to\nsave a template, the ID of that template must be passed in the report\ncriteria structure instead of 184. A template can be configured via\nthe user interface, saved via the product and then used in the REST\nAPI to generate reports and retrieve them in a rendered form or in raw\ndata form. Once a template is saved, its ID can be obtained\nvia the <b>\/api\/profiler\/1.0\/reporting\/templates<\/b> REST resource.\n<\/p>\n\n<h3>2. Poll report status until the report completes.<\/h3>\n\n<p>\nIt may take a while for a report to complete. While the report is\nrunning, the client must poll for report status to know when the\nreport completes. When the call to create a new report succeeds, it\nreturns the URL for the newly created report. That URL may look\nsimilar to <i>\/profiler\/1.0\/reporting\/reports\/1000<\/i>, which is the ID of\nthe new report.\n<\/p>\n\n<p>\nThe general way to describe this in REST documentation is\n<b>\/profiler\/1.0\/reporting\/reports\/{id}<\/b> so this documentation uses\nthat syntax throughout. Note that the client does not need to know\nthat <b>{id}<\/b> is really an ID of a report. Instead the client should\ntreat a given report, for example\n\/profiler\/1.0\/reporting\/reports\/1000, as a REST resource without\nparsing the parts of the URL.\n<\/p>\n\n<p>\nThe status of a report can be obtained by executing a GET method on\nthe report URL. The client should wait while the report is running and\nuntil the status turns to state.\n<\/p>\n\n<h3>3. Retrieve the report data.<\/h3>\n\n<p>\nOnce the report completes, the client can retrieve its data or the\nrendered version of the report in a number of formats.\n<\/p>\n\n<p>\nThe following resources can be used to retrieve a rendered version of the report:\n<ul>\n  <li>\/profiler\/1.0\/reporting\/reports\/{id}\/view.pdf<\/li>\n  <li>\/profiler\/1.0\/reporting\/reports\/{id}\/view.csv<\/li>\n<\/ul>\nThese are for PDF and CSV versions respectively.\n<\/p>\n\n<p>\nIf the client is a script that needs access to raw data, the\n<b>\/profiler\/1.0\/reporting\/reports\/{id}\/queries<\/b> resource can be\nused with the GET method to obtain the list of elements (queries)\nfirst. The data shown in a typical report on the user interface may\ncome from more than one query, which is why the report structure needs\nto be determined first. However, the system template 184 described\nabove will have only one query and is easy to use for simple scripts.\n<\/p>\n\n<p>\nEach query resource provides metadata about the query, such as\nthe list of columns with descriptions of what the columns are. \n<\/p>\n\n<p>\nOnce the query is chosen, the\n<b>\/profiler\/1.0\/reporting\/reports\/{id}\/queries\/{id}<\/b> resource can be used\nto get the report data.\n<\/p>\n\n<p>\nThe simple overview provided above cannot substitute for full\ndocumentation and it is not intended to do so. Please refer to <b>Demo\nReports<\/b> section to see how reports are run. Look at the <b>Coding\nExamples<\/b> under <b>General Information<\/b> and\nexplore <b>Resources<\/b> section of this documentation for more\ninformation.\n<\/p>\n\n<h2>Authentication<\/h2>\n\n<p>\nAll REST requests must be authenticated. The <b>Authentication<\/b>\nsection of the Common 1.0 API describes which authentication methods\nare presently supported. There are also examples that show how to use\neach of the different authentication methods.\n<\/p>\n\n<h2>\/api\/profiler\/1.1 to \/api\/profiler\/1.2 Changelog<\/h2>\n\n<p>\n<b>Added the following resources:<\/b>\n<\/p>\n<p>\n  <ul>\n    <li>\/api\/profiler\/1.2\/applications<\/li>\n    <li>\/api\/profiler\/1.2\/applications\/layer_4<\/li>\n    <li>\/api\/profiler\/1.2\/applications\/layer_7<\/li>\n    <li>\/api\/profiler\/1.2\/dscps<\/li>\n    <li>\/api\/profiler\/1.2\/host_group_types<\/li>\n    <li>\/api\/profiler\/1.2\/interfaces<\/li>\n    <li>\/api\/profiler\/1.2\/port_groups<\/li>\n    <li>\/api\/profiler\/1.2\/port_names<\/li>\n    <li>\/api\/profiler\/1.2\/protocols<\/li>\n    <li>\/api\/profiler\/1.2\/sharks<\/li>\n    <li>\/api\/profiler\/1.2\/steelheads<\/li>\n    <li>\/api\/profiler\/1.2\/devices\/restsync<\/li>\n  <\/ul>\n  For more information please read the Resources documentation.\n<\/p>\n\n<p>\n<b>Added the following methods to existing resources:<\/b>\n<\/p>\n\n<p>\n  <ul>\n    <li>Multiple methods to configure and export Dashboards added under: \/api\/profiler\/1.2\/reporting\/templates<\/li>\n    <li>DELETE \/api\/profiler\/1.2\/devices\/{IP}<\/li>\n    <li>POST \/api\/profiler\/1.2\/users\/radius\/test_user<\/li>\n  <\/ul>\nFor more information please read the Resources documentation.\n<\/p>\n<h2>Running a report: Sample PHP script<\/h2>\n\n<p>Run a report to get bytes and packets for the top 20 hosts using the application WEB. Use BASIC Authentication.<\/p>\n\n    <?php\n    \n    define('HOST', '127.0.0.1'); \/\/ IP address of Profiler\n    define('BASIC_AUTH', 'admin:admin');\n    \n    \/\/ Timeframe\n    $end   = time() - 3*60; \n    $start = $end   - 5*60;\n    \n    \/\/ Lib functions\n    \n    \/\/ HTTP POST\n    function do_POST($url, $string, &$info) {\n      $curl = curl_init();\n      curl_setopt($curl, CURLOPT_URL, $url);\n      curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC ) ;\n      curl_setopt($curl, CURLOPT_USERPWD, BASIC_AUTH);\n      curl_setopt($curl, CURLOPT_SSLVERSION,3);\n      curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);\n      curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2);\n      curl_setopt($curl, CURLOPT_HEADER, true);\n      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);\n      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application\/json'));\n      curl_setopt($curl, CURLOPT_POST,           1);\n      curl_setopt($curl, CURLOPT_POSTFIELDS,     $string);\n      $output = curl_exec($curl);\n      $info   = curl_getinfo($curl);\n      curl_close($curl);\n      \n      $headers = substr($output, 0, $info['header_size']);\n      $headers = explode(\"\\n\", $headers);\n      $info['headers'] = $headers;\n      $body = substr($output, $info['header_size']);\n      return $body;\n    }\n    \n    \/\/ HTTP GET\n    function do_GET($url, &$info) {\n      $curl = curl_init();\n      curl_setopt($curl, CURLOPT_URL, $url);\n      curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC ) ;\n      curl_setopt($curl, CURLOPT_USERPWD, BASIC_AUTH);\n      curl_setopt($curl, CURLOPT_SSLVERSION,3);\n      curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);\n      curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2);\n      curl_setopt($curl, CURLOPT_HEADER, true);\n      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);\n      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application\/json'));\n      curl_setopt($curl, CURLOPT_HTTPGET, true);\n      $output = curl_exec($curl);\n      $info   = curl_getinfo($curl);\n      curl_close($curl);\n        \n      $headers = substr($output, 0, $info['header_size']);\n      $headers = explode(\"\\n\", $headers);\n      $info['headers'] = $headers;\n      $body = substr($output, $info['header_size']);\n      return $body;\n    }\n    \n    \/\/ Finds and returns HTTP header\n    function get_header($headers, $header) {\n      foreach($headers as $h) {\n        if (strpos($h, $header . ':') !== false)\n          return trim(substr($h, 10));\n      }\n      echo \"Unable to find {$header} header!\\n\";\n      exit;\n    }\n    \n    \/\/ Locates a column by id and returns the name\n    function find_column_name_by_id($columns, $id) {\n      foreach ($columns as $c) {\n        if ($c['id'] == $id)\n          return $c['name'];\n      }\n      return 'Unknown';\n    }\n    \n    \/\/ CSV helper\n    function echo_csv($headers, $rows) {\n      echo implode(',', $headers) . \"\\n\";\n      foreach ($rows as $row)\n        echo implode(',', $row) . \"\\n\";\n    }\n    \n    \/\/ End lib functions\n    \n    $struct = \n      array('template_id' => 184,\n            'criteria'    => Array('time_frame' => array('start' => $start,\n                                                         'end'   => $end),\n                                   'traffic_expression' => 'app WEB',\n                                   'query' => array('realm'       => 'traffic_summary',\n                                                    'group_by'    => 'hos',\n                                                    'sort_column' => 33,\n                                                    'columns'     => array(6, 33, 34))));\n    \n    $json    = json_encode($struct);\n    $columns = $struct['criteria']['query']['columns'];\n    \n    \/\/ Post to run the report\n    $url = 'https:\/\/' . HOST . '\/api\/profiler\/1.0\/reporting\/reports.json';\n    echo \"Run report:\\nPOST {$url}\\n{$json}\\n\\n\";\n    $info = array();\n    do_POST($url, $json, $info);\n    if ($info['http_code'] != 201) {\n      echo \"Unable to run report!\\n\";\n      exit(1);\n    }\n    $location = get_header($info['headers'], 'Location');\n    echo \"Generated: {$location}\\n\\n\";\n    $status_url = 'https:\/\/' . HOST . '' . $location . '.json';\n      \n    \/\/ Wait for it to complete\n    echo \"Please wait\\n\";\n    while (true) {\n      $info = array();\n      $output = do_GET($status_url, $info);\n      $s = json_decode($output, 1);\n      print \" Percent completed {$s['percent']}, seconds remaining {$s['remaining_seconds']}...\\n\";\n      if ($s['status'] == 'completed') {\n        echo \"Completed\\n\\n\";\n        break;\n      }\n      sleep(1);\n    }\n      \n    \/\/ Get all quesries (In this exampe it is only one)\n    $queries_url = 'https:\/\/' . HOST . '' . $location . '\/queries.json';\n    $output = do_GET($queries_url, $info);\n    $queries = json_decode($output, 1);\n    \n    \/\/ Print the data from all queries\n    foreach ($queries as $q) {\n      $query_id = $q['id'];\n      $data_url = 'https:\/\/' . HOST . '' . $location . '\/queries\/' . $query_id . '.json?offset=0&limit=20&columns=' . join(',', $columns);\n      $info = array();\n      $output = do_GET($data_url, $info);\n      $data = json_decode($output, 1);\n      \n      $h = array();\n      foreach ($columns as $c)\n        $h[] = find_column_name_by_id($q['columns'], $c);\n        \n      echo_csv($h, $data['data']);\n      echo \"\\n\";\n    }\n    \n    ?>\n<h2>Running a report: Sample Python script<\/h2>\n\n<p>Run a report to get bytes and packets for the top 20 hosts using the application WEB. Use BASIC Authentication.<\/p>\n\n    from urlparse import urlparse\n    import base64\n    import logging\n    import httplib\n    import json\n    import time\n    import sys\n    \n    HOST       = '127.0.0.1'\n    BASIC_AUTH = 'admin:admin'\n    \n    end   = int(time.time() - 3*60)\n    start = int(end - 5*60);\n    \n    # Lib functions\n    \n    def do_POST(url, string):\n        '''HTTP POST'''\n        \n        conn = httplib.HTTPSConnection(HOST, 443)\n                \n        headers = {\"Authorization\"  : \"Basic %s\" % base64.b64encode(BASIC_AUTH),\n                   \"Content-Length\" : str(len(string)),\n                   \"Content-Type\"   : \"application\/json\"}\n        \n        conn.request('POST', url, body=string, headers=headers)\n    \n        res = conn.getresponse()\n        \n        info = {\"status\"  : res.status,\n                \"headers\" : res.getheaders()}\n        \n        data = res.read()\n        conn.close()\n        return data, info\n    \n    def do_GET(url):\n        '''HTTP GET'''\n        \n        conn = httplib.HTTPSConnection(HOST, 443)\n                \n        headers = {\"Authorization\"  : \"Basic %s\" % base64.b64encode(BASIC_AUTH),\n                   \"Content-Length\" : 0,\n                   \"Content-Type\"   : \"application\/json\"}\n        \n        conn.request('GET', url, body=\"\", headers=headers)\n    \n        res = conn.getresponse()\n        \n        info = {\"status\"  : res.status,\n                \"headers\" : res.getheaders()}\n        \n        data = res.read()\n        conn.close()\n        return data, info\n    \n    def get_header(headers, header):\n      '''Finds and returns HTTP header'''\n      for i in headers:\n        if (i[0] == header):\n          return i[1]\n      return \"\"\n    \n    def find_column_name_by_id(columns, cid):\n      '''Locates a column by id and returns the name'''\n      for c in columns:\n        if (c['id'] == cid):\n          return c['name']\n      return 'Unknown'\n    \n    def echo_csv(headers, rows):\n      '''CSV helper'''\n      print ','.join(headers)\n      for row in rows:\n        print ','.join(row)\n    \n    # End lib functions\n    \n    struct = {\n        \"template_id\" : 184,\n        \"criteria\" : {\n            \"time_frame\" : {\n                \"start\" : start,\n                \"end\"   : end\n                },\n            \"traffic_expression\" : \"app WEB\",\n            \"query\" : {\n                \"realm\"      : \"traffic_summary\",\n                \"group_by\"   : \"hos\",\n                \"sort_column\": 33,\n                \"columns\"    : [6, 33, 34]\n                }\n            }\n        }\n    \n    to_post = json.dumps(struct)\n    columns = struct[\"criteria\"][\"query\"][\"columns\"]\n    \n    # Post to run the report\n    url = \"https:\/\/%s\/api\/profiler\/1.0\/reporting\/reports.json\" % HOST\n    print \"Run report:\"\n    print \"POST %s\" % url\n    print \"%s\" % to_post\n    \n    output, info = do_POST(url, to_post)\n    if (info['status'] is not 201):\n      print \"Unable to run report\"\n      sys.exit(1)\n    \n    location = get_header(info['headers'], 'location')\n    print \"\"\n    print \"Generated: %s\" % location\n    print \"\"\n    \n    status_url = \"https:\/\/%s%s.json\" % (HOST, location)\n    \n    # Wait for it to complete\n    print \"Please wait\"\n    while (True):\n      output, info = do_GET(status_url)\n      s = json.loads(output)\n      print \"Percent completed %s, seconds remaining %s...\" % (s[\"percent\"], s[\"remaining_seconds\"])\n      if (s[\"status\"] == \"completed\"):\n        print \"Completed\"\n        break\n      time.sleep(1)\n    \n    # Get all quesries (In this exampe it is only one)\n    queries_url = \"https:\/\/%s%s\/queries.json\" % (HOST, location)\n    \n    output, info = do_GET(queries_url)\n    queries = json.loads(output)\n    \n    # Print the data from all queries\n    for q in queries:\n      query_id = q['id'];\n      columns_str = ','.join([repr(i) for i in columns])\n      data_url = \"https:\/\/%s%s\/queries\/%s.json?offset=0&limit=20&columns=%s\" % (HOST, location, query_id, columns_str)\n      output, info = do_GET(data_url)\n      data = json.loads(output)\n      \n      h = []\n      for c in columns:\n        h.append(find_column_name_by_id(q[\"columns\"], c))\n    \n      print \"\"  \n      echo_csv(h, data[\"data\"])\n<h2>Running a report: Sample Perl script<\/h2>\n\n<p>Run a report to get bytes and packets for the top 20 hosts using the application WEB. Use BASIC Authentication.<\/p>\n\n    #!\/usr\/bin\/perl\n    use strict;\n    use warnings;\n    \n    use LWP::UserAgent;\n    use HTTP::Request;\n    use List::MoreUtils qw(firstidx);\n    use JSON qw( encode_json decode_json );\n    \n    use constant HOST     => '127.0.0.1';\n    use constant LOGIN    => 'admin';\n    use constant PASSWORD => 'admin';\n    \n    our $ua = LWP::UserAgent->new;\n    $ua->agent(\"ProfilerScript\/0.1\");\n    \n    our $API_BASE = \"https:\/\/127.0.0.1\";\n    \n    sub _request($) \n    {\n      my $req = shift;\n    \n      $req->header('Accept' => 'application\/json');\n      $req->authorization_basic(LOGIN, PASSWORD);\n    \n      my $res = $ua->request($req);\n    \n      return {\n        code    => $res->code,\n        status  => $res->status_line,\n        headers => $res->headers(),\n        data    => decode_json($res->content)\n      };\n    }\n    \n    sub GET($) \n    {\n      my $req = HTTP::Request->new(GET => $API_BASE . shift);\n      return _request($req);\n    }\n    \n    sub POST($$) \n    {\n      my $req = HTTP::Request->new(POST => $API_BASE . shift);\n      $req->content_type('application\/json');\n      $req->content(encode_json(shift));\n    \n      return _request($req);\n    }\n    \n    my $end   = time();\n    my $start = $end - 5 * 60;\n    \n    my $struct = { \n      template_id => 184, \n      criteria    => { \n        time_frame => { \n          start => $start, \n          end   => $end \n        }, \n        traffic_expression => \"app WEB\", \n        query => { \n          realm        => \"traffic_summary\", \n          group_by     => \"hos\", \n          sort_column  => 33, \n          columns      => [6, 33, 34] \n        } \n      } \n    };\n    \n    print \"Running report... \";\n    \n    my $response = POST('\/api\/profiler\/1.0\/reporting\/reports', $struct);\n    die \"Unable to run report. $response->{data}->{error_text}\" unless $response->{code} == 201;\n    \n    my $loc = $response->{headers}->header('Location');\n    \n    while (1) \n    {\n      $response = GET($loc);\n      printf \"\\rRunning report, %3d%% done, %d seconds remaining...   \", \n        $response->{data}->{percent}, \n        $response->{data}->{remaining_seconds};\n    \n      last if $response->{data}->{status} eq 'completed';\n      sleep(1);\n    };\n    \n    print \"\\nLoading data...\\n\";\n    \n    $response = GET($loc . '\/queries');\n    die \"Unable to load queries. $response->{data}->{error_text}\" unless $response->{code} == 200;\n    \n    foreach my $query (@{$response->{data}})\n    {\n      my @columns = @{$struct->{criteria}->{query}->{columns}};\n      my $columns = join ',', @columns;\n    \n      my $data_response = GET(\"$loc\/queries\/$query->{id}?offset=0&limit=20&columns=$columns\");\n      die \"Unable to load data. $response->{data}->{error_text}\" unless $response->{code} == 200;\n    \n      my @indices = map { my $id = $_; firstidx { $_->{id} == $id } @{$query->{columns}} } @columns;\n    \n      print join \",\", map { qq~\"$query->{columns}->[$_]->{name}\"~; } @indices;\n      print \"\\n\";\n    \n      foreach my $row (@{$data_response->{data}->{data}}) {\n        print join \",\", @$row;\n        print \"\\n\";\n      }\n    }\n<h2>Running a report: Sample .Net\/C# code<\/h2>\n\n<p>Run a report to get bytes and packets for the top 20 hosts using the application WEB. Use BASIC Authentication.<\/p>\n\n<p><b>Program.cs:<\/b><\/p>\n\n    using System;\n    using System.Collections.Generic;\n    using System.Net;\n    using System.Runtime.Serialization.Json;\n    using System.Text;\n    using System.IO;\n    using System.Net.Security;\n    using System.Security.Cryptography.X509Certificates;\n    using System.Linq;\n    using System.Threading;\n    using System.Web.Script.Serialization;\n    \n    namespace CascadeRestClient\n    {\n        public class ReportUpdate\n        {\n            public string status { get; set; }\n            public string user_id { get; set; }\n            public string name { get; set; }\n            public string percent { get; set; }\n            public string id { get; set; }\n            public string remaining_seconds { get; set; }\n            public string run_time { get; set; }\n            public string saved { get; set; }\n            public string template_id { get; set; }\n            public string size { get; set; }\n        }\n    \n        public class Column\n        {\n            public string strid { get; set; }\n            public string metric { get; set; }\n            public string rate { get; set; }\n            public string statistic { get; set; }\n            public int id { get; set; }\n            public string unit { get; set; }\n            public string category { get; set; }\n            public string severity { get; set; }\n            public string area { get; set; }\n            public bool @internal { get; set; }\n            public string role { get; set; }\n            public string cli_srv { get; set; }\n            public string type { get; set; }\n            public bool available { get; set; }\n            public string direction { get; set; }\n            public string comparison { get; set; }\n            public bool sortable { get; set; }\n            public string name { get; set; }\n            public string comparison_parameter { get; set; }\n            public bool has_others { get; set; }\n            public bool context { get; set; }\n            public string name_type { get; set; }\n        }\n    \n        public class QueryResult\n        {\n            public string direction { get; set; }\n            public string actual_log { get; set; }\n            public int actual_t0 { get; set; }\n            public bool sort_desc { get; set; }\n            public string area { get; set; }\n            public string metric { get; set; }\n            public int sort_col { get; set; }\n            public string parent_id { get; set; }\n            public string rate { get; set; }\n            public string group_by { get; set; }\n            public string role { get; set; }\n            public List&lt;Column&gt; columns { get; set; }\n            public string statistic { get; set; }\n            public string type { get; set; }\n            public string id { get; set; }\n            public string unit { get; set; }\n            public int actual_t1 { get; set; }\n        }\n    \n        public class QueryData\n        {\n            public List&lt;List&lt;string&gt;&gt; data { get; set; }\n            public int data_size { get; set; }\n            public List&lt;string&gt; totals { get; set; }\n        }\n    \n        class Program\n        {\n            static string BASIC_AUTH = \"admin:admin\";\n    \n            \/\/ callback used to validate the self-gen certificate in an SSL conversation\n            private static bool ValidateRemoteCertificate(object sender, X509Certificate cert, X509Chain chain, SslPolicyErrors policyErrors)\n            {\n                return true;\n                \/*\n                X509Certificate2 certv2 = new X509Certificate2(cert);\n                if (certv2.GetNameInfo(X509NameType.SimpleName,true) == \"www.riverbed.com\")\n                    return true;\n    \n                return false;\n                 *\/\n            }\n    \n            static void Main(string[] args)\n            {\n                if (args.Length == 0 || string.IsNullOrWhiteSpace(args[0]))\n                {\n                    Console.WriteLine(\"Usage: CascadeRestClient hostname\");\n                    return;\n                }\n                try\n                {\n                    \/\/Code to allow run with self-signed certificates\n                    \/\/ validate cert by calling a function\n                    ServicePointManager.ServerCertificateValidationCallback += new RemoteCertificateValidationCallback(ValidateRemoteCertificate);\n    \n                    \/\/Starting to run rest \n                    string rootUrl = \"https:\/\/\" + args[0];\n                    string requestUrl = rootUrl + \"\/api\/profiler\/1.0\/reporting\/reports.json\";\n                    string location;\n    \n                    int start = (int)((DateTime.Now - new DateTime(1970, 1, 1).ToLocalTime()).TotalSeconds) - 8*60; \/\/8 minutes before in unix time\n                    int end = start + 5*60; \/\/3 minutes before in unix time\n    \n                    var jsondata = new\n                    {\n                        template_id = 184,\n                        criteria = new\n                        {\n                            time_frame = new\n                            {\n                                start = start,\n                                end = end\n                            },\n    \n                            traffic_expression = \"app WEB\",\n                            query = new\n                            {\n                                realm = \"traffic_summary\",\n                                group_by = \"hos\",\n                                sort_column = 33,\n                                columns = new List&lt;int&gt; { 6, 33, 34 }\n                            }\n                        }\n                    };\n    \n                    \/\/Serialize anomymous type to json\n                    JavaScriptSerializer serializer = new JavaScriptSerializer();\n                    string postData = serializer.Serialize(jsondata);\n    \n                    Console.WriteLine(\"Run report:\");\n                    Console.WriteLine(\"POST \" + requestUrl);\n                    Console.WriteLine(postData + Environment.NewLine);\n    \n                    \/\/ Post to run the report\n                    var runReportResponse = MakeRequest&lt;ReportUpdate&gt;(requestUrl, WebRequestMethods.Http.Post, out location, postData);\n                    Console.WriteLine(\"Generated \" + location + Environment.NewLine);\n                    requestUrl = rootUrl + location;\n                    Console.WriteLine(\"Please wait\");\n                    while (runReportResponse.status != \"completed\")\n                    {\n                        runReportResponse = MakeRequest&lt;ReportUpdate&gt;(requestUrl + \".json\", WebRequestMethods.Http.Get, out location);\n                        Console.WriteLine(string.Format(\"Percent completed {0}, seconds remaining {1}\",runReportResponse.percent, runReportResponse.remaining_seconds));\n                        Thread.Sleep(1000);\n                    }\n                    Console.WriteLine(\"Completed\"+ Environment.NewLine);\n    \n                    \/\/ Get all quesries (In this example it is only one)\n                    var getQueriesResponse = MakeRequest&lt;List&lt;QueryResult&gt;&gt;(requestUrl +\"\/queries.json\", WebRequestMethods.Http.Get, out location);\n                    string columns = jsondata.criteria.query.columns.Select(c=&gt;c.ToString()).Aggregate((i, j) =&gt; i + \",\" + j);\n                    \/\/ Print the data from all queries\n                    foreach (var query in getQueriesResponse) {\n                        var qr = MakeRequest&lt;QueryData&gt;(requestUrl + \"\/queries\/\" + query.id + \".json?offset=0&amp;limit=20&amp;columns=\" + columns,\n                                                       WebRequestMethods.Http.Get, out location);\n                        string columnList = jsondata.criteria.query.columns.Select(c=&gt;query.columns.Where(col =&gt; col.id == c).First().name)\n                                                                  .Aggregate((l,r) =&gt; l + \",\" + r);\n                        Console.WriteLine(columnList);\n    \n                        foreach (var dr in qr.data)\n                        {\n                            Console.WriteLine(dr.Aggregate((i, j) =&gt; i + ',' + j));\n                        }\n                    }\n                }\n                catch (Exception e)\n                {\n                    Console.WriteLine(e.Message);\n                }\n            }\n    \n    \n            private static string Base64Encode(string toEncode)\n            {\n                byte[] toEncodeAsBytes\n                = System.Text.ASCIIEncoding.ASCII.GetBytes(toEncode);\n                return System.Convert.ToBase64String(toEncodeAsBytes);\n            }\n    \n            \/\/\/ &lt;summary&gt;\n            \/\/\/ Make request\n            \/\/\/ &lt;\/summary&gt;\n            \/\/\/ &lt;typeparam name=\"T\"&gt;return type&lt;\/typeparam&gt;\n            \/\/\/ &lt;param name=\"requestUrl\"&gt;url for request&lt;\/param&gt;\n            \/\/\/ &lt;param name=\"action\"&gt;Http Verb, Get, Post etc&lt;\/param&gt;\n            \/\/\/ &lt;param name=\"location\"&gt;location returned from response header &lt;\/param&gt;\n            \/\/\/ &lt;param name=\"requestData\"&gt;Data posted&lt;\/param&gt;\n            \/\/\/ &lt;returns&gt;&lt;\/returns&gt;\n            private static T MakeRequest&lt;T&gt;(string requestUrl, string action, out string location, string requestData = null) where T : class\n            {\n                HttpWebRequest request = WebRequest.Create(requestUrl) as HttpWebRequest;\n                request.Headers.Add(\"Authorization: Basic \" + Base64Encode(BASIC_AUTH));\n                request.ContentType = \"application\/json\";\n                request.Method = action;\n                if (requestData == null)\n                {\n                    request.ContentLength = 0;\n                }\n                else\n                {\n                    ASCIIEncoding encoding = new ASCIIEncoding();\n                    byte[] byte1 = encoding.GetBytes(requestData);\n                    request.ContentLength = byte1.Length;\n                    using (Stream newStream = request.GetRequestStream())\n                    {\n                        newStream.Write(byte1, 0, byte1.Length);\n                    }\n                }\n    \n                using (HttpWebResponse response = request.GetResponse() as HttpWebResponse)\n                {\n                    if (response.StatusCode != HttpStatusCode.OK &amp;&amp; response.StatusCode != HttpStatusCode.Created)\n                        throw new Exception(String.Format(\n                        \"Unable to run report! StatusCode={0}, Description={1}\",\n                        response.StatusCode,\n                        response.StatusDescription));\n                    location = response.Headers[HttpResponseHeader.Location];\n                    DataContractJsonSerializer jsonSerializer = new DataContractJsonSerializer(typeof(T));\n                    object objResponse = jsonSerializer.ReadObject(response.GetResponseStream());\n                    return objResponse as T;\n                }\n            }\n        }\n    }\n\n<p><b>CascadeRestClient.csproj:<\/b><\/p>\n    &lt;?xml version=\"1.0\" encoding=\"utf-8\"?&gt;\n    &lt;Project ToolsVersion=\"4.0\" DefaultTargets=\"Build\" xmlns=\"http:\/\/schemas.microsoft.com\/developer\/msbuild\/2003\"&gt;\n      &lt;PropertyGroup&gt;\n        &lt;Configuration Condition=\" '$(Configuration)' == '' \"&gt;Debug&lt;\/Configuration&gt;\n        &lt;Platform Condition=\" '$(Platform)' == '' \"&gt;x86&lt;\/Platform&gt;\n        &lt;ProductVersion&gt;8.0.30703&lt;\/ProductVersion&gt;\n        &lt;SchemaVersion&gt;2.0&lt;\/SchemaVersion&gt;\n        &lt;ProjectGuid&gt;{4ED69347-523B-46AB-B259-47EF60D4F13A}&lt;\/ProjectGuid&gt;\n        &lt;OutputType&gt;Exe&lt;\/OutputType&gt;\n        &lt;AppDesignerFolder&gt;Properties&lt;\/AppDesignerFolder&gt;\n        &lt;RootNamespace&gt;CascadeRestClient&lt;\/RootNamespace&gt;\n        &lt;AssemblyName&gt;CascadeRestClient&lt;\/AssemblyName&gt;\n        &lt;TargetFrameworkVersion&gt;v4.0&lt;\/TargetFrameworkVersion&gt;\n        &lt;TargetFrameworkProfile&gt;\n        &lt;\/TargetFrameworkProfile&gt;\n        &lt;FileAlignment&gt;512&lt;\/FileAlignment&gt;\n      &lt;\/PropertyGroup&gt;\n      &lt;PropertyGroup Condition=\" '$(Configuration)|$(Platform)' == 'Debug|x86' \"&gt;\n        &lt;PlatformTarget&gt;x86&lt;\/PlatformTarget&gt;\n        &lt;DebugSymbols&gt;true&lt;\/DebugSymbols&gt;\n        &lt;DebugType&gt;full&lt;\/DebugType&gt;\n        &lt;Optimize&gt;false&lt;\/Optimize&gt;\n        &lt;OutputPath&gt;bin\\Debug\\&lt;\/OutputPath&gt;\n        &lt;DefineConstants&gt;DEBUG;TRACE&lt;\/DefineConstants&gt;\n        &lt;ErrorReport&gt;prompt&lt;\/ErrorReport&gt;\n        &lt;WarningLevel&gt;4&lt;\/WarningLevel&gt;\n      &lt;\/PropertyGroup&gt;\n      &lt;PropertyGroup Condition=\" '$(Configuration)|$(Platform)' == 'Release|x86' \"&gt;\n        &lt;PlatformTarget&gt;x86&lt;\/PlatformTarget&gt;\n        &lt;DebugType&gt;pdbonly&lt;\/DebugType&gt;\n        &lt;Optimize&gt;true&lt;\/Optimize&gt;\n        &lt;OutputPath&gt;bin\\Release\\&lt;\/OutputPath&gt;\n        &lt;DefineConstants&gt;TRACE&lt;\/DefineConstants&gt;\n        &lt;ErrorReport&gt;prompt&lt;\/ErrorReport&gt;\n        &lt;WarningLevel&gt;4&lt;\/WarningLevel&gt;\n      &lt;\/PropertyGroup&gt;\n      &lt;ItemGroup&gt;\n        &lt;Reference Include=\"System\" \/&gt;\n        &lt;Reference Include=\"System.Core\" \/&gt;\n        &lt;Reference Include=\"System.Runtime.Serialization\" \/&gt;\n        &lt;Reference Include=\"System.Web.Extensions\"&gt;\n          &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\..\\Program Files (x86)\\Reference Assemblies\\Microsoft\\Framework\\.NETFramework\\v4.0\\System.Web.Extensions.dll&lt;\/HintPath&gt;\n        &lt;\/Reference&gt;\n        &lt;Reference Include=\"System.Xml.Linq\" \/&gt;\n        &lt;Reference Include=\"System.Data.DataSetExtensions\" \/&gt;\n        &lt;Reference Include=\"Microsoft.CSharp\" \/&gt;\n        &lt;Reference Include=\"System.Data\" \/&gt;\n        &lt;Reference Include=\"System.Xml\" \/&gt;\n      &lt;\/ItemGroup&gt;\n      &lt;ItemGroup&gt;\n        &lt;Compile Include=\"Program.cs\" \/&gt;\n        &lt;Compile Include=\"Properties\\AssemblyInfo.cs\" \/&gt;\n      &lt;\/ItemGroup&gt;\n      &lt;Import Project=\"$(MSBuildToolsPath)\\Microsoft.CSharp.targets\" \/&gt;\n      &lt;!-- To modify your build process, add your task inside one of the targets below and uncomment it. \n           Other similar extension points exist, see Microsoft.Common.targets.\n      &lt;Target Name=\"BeforeBuild\"&gt;\n      &lt;\/Target&gt;\n      &lt;Target Name=\"AfterBuild\"&gt;\n      &lt;\/Target&gt;\n      --&gt;\n    &lt;\/Project&gt;\n","version":"1.2","defaultAuthorization":"required","servicePath":"\/api\/profiler\/1.2","schemas":[],"resources":{"Protocols":{"methods":{"Get protocol":{"description":"Get information on one protocol.","formats":["xml","json"],"httpmethod":"GET","path":"protocols\/{proto}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of Protocols objects.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"id":"CProtocols","type":"array","example":[{"id":6,"name":"tcp"},{"id":17,"name":"udp"}]},"authorization":"required"},"List protocols":{"description":"Get a list of all supported protocols.","formats":["xml","json"],"httpmethod":"GET","path":"protocols","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of Protocols objects.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"id":"CProtocols","type":"array","example":[{"id":6,"name":"tcp"},{"id":17,"name":"udp"}]},"authorization":"required"}}},"Vnis":{"methods":{"List VNIs":{"description":"Get a list of Virtual Network Identifiers.","formats":["xml","json"],"httpmethod":"GET","path":"vnis","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of VNIs (Virtual Network Identifiers of SDN setup).","items":{"description":"Object representing a VNI.","required":false,"properties":{"id":{"description":"ID of the VNI.","required":true,"type":"number"},"description":{"description":"Description of the VNI.","required":false,"type":"string"},"name":{"description":"Name of the VNI.","required":false,"type":"string"}},"id":"VNI","type":"object"},"id":"VNIs","type":"array","example":[{"description":"Customer A. Blue Network.","name":"Blue_Network","id":100},{"description":"Customer B. Blue Network.","name":"Red_Network","id":200}]},"authorization":"required"},"Delete VNI":{"description":"Delete a Virtual Network Identifier.","httpmethod":"DELETE","path":"vnis\/{vni_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Update VNIs":{"description":"Update one or many Virtual Network Identifiers.","request":{"description":"List of VNIs (Virtual Network Identifiers of SDN setup).","items":{"description":"Object representing a VNI.","required":false,"properties":{"id":{"description":"ID of the VNI.","required":true,"type":"number"},"description":{"description":"Description of the VNI.","required":false,"type":"string"},"name":{"description":"Name of the VNI.","required":false,"type":"string"}},"id":"VNI","type":"object"},"id":"VNIs","type":"array","example":[{"description":"Customer A. Blue Network.","name":"Blue_Network","id":100},{"description":"Customer B. Blue Network.","name":"Red_Network","id":200}]},"httpmethod":"PUT","path":"vnis","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Get VNI":{"description":"Get a Virtual Network Identifier.","formats":["xml","json"],"httpmethod":"GET","path":"vnis\/{vni_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing a VNI.","properties":{"id":{"description":"ID of the VNI.","required":true,"type":"number"},"description":{"description":"Description of the VNI.","required":false,"type":"string"},"name":{"description":"Name of the VNI.","required":false,"type":"string"}},"id":"VNI","type":"object","example":{"description":"Customer A. Blue Network.","name":"Blue_Network","id":100}},"authorization":"required"},"Update VNI":{"description":"Update one Virtual Network Identifier.","request":{"description":"Object representing a VNI.","properties":{"id":{"description":"ID of the VNI.","required":true,"type":"number"},"description":{"description":"Description of the VNI.","required":false,"type":"string"},"name":{"description":"Name of the VNI.","required":false,"type":"string"}},"id":"VNI","type":"object","example":{"description":"Customer A. Blue Network.","name":"Blue_Network","id":100}},"httpmethod":"PUT","path":"vnis\/{vni_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"}}},"Steelheads":{"methods":{"Disable Steelhead polling":{"description":"Disables data polling from Steelheads.","request":{"description":"IP addresses object representing the list of Steelheads.","items":{"description":"IP address collection object representing the list of Steelheads.","required":false,"properties":{"ipaddr":{"description":"IP address representing a Steelhead.","required":true,"type":"string"}},"id":"SteelheadIPAddr","type":"object"},"id":"SteelheadIPAddrs","type":"array","example":[{"ipaddr":"10.99.16.252"},{"ipaddr":"10.99.15.252"},{"ipaddr":"10.99.14.252"}]},"httpmethod":"POST","path":"steelheads\/sync\/disable","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Enable Steelhead polling":{"description":"Enables data polling from Steelheads.","request":{"description":"IP addresses object representing the list of Steelheads.","items":{"description":"IP address collection object representing the list of Steelheads.","required":false,"properties":{"ipaddr":{"description":"IP address representing a Steelhead.","required":true,"type":"string"}},"id":"SteelheadIPAddr","type":"object"},"id":"SteelheadIPAddrs","type":"array","example":[{"ipaddr":"10.99.16.252"},{"ipaddr":"10.99.15.252"},{"ipaddr":"10.99.14.252"}]},"httpmethod":"POST","path":"steelheads\/sync\/enable","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Delete Steelheads global OAuth":{"description":"Deletes global OAuth code.","httpmethod":"DELETE","path":"steelheads\/oauth_code\/global","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Get Steelheads OAuth codes":{"description":"Get a list of steelheads CIDRs with OAuth code configured.","formats":["xml","json"],"httpmethod":"GET","path":"steelheads\/oauth_code","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of Cidr Objects.","items":{"description":"Object representing an IP address, CIDR.","required":false,"properties":{"cidr":{"description":"IP address, CIDR.","required":true,"type":"string"}},"id":"Cidr","type":"object"},"id":"Cidrs","type":"array","example":[{"cidr":"10.10.0.60"},{"cidr":"0\/0"},{"cidr":"10\/8"}]},"authorization":"required"},"Update Steelheads OAuth codes":{"description":"Creates or Updates Oauth Codes for a list of Steelheads.","request":{"description":"List of OAuth code Objects.","items":{"description":"Object representing an IP address, CIDR and its OAuth code.","required":false,"properties":{"code":{"description":"OAuth code.","required":true,"type":"string"},"cidr":{"description":"IP address, CIDR.","required":true,"type":"string"}},"id":"Oauthcode","type":"object"},"id":"Oauthcodes","type":"array","example":[{"cidr":"10.20.0.60","code":"code_ip"},{"cidr":"0\/0","code":"code_global"},{"cidr":"10\/8","code":"code_region"}]},"httpmethod":"PUT","path":"steelheads\/oauth_code","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Sync Steelheads QoS data":{"description":"Retrieves QoS data from Steelheads on which polling is enabled.","request":{"description":"IP addresses object representing the list of Steelheads.","items":{"description":"IP address collection object representing the list of Steelheads.","required":false,"properties":{"ipaddr":{"description":"IP address representing a Steelhead.","required":true,"type":"string"}},"id":"SteelheadIPAddr","type":"object"},"id":"SteelheadIPAddrs","type":"array","example":[{"ipaddr":"10.99.16.252"},{"ipaddr":"10.99.15.252"},{"ipaddr":"10.99.14.252"}]},"httpmethod":"POST","path":"steelheads\/qos\/sync","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Sync Steelhead apps":{"description":"Retrieves application data from Steelheads on which polling is enabled.","request":{"description":"IP addresses object representing the list of Steelheads.","items":{"description":"IP address collection object representing the list of Steelheads.","required":false,"properties":{"ipaddr":{"description":"IP address representing a Steelhead.","required":true,"type":"string"}},"id":"SteelheadIPAddr","type":"object"},"id":"SteelheadIPAddrs","type":"array","example":[{"ipaddr":"10.99.16.252"},{"ipaddr":"10.99.15.252"},{"ipaddr":"10.99.14.252"}]},"httpmethod":"POST","path":"steelheads\/apps\/sync","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Get Steelheads":{"description":"Get a Steelhead QoS Global Configuration by IP address.","formats":["xml","json"],"httpmethod":"GET","path":"steelheads\/{steelhead_ip}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing a steelhead.","properties":{"dpi":{"description":"Flag indicating if Deep Packet Inspection (DPI) is enabled on this Steelhead.","required":false,"type":"string"},"marking":{"description":"Flag indicating if QoS Marking is enabled on this Steelhead.","required":false,"type":"string"},"sync":{"description":"Object representing Steelhead syncronization information.","required":true,"properties":{"apps":{"description":"Object representing Steelhead application syncronization information.","required":true,"properties":{"enabled":{"description":"Flag - Enable application synchronization.","required":true,"type":"string"},"error_text":{"description":"Error description.","required":true,"type":"string"},"last_sync_ts":{"description":"Last attempted application synchronization time.","required":true,"type":"number"},"last_success_ts":{"description":"Last successful application synchronization time.","required":true,"type":"number"},"error_id":{"description":"Error ID.","required":true,"type":"number"},"state":{"description":"Synchronization status.","required":true,"type":"string","enum":["SYNC_INITIALIZING","SYNC_FAILED","SYNC_SUCCEEDED","SYNC_DISABLED","SYNC_NA"]}},"id":"SteelheadAppsObject","type":"object"},"qos":{"description":"Object representing Steelhead QoS syncronization information.","required":true,"properties":{"enabled":{"description":"Flag indicating if QoS synchronization is enabled on this Steelhead.","required":true,"type":"string"},"error_text":{"description":"Error description.","required":true,"type":"string"},"last_sync_ts":{"description":"Last attempted QoS syncronization time.","required":true,"type":"number"},"last_success_ts":{"description":"Last successful QoS syncronization time.","required":true,"type":"number"},"error_id":{"description":"Error ID.","required":true,"type":"number"},"state":{"description":"Synchronization status.","required":true,"type":"string","enum":["SYNC_INITIALIZING","SYNC_FAILED","SYNC_SUCCEEDED","SYNC_DISABLED","SYNC_NA"]}},"id":"SteelheadQosObject","type":"object"}},"id":"SteelheadSyncObject","type":"object"},"ipaddr":{"description":"Steelhead IP address.","required":true,"type":"string"},"name":{"description":"Steelhead name.","required":true,"type":"string"},"oauth_custom":{"description":"Flag indicating if Custom OAuth code is configured on this Steelhead.","required":true,"type":"string"},"hier_mode":{"description":"Flag indicating if QoS Hierarchical Mode is enabled on this Steelhead.","required":false,"type":"string"},"shaping":{"description":"Flag indicating if QoS Shaping is enabled on this Steelhead.","required":false,"type":"string"},"easy_mode":{"description":"Flag indicating which QoS Configuration Mode (Basic\/Advanced) is set (Basic if true).","required":false,"type":"string"},"bw_overcommit":{"description":"Flag indicating if QoS Bandwidth Overcommit is enabled on this Steelhead.","required":false,"type":"string"}},"id":"Steelhead","type":"object","example":{"marking":false,"name":"SH-DataCenter","ipaddr":"10.100.100.252","bw_overcommit":false,"sync":{"qos":{"last_sync_ts":1370967843,"enabled":true,"last_success_ts":0,"state":"SYNC_FAILED","error_id":720897,"error_text":"28: Timeout was reached"},"apps":{"last_sync_ts":1370967843,"enabled":true,"last_success_ts":0,"state":"SYNC_FAILED","error_id":720897,"error_text":"28: Timeout was reached"}},"shaping":true,"hier_mode":true,"oauth_custom":false,"dpi":true,"easy_mode":false}},"authorization":"required"},"Delete Steelheads OAuth codes":{"description":"Deletes OAuth codes for a list of Steelheads.","request":{"description":"List of Cidr Objects.","items":{"description":"Object representing an IP address, CIDR.","required":false,"properties":{"cidr":{"description":"IP address, CIDR.","required":true,"type":"string"}},"id":"Cidr","type":"object"},"id":"Cidrs","type":"array","example":[{"cidr":"10.10.0.60"},{"cidr":"0\/0"},{"cidr":"10\/8"}]},"httpmethod":"DELETE","path":"steelheads\/oauth_code","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Update Steelheads global OAuth":{"description":"Creates or Updates global OAuth code.","request":{"description":"Global OAuth code object.","properties":{"code":{"description":"OAuth Code.","required":true,"type":"string"}},"id":"Globalcode","type":"object","example":{"code":"code_global"}},"httpmethod":"PUT","path":"steelheads\/oauth_code\/global","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"List Steelheads":{"description":"Get a list of Steelheads and their QoS global and application configuration.","formats":["xml","json"],"httpmethod":"GET","path":"steelheads","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of Steelheads and their QoS and Application configuration data.","items":{"description":"Steelhead QoS and Application Configuration Data.","required":false,"properties":{"dpi":{"description":"Flag indicating if Deep Packet Inspection (DPI) is enabled on this Steelhead.","required":false,"type":"string"},"marking":{"description":"Flag indicating if QoS Marking is enabled on this Steelhead.","required":false,"type":"string"},"sync":{"description":"Object representing Steelhead syncronization information.","required":true,"properties":{"apps":{"description":"Object representing Steelhead application syncronization information.","required":true,"properties":{"enabled":{"description":"Flag - Enable application synchronization.","required":true,"type":"string"},"error_text":{"description":"Error description.","required":true,"type":"string"},"last_sync_ts":{"description":"Last attempted application synchronization time.","required":true,"type":"number"},"last_success_ts":{"description":"Last successful application synchronization time.","required":true,"type":"number"},"error_id":{"description":"Error ID.","required":true,"type":"number"},"state":{"description":"Synchronization status.","required":true,"type":"string","enum":["SYNC_INITIALIZING","SYNC_FAILED","SYNC_SUCCEEDED","SYNC_DISABLED","SYNC_NA"]}},"id":"SteelheadAppsObject","type":"object"},"qos":{"description":"Object representing Steelhead QoS syncronization information.","required":true,"properties":{"enabled":{"description":"Flag indicating if QoS synchronization is enabled on this Steelhead.","required":true,"type":"string"},"error_text":{"description":"Error description.","required":true,"type":"string"},"last_sync_ts":{"description":"Last attempted QoS syncronization time.","required":true,"type":"number"},"last_success_ts":{"description":"Last successful QoS syncronization time.","required":true,"type":"number"},"error_id":{"description":"Error ID.","required":true,"type":"number"},"state":{"description":"Synchronization status.","required":true,"type":"string","enum":["SYNC_INITIALIZING","SYNC_FAILED","SYNC_SUCCEEDED","SYNC_DISABLED","SYNC_NA"]}},"id":"SteelheadQosObject","type":"object"}},"id":"SteelheadSyncObject","type":"object"},"ipaddr":{"description":"Steelhead IP address.","required":true,"type":"string"},"name":{"description":"Steelhead name.","required":true,"type":"string"},"oauth_custom":{"description":"Flag indicating if Custom OAuth code is configured on this Steelhead.","required":true,"type":"string"},"hier_mode":{"description":"Flag indicating if QoS Hierarchical Mode is enabled on this Steelhead.","required":false,"type":"string"},"shaping":{"description":"Flag indicating if QoS Shaping is enabled on this Steelhead.","required":false,"type":"string"},"easy_mode":{"description":"Flag indicating which QoS Configuration Mode (Basic\/Advanced) is set (Basic if true).","required":false,"type":"string"},"bw_overcommit":{"description":"Flag indicating if QoS Bandwidth Overcommit is enabled on this Steelhead.","required":false,"type":"string"}},"id":"Steelhead","type":"object"},"id":"Steelheads","type":"array","example":[{"marking":false,"name":"10.99.15.252","ipaddr":"10.99.15.252","bw_overcommit":false,"sync":{"qos":{"last_sync_ts":1370967813,"enabled":true,"last_success_ts":0,"state":"SYNC_FAILED","error_id":720897,"error_text":"28: Timeout was reached"},"apps":{"last_sync_ts":1370967813,"enabled":true,"last_success_ts":0,"state":"SYNC_FAILED","error_id":720897,"error_text":"28: Timeout was reached"}},"shaping":true,"hier_mode":true,"oauth_custom":false,"dpi":false,"easy_mode":true},{"marking":false,"name":"SH-DataCenter","ipaddr":"10.100.100.252","bw_overcommit":false,"sync":{"qos":{"last_sync_ts":1370967843,"enabled":true,"last_success_ts":0,"state":"SYNC_FAILED","error_id":720897,"error_text":"28: Timeout was reached"},"apps":{"last_sync_ts":1370967843,"enabled":true,"last_success_ts":0,"state":"SYNC_FAILED","error_id":720897,"error_text":"28: Timeout was reached"}},"shaping":true,"hier_mode":true,"oauth_custom":false,"dpi":true,"easy_mode":false},{"marking":false,"name":"SH-LosAngeles","ipaddr":"10.99.12.252","bw_overcommit":false,"sync":{"qos":{"last_sync_ts":1371583559,"enabled":true,"last_success_ts":0,"state":"SYNC_FAILED","error_id":720897,"error_text":"28: Timeout was reached"},"apps":{"last_sync_ts":1371583559,"enabled":true,"last_success_ts":0,"state":"SYNC_FAILED","error_id":720897,"error_text":"28: Timeout was reached"}},"shaping":true,"hier_mode":true,"oauth_custom":false,"dpi":false,"easy_mode":true}]},"authorization":"required"},"Ping Steelhead":{"description":"Pings a Steelhead by IP address.","httpmethod":"GET","path":"steelheads\/{steelhead_ip}\/ping","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Check Steelheads global OAuth":{"description":"Checks if the global OAuth code is configured.","formats":["xml","json"],"httpmethod":"GET","path":"steelheads\/oauth_code\/global","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing the global OAuth code is configured.","properties":{"configured":{"description":"True if the global ouath code is configured.","required":true,"type":"string"}},"id":"Oauthcodeglobal","type":"object","example":{"configured":true}},"authorization":"required"}}},"Devices":{"methods":{"Enable REST polling":{"description":"Globally disable REST polling for all devices.","httpmethod":"POST","path":"devices\/restsync\/enable","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Get device":{"description":"Get a device by IP Address.","formats":["xml","json"],"httpmethod":"GET","path":"devices\/{device_ip}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing a device.","properties":{"id":{"description":"Device identifier (ID). Used internally in the product and in the API.","required":true,"type":"number"},"type_id":{"description":"Device type ID; a way to represent device type that is more friendly to programs.","required":true,"type":"number"},"ipaddr":{"description":"Device IP address.","required":true,"type":"string"},"name":{"description":"Device name, which usually comes from SNMP or DNS.","required":true,"type":"string"},"type":{"description":"Device type, e.g. Cascade Gateway, Cascade Shark or Netflow device.","required":true,"type":"string"},"version":{"description":"Version of the protocol used to communicate with the device.","required":true,"type":"string"}},"id":"Device","type":"object","example":{"name":"MyNetflowDevice","type_id":2,"ipaddr":"10.0.0.1","version":"N\/A","type":"Netflow","id":123}},"authorization":"required"},"List devices":{"description":"Get a list of devices.","parameters":{"type_id":{"required":false,"type":"number","description":"Filter devices by device type."},"cidr":{"required":false,"type":"string","description":"Filter devices by IP or Subnet (e.g. 10.0.0.0\/8)."}},"formats":["xml","json"],"httpmethod":"GET","path":"devices","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of network devices that report data to Profiler.","items":{"description":"One device from the list of devices that report data.","required":false,"properties":{"id":{"description":"Device identifier (ID). Used internally in the product and in the API.","required":true,"type":"number"},"type_id":{"description":"Device type ID; a way to represent device type that is more friendly to programs.","required":true,"type":"number"},"ipaddr":{"description":"Device IP address.","required":true,"type":"string"},"name":{"description":"Device name, which usually comes from SNMP or DNS.","required":true,"type":"string"},"type":{"description":"Device type, e.g. Cascade Gateway, Cascade Shark or Netflow device.","required":true,"type":"string"},"version":{"description":"Version of the protocol used to communicate with the device.","required":true,"type":"string"}},"id":"Device","type":"object"},"id":"Devices","type":"array","example":[{"name":"MyNetflowDevice","type_id":2,"ipaddr":"10.0.0.1","version":"N\/A","type":"Netflow","id":123},{"name":"MySensorDevice","type_id":1,"ipaddr":"10.0.0.2","version":"M8.4","type":"Sensor","id":124}]},"authorization":"required"},"Check REST polling":{"description":"Get global flag showing whether REST polling is enabled for all devices.","formats":["xml","json"],"httpmethod":"GET","path":"devices\/restsync","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing global REST sync enabled flag for devices on Profiler.","properties":{"enabled":{"description":"Global REST sync enabled flag for devices on Profiler.","required":true,"type":"string"}},"id":"DevicesRestSyncEnabled","type":"object"},"authorization":"required"},"Delete device":{"description":"Delete a device by IP Address. Warning: the device will be deleted in a few minutes after this call.","httpmethod":"DELETE","path":"devices\/{device_ip}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Disable REST polling":{"description":"Globally enable REST polling for all devices.","httpmethod":"POST","path":"devices\/restsync\/disable","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"}}},"Dscps":{"methods":{"List DSCPs":{"description":"Get complete DSCP configuration.","formats":["xml","json"],"httpmethod":"GET","path":"dscps","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of DSCP objects.","items":{"description":"Object representing DSCP information.","required":false,"properties":{"id":{"description":"ID of the DSCP.","required":true,"type":"number"},"description":{"description":"Description of the DSCP.","required":true,"type":"string"},"name":{"description":"Name of the DSCP.","required":true,"type":"string"}},"id":"DSCPDef","type":"object"},"id":"CDSCPDefs","type":"array","example":[{"description":"Assured Forwarding Class 1 Medium Drop","name":"AF12","id":12},{"description":"","name":"","id":13},{"description":"Assured Forwarding Class 1 High Drop","name":"AF13","id":14}]},"authorization":"required"},"Get DSCP":{"description":"Get information about a specific DSCP.","formats":["xml","json"],"httpmethod":"GET","path":"dscps\/{dscp_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing DSCP information.","properties":{"id":{"description":"ID of the DSCP.","required":true,"type":"number"},"description":{"description":"Description of the DSCP.","required":true,"type":"string"},"name":{"description":"Name of the DSCP.","required":true,"type":"string"}},"id":"DSCPDef","type":"object","example":{"description":"Assured Forwarding Class 1 Low Drop","name":"AF11","id":10}},"authorization":"required"},"Update DSCPs":{"description":"Update DSCP configuration (only name and description can be updated).","request":{"description":"List of DSCP objects.","items":{"description":"Object representing DSCP information.","required":false,"properties":{"id":{"description":"ID of the DSCP.","required":true,"type":"number"},"description":{"description":"Description of the DSCP.","required":true,"type":"string"},"name":{"description":"Name of the DSCP.","required":true,"type":"string"}},"id":"DSCPDef","type":"object"},"id":"CDSCPDefs","type":"array","example":[{"description":"Assured Forwarding Class 1 Medium Drop","name":"AF12","id":12},{"description":"","name":"","id":13},{"description":"Assured Forwarding Class 1 High Drop","name":"AF13","id":14}]},"httpmethod":"PUT","path":"dscps","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Update DSCP":{"description":"Update information for a specific DSCP.","request":{"description":"Object representing DSCP information.","properties":{"id":{"description":"ID of the DSCP.","required":true,"type":"number"},"description":{"description":"Description of the DSCP.","required":true,"type":"string"},"name":{"description":"Name of the DSCP.","required":true,"type":"string"}},"id":"DSCPDef","type":"object","example":{"description":"Assured Forwarding Class 1 Low Drop","name":"AF11","id":10}},"httpmethod":"PUT","path":"dscps\/{dscp_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"}}},"Port_Groups":{"methods":{"Get port group":{"description":"Get one port group.","formats":["xml","json"],"httpmethod":"GET","path":"port_groups\/{group_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing port group information.","properties":{"id":{"description":"ID of the port group. To be used in the API.","required":false,"type":"number"},"definitions":{"description":"Object with port group's definitions.","items":{"description":"Port associated with port group.","required":false,"properties":{"port":{"description":"Port associated with port group.","required":true,"type":"number"},"proto":{"description":"Protocol that corresponds to the port of the port group.","required":true,"type":"number"}},"id":"CPortGroupProtoPort","type":"object"},"required":true,"id":"CPortGroupProtoPorts","type":"array"},"name":{"description":"Name of the port group.","required":true,"type":"string"}},"id":"CPortGroupDef","type":"object","example":{"definitions":[{"port":137,"proto":6},{"port":137,"proto":17},{"port":138,"proto":6},{"port":138,"proto":17},{"port":139,"proto":6},{"port":139,"proto":17}],"id":3,"name":"netbios"}},"authorization":"required"},"Create port group":{"description":"Create a new port group.","formats":["xml","json"],"request":{"description":"Object representing port group information.","properties":{"id":{"description":"ID of the port group. To be used in the API.","required":false,"type":"number"},"definitions":{"description":"Object with port group's definitions.","items":{"description":"Port associated with port group.","required":false,"properties":{"port":{"description":"Port associated with port group.","required":true,"type":"number"},"proto":{"description":"Protocol that corresponds to the port of the port group.","required":true,"type":"number"}},"id":"CPortGroupProtoPort","type":"object"},"required":true,"id":"CPortGroupProtoPorts","type":"array"},"name":{"description":"Name of the port group.","required":true,"type":"string"}},"id":"CPortGroupDef","type":"object","example":{"definitions":[{"port":137,"proto":6},{"port":137,"proto":17},{"port":138,"proto":6},{"port":138,"proto":17},{"port":139,"proto":6},{"port":139,"proto":17}],"id":3,"name":"netbios"}},"httpmethod":"POST","path":"port_groups","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing port group information.","properties":{"id":{"description":"ID of the port group. To be used in the API.","required":false,"type":"number"},"definitions":{"description":"Object with port group's definitions.","items":{"description":"Port associated with port group.","required":false,"properties":{"port":{"description":"Port associated with port group.","required":true,"type":"number"},"proto":{"description":"Protocol that corresponds to the port of the port group.","required":true,"type":"number"}},"id":"CPortGroupProtoPort","type":"object"},"required":true,"id":"CPortGroupProtoPorts","type":"array"},"name":{"description":"Name of the port group.","required":true,"type":"string"}},"id":"CPortGroupDef","type":"object","example":{"definitions":[{"port":137,"proto":6},{"port":137,"proto":17},{"port":138,"proto":6},{"port":138,"proto":17},{"port":139,"proto":6},{"port":139,"proto":17}],"id":3,"name":"netbios"}},"authorization":"required"},"List port groups":{"description":"Get a list of all configured port groups.","formats":["xml","json"],"httpmethod":"GET","path":"port_groups","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of Port Group objects.","items":{"description":"Object representing port group information.","required":false,"properties":{"id":{"description":"ID of the port group. To be used in the API.","required":false,"type":"number"},"definitions":{"description":"Object with port group's definitions.","items":{"description":"Port associated with port group.","required":false,"properties":{"port":{"description":"Port associated with port group.","required":true,"type":"number"},"proto":{"description":"Protocol that corresponds to the port of the port group.","required":true,"type":"number"}},"id":"CPortGroupProtoPort","type":"object"},"required":true,"id":"CPortGroupProtoPorts","type":"array"},"name":{"description":"Name of the port group.","required":true,"type":"string"}},"id":"CPortGroupDef","type":"object"},"id":"CPortGroupDefs","type":"array","example":[{"definitions":[{"port":25,"proto":6},{"port":995,"proto":6},{"port":995,"proto":17},{"port":1109,"proto":6}],"id":2,"name":"mail"},{"definitions":[{"port":137,"proto":6},{"port":137,"proto":17},{"port":138,"proto":6},{"port":138,"proto":17},{"port":139,"proto":6},{"port":139,"proto":17}],"id":3,"name":"netbios"}]},"authorization":"required"},"Update port group":{"description":"Update one port group.","request":{"description":"Object representing port group information.","properties":{"id":{"description":"ID of the port group. To be used in the API.","required":false,"type":"number"},"definitions":{"description":"Object with port group's definitions.","items":{"description":"Port associated with port group.","required":false,"properties":{"port":{"description":"Port associated with port group.","required":true,"type":"number"},"proto":{"description":"Protocol that corresponds to the port of the port group.","required":true,"type":"number"}},"id":"CPortGroupProtoPort","type":"object"},"required":true,"id":"CPortGroupProtoPorts","type":"array"},"name":{"description":"Name of the port group.","required":true,"type":"string"}},"id":"CPortGroupDef","type":"object","example":{"definitions":[{"port":137,"proto":6},{"port":137,"proto":17},{"port":138,"proto":6},{"port":138,"proto":17},{"port":139,"proto":6},{"port":139,"proto":17}],"id":3,"name":"netbios"}},"httpmethod":"PUT","path":"port_groups\/{group_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Delete":{"description":"Delete one port group.","httpmethod":"DELETE","path":"port_groups\/{group_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"}}},"Ping":{"methods":{"Ping":{"description":"Simple test of service availability.","httpmethod":"GET","path":"ping","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"}}},"Sharks":{"methods":{"Enable Sharks polling":{"description":"Enables data polling from Sharks.","request":{"description":"IP addresses object representing the list of all Sharks.","items":{"description":"IP address collection object representing the list of all Sharks.","required":false,"properties":{"ipaddr":{"description":"IP address representing a Shark.","required":true,"type":"string"}},"id":"SharkIPAddr","type":"object"},"id":"SharkIPAddrs","type":"array","example":[{"ipaddr":"10.99.16.252"},{"ipaddr":"10.99.15.252"},{"ipaddr":"10.99.14.252"}]},"httpmethod":"POST","path":"sharks\/sync\/enable","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Sync Sharks apps":{"description":"Retrieves application data from Sharks on which polling is enabled.","request":{"description":"IP addresses object representing the list of all Sharks.","items":{"description":"IP address collection object representing the list of all Sharks.","required":false,"properties":{"ipaddr":{"description":"IP address representing a Shark.","required":true,"type":"string"}},"id":"SharkIPAddr","type":"object"},"id":"SharkIPAddrs","type":"array","example":[{"ipaddr":"10.99.16.252"},{"ipaddr":"10.99.15.252"},{"ipaddr":"10.99.14.252"}]},"httpmethod":"POST","path":"sharks\/apps\/sync","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Get Shark apps":{"description":"Get configuration of a Shark by IP address.","formats":["xml","json"],"httpmethod":"GET","path":"sharks\/{shark_ip}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing a Shark.","properties":{"sync":{"description":"Object representing Shark syncronization information.","required":true,"properties":{"apps":{"description":"Object representing Shark application syncronization information.","required":true,"properties":{"enabled":{"description":"Flag indicating if application synchronization is enabled on this Shark.","required":true,"type":"string"},"error_text":{"description":"Error description.","required":true,"type":"string"},"last_sync_ts":{"description":"Last attempted application syncronization time.","required":true,"type":"number"},"last_success_ts":{"description":"Last successful application syncronization time.","required":true,"type":"number"},"error_id":{"description":"Error ID.","required":true,"type":"number"},"state":{"description":"Synchronization status.","required":true,"type":"string","enum":["SYNC_INITIALIZING","SYNC_FAILED","SYNC_SUCCEEDED","SYNC_DISABLED","SYNC_NA"]}},"id":"SharkAppsObject","type":"object"}},"id":"SharkSyncObject","type":"object"},"ipaddr":{"description":"Shark IP address.","required":true,"type":"string"}},"id":"Shark","type":"object"},"authorization":"required"},"Ping Shark":{"description":"Ping a Shark by IP address.","httpmethod":"GET","path":"sharks\/{shark_ip}\/ping","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Disable Sharks polling":{"description":"Disables data polling from Sharks.","request":{"description":"IP addresses object representing the list of all Sharks.","items":{"description":"IP address collection object representing the list of all Sharks.","required":false,"properties":{"ipaddr":{"description":"IP address representing a Shark.","required":true,"type":"string"}},"id":"SharkIPAddr","type":"object"},"id":"SharkIPAddrs","type":"array","example":[{"ipaddr":"10.99.16.252"},{"ipaddr":"10.99.15.252"},{"ipaddr":"10.99.14.252"}]},"httpmethod":"POST","path":"sharks\/sync\/disable","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"List Sharks":{"description":"Get a list of Sharks and their application configuration data.","formats":["xml","json"],"httpmethod":"GET","path":"sharks","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of Sharks and their configuration data.","items":{"description":"Shark configuration data.","required":false,"properties":{"sync":{"description":"Object representing Shark syncronization information.","required":true,"properties":{"apps":{"description":"Object representing Shark application syncronization information.","required":true,"properties":{"enabled":{"description":"Flag indicating if application synchronization is enabled on this Shark.","required":true,"type":"string"},"error_text":{"description":"Error description.","required":true,"type":"string"},"last_sync_ts":{"description":"Last attempted application syncronization time.","required":true,"type":"number"},"last_success_ts":{"description":"Last successful application syncronization time.","required":true,"type":"number"},"error_id":{"description":"Error ID.","required":true,"type":"number"},"state":{"description":"Synchronization status.","required":true,"type":"string","enum":["SYNC_INITIALIZING","SYNC_FAILED","SYNC_SUCCEEDED","SYNC_DISABLED","SYNC_NA"]}},"id":"SharkAppsObject","type":"object"}},"id":"SharkSyncObject","type":"object"},"ipaddr":{"description":"Shark IP address.","required":true,"type":"string"}},"id":"Shark","type":"object"},"id":"Sharks","type":"array","example":[]},"authorization":"required"}}},"Interfaces":{"methods":{"Delete interface":{"description":"Delete one network interface.","httpmethod":"DELETE","path":"interfaces\/{ip:ifindex}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Update interfaces":{"description":"Update network interfaces (fields that can be update: label, inbound speed, outbound speed).","request":{"description":"List of update interfaces.","items":{"description":"object representing update interface.","required":false,"properties":{"user_inbound_speed":{"description":"update interface's inbound speed declared by the user.","required":true,"type":"number"},"ipaddr":{"description":"update interface's IP address.","required":true,"type":"string"},"label":{"description":"update interface's label.","required":true,"type":"string"},"user_outbound_speed":{"description":"update interface's outbound speed declared by the user.","required":true,"type":"number"},"ifindex":{"description":"update interface's index.","required":true,"type":"number"}},"id":"CInterfaceUpdateDef_1_2","type":"object"},"id":"CInterfaceUpdateDefs_1_2","type":"array","example":[{"ifindex":2,"user_outbound_speed":44153724,"ipaddr":"10.2.3.5","user_inbound_speed":140736208929648,"label":"hsdgs"},{"ifindex":3,"user_outbound_speed":44153724,"ipaddr":"10.2.3.5","user_inbound_speed":140736208929648,"label":"jhgvas"}]},"httpmethod":"PUT","path":"interfaces","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Get interface":{"description":"Get one network interface.","formats":["xml","json"],"httpmethod":"GET","path":"interfaces\/{ip:ifindex}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing an interface.","properties":{"mac":{"description":"Interface's mac address.","required":true,"type":"string"},"id":{"description":"Interface's ID.","required":true,"type":"number"},"ifdescr":{"description":"Name (ifDescr).","required":true,"type":"string"},"outbound_speed":{"description":"Interface's reported outbound speed.","required":true,"type":"number"},"user_inbound_speed":{"description":"Interface's inbound speed declared by the user.","required":true,"type":"number"},"ipaddr":{"description":"IP address of the interface.","required":true,"type":"string"},"label":{"description":"Interface's label.","required":true,"type":"string"},"user_outbound_speed":{"description":"Interface's outbound speed declared by the user.","required":true,"type":"number"},"ifalias":{"description":"Description (ifAlias).","required":true,"type":"string"},"inbound_speed":{"description":"Interface's reported inbound speed.","required":true,"type":"number"},"ifindex":{"description":"Interface's index.","required":true,"type":"number"}},"id":"CInterfaceDef_1_2","type":"object","example":{"ipaddr":"10.2.3.5","ifalias":"5","user_inbound_speed":140736208929648,"inbound_speed":140736208929120,"label":"4","mac":"08:00:2b:01:02:04","ifdescr":"6","ifindex":2,"outbound_speed":140736208929104,"user_outbound_speed":44153724,"id":2}},"authorization":"required"},"List interfaces":{"description":"Get a list of all known network interfaces.","parameters":{"offset":{"required":false,"type":"number","description":"Starting element number."},"ipaddr":{"required":false,"type":"string","description":"Filter network interfaces by an IP address."},"limit":{"required":false,"type":"number","description":"Number of rows to be returned."}},"formats":["xml","json"],"httpmethod":"GET","path":"interfaces","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of interfaces.","items":{"description":"Object representing an interface.","required":false,"properties":{"mac":{"description":"Interface's mac address.","required":true,"type":"string"},"id":{"description":"Interface's ID.","required":true,"type":"number"},"ifdescr":{"description":"Name (ifDescr).","required":true,"type":"string"},"outbound_speed":{"description":"Interface's reported outbound speed.","required":true,"type":"number"},"user_inbound_speed":{"description":"Interface's inbound speed declared by the user.","required":true,"type":"number"},"ipaddr":{"description":"IP address of the interface.","required":true,"type":"string"},"label":{"description":"Interface's label.","required":true,"type":"string"},"user_outbound_speed":{"description":"Interface's outbound speed declared by the user.","required":true,"type":"number"},"ifalias":{"description":"Description (ifAlias).","required":true,"type":"string"},"inbound_speed":{"description":"Interface's reported inbound speed.","required":true,"type":"number"},"ifindex":{"description":"Interface's index.","required":true,"type":"number"}},"id":"CInterfaceDef_1_2","type":"object"},"id":"CInterfaceDefs_1_2","type":"array","example":[{"ipaddr":"10.2.5.5","ifalias":"5","user_inbound_speed":140736208929648,"inbound_speed":140736208929120,"label":"4","mac":"08:00:2b:01:02:04","ifdescr":"6","ifindex":2,"outbound_speed":140736208929104,"user_outbound_speed":44153724,"id":3},{"ipaddr":"10.2.5.5","ifalias":"5","user_inbound_speed":140736208929648,"inbound_speed":140736208929120,"label":"unique","mac":"08:00:2b:01:02:05","ifdescr":"6","ifindex":2,"outbound_speed":140736208929104,"user_outbound_speed":44153724,"id":4}]},"authorization":"required"}}},"Reporting":{"methods":{"List reports":{"description":"Get a list of reports with their respective status.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/reports","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of report objects.","items":{"description":"Object representing report information.","required":false,"properties":{"run_time":{"description":"Time when the report was run (Unix time).","required":true,"type":"number"},"error_text":{"description":"A report can be completed with an error. Error message may provide more detailed info.","required":false,"type":"string"},"remaining_seconds":{"description":"Number of seconds remaining to run the report. Even if this number is 0, the report may not yet be completed, so check 'status' to make sure what the status is.","required":true,"type":"number"},"saved":{"description":"Boolean flag indicating if the report was saved.","required":true,"type":"string"},"id":{"description":"ID of the report. To be used in the API.","required":true,"type":"number"},"status":{"description":"Status of the report.","required":true,"type":"string","enum":["completed","running","waiting"]},"percent":{"description":"Progress of the report represented by percentage of report completion.","required":true,"type":"number"},"user_id":{"description":"ID of the user who owns the report.","required":true,"type":"number"},"size":{"description":"Size of the report in kilobytes.","required":true,"type":"number"},"name":{"description":"Name of the report. Could be given by a user or automatically generated by the system.","required":false,"type":"string"},"template_id":{"description":"ID of the template that the report is based on.","required":true,"type":"number"}},"id":"ReportInfo","type":"object"},"id":"ReportInfoList","type":"array","example":[{"status":"completed","user_id":1,"name":"","percent":100,"id":1000,"remaining_seconds":0,"run_time":1352494550,"saved":false,"template_id":952,"error_text":"","size":140},{"status":"completed","user_id":1,"name":"Host Information Report","percent":100,"id":1001,"remaining_seconds":0,"run_time":1352494550,"saved":true,"template_id":952,"error_text":"","size":140}]},"authorization":"required"},"Get widget":{"description":"Get one widget from the template section.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/templates\/{template_id}\/sections\/{section_id}\/widgets\/{widget_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Widget specification.","properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object","example":{"title":"VoIP-RTP: Applications","timestamp":"1383141976.674383","criteria":{"sort_column":33,"traffic_expression":"","centricity":"host","limit":100,"columns":[17,33,34,757,766,781,803],"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"n_items":20},"config":{"widget_type":"APPS","visualization":"TABLE","datasource":"TRAFFIC"},"widget_id":1}},"authorization":"required"},"Get factory widget":{"description":"Get configuration of a stock widget.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/templates\/widgets\/{widget_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Widget specification.","properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object","example":{"title":"VoIP-RTP: Applications","timestamp":"1383141976.674383","criteria":{"sort_column":33,"traffic_expression":"","centricity":"host","limit":100,"columns":[17,33,34,757,766,781,803],"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"n_items":20},"config":{"widget_type":"APPS","visualization":"TABLE","datasource":"TRAFFIC"},"widget_id":1}},"authorization":"required"},"List directions":{"description":"Get a list of directions that this version of the API supports.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/directions","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of directions.","items":{"description":"Object representing a direction.","required":false,"properties":{"id":{"description":"ID of a direction. To be used in the API.","required":true,"type":"string"},"name":{"description":"Human-readable name of a direction.","required":true,"type":"string"}},"id":"Direction","type":"object"},"id":"Directions","type":"array","example":[{"id":"inn","name":"in"},{"id":"out","name":"out"},{"id":"c2s","name":"client to server"},{"id":"s2c","name":"server to client"}]},"authorization":"required"},"Update template":{"description":"Update reporting template.","formats":["xml","json"],"request":{"description":"Reporting template specification object.","properties":{"traffic_expression":{"description":"Traffic expression applied to all widgets within the template.","required":false,"type":"string"},"id":{"description":"ID of the report template.","required":false,"type":"number"},"scheduled":{"description":"Flag indicating that the template is scheduled.","required":false,"type":"string"},"sharing":{"description":"List of the users the template is shared with (see ReportTemplateSharing).","required":false,"properties":{"users":{"description":"List of the users a template is shared with.","items":{"description":"User ID.","required":false,"type":"number"},"required":false,"id":"ReportTemplateSharingUsers","type":"array"}},"id":"ReportTemplateSharing","type":"object"},"layout":{"description":"Layout information.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"},"description":{"description":"Human-readable description of the template.","required":false,"type":"string"},"user_id":{"description":"User ID of the template owner.","required":false,"type":"number"},"shared":{"description":"Flag indicating that the template is shared with other users.","required":false,"type":"string","enum":["Private","Public","Users"]},"live":{"description":"Flag indicating that the template is a dashboard.","required":true,"type":"string"},"last_added_section_id":{"description":"ID of the last layout section added to the template.","required":false,"type":"number"},"name":{"description":"Human-readable name of the template.","required":true,"type":"string"},"last_added_widget_id":{"description":"ID of the last widget added to the template.","required":false,"type":"number"},"version":{"description":"Version of the specification.","required":false,"type":"string"},"disabled":{"description":"Flag indicating that the template is disabled.","required":false,"type":"string"},"timestamp":{"description":"Report time stamp (unix time).","required":false,"type":"string"},"sections":{"description":"List of layout sections.","items":{"description":"One TMSection object.","required":false,"properties":{"widgets":{"description":"List of widgets that belong to the section.","items":{"description":"One TMWidget object.","required":false,"properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object"},"required":false,"id":"TMWidgets","type":"array"},"section_id":{"description":"Section ID.","required":true,"type":"number"},"layout":{"description":"Internal section layout.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"}},"id":"TMSection","type":"object"},"required":false,"id":"TMSections","type":"array"},"img":{"description":"Images associaled with the template.","required":false,"properties":{"thumbnail":{"description":"A thumbnail-size image for the report template.","required":false,"properties":{"src":{"description":"Relative URL of an image.","required":true,"type":"string"}},"id":"ReportTemplateImgProperties","type":"object"},"full":{"description":"A full-size image for the report template.","required":false,"properties":{"src":{"description":"Relative URL of an image.","required":true,"type":"string"}},"id":"ReportTemplateImgProperties","type":"object"}},"id":"ReportTemplateImg","type":"object"}},"id":"ReportTemplateSpec","type":"object","example":{"layout":[{"flow_items":[{"id":1}]}],"name":"VOIP - Call Quality and Usage","user_id":1,"timestamp":"1383141976.674345","live":true,"last_added_widget_id":6,"traffic_expression":"app VoIP-RTP","version":"1.1","shared":"Private","sections":[{"widgets":[{"title":"VoIP-RTP: Applications","timestamp":"1383141976.674383","criteria":{"sort_column":33,"traffic_expression":"","sort_desc":true,"centricity":"host","limit":100,"columns":[17,33,34,757,766,781,803],"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"n_items":20},"config":{"widget_type":"APPS","visualization":"TABLE","datasource":"TRAFFIC"},"widget_id":1},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674428","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[803],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":1,"extend_to_zero":false,"line_scale":"LINEAR","line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":2},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674459","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[781],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":1,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":3},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674497","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[766],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":4},{"title":"VoIP-RTP: Traffic Volume","timestamp":"1383141976.674527","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[33],"time_frame":{"data_resolution":"15mins","type":"last_day","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":5},{"title":"Host Group Pairs","timestamp":"1383141976.674566","criteria":{"sort_column":33,"traffic_expression":"","host_group_type":"ByLocation","sort_desc":true,"centricity":"host","limit":100,"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","show_images":true,"layout":"HORIZONTAL_TREE","colspan":2,"moveable_nodes":true,"height":400,"edge_thickness":true,"pan_zoomable":true,"n_items":10},"config":{"widget_type":"HOST_GROUP_PAIRS","visualization":"CONN_GRAPH","datasource":"TRAFFIC"},"widget_id":6}],"layout":[{"flow_items":[{"id":1}]},{"flow_items":[{"id":2},{"id":3}]},{"flow_items":[{"id":4}]},{"flow_items":[{"id":5}]},{"flow_items":[{"id":6}]}],"section_id":1}],"id":5217,"description":""}},"httpmethod":"PUT","path":"reporting\/templates\/{template_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Reporting template specification object.","properties":{"traffic_expression":{"description":"Traffic expression applied to all widgets within the template.","required":false,"type":"string"},"id":{"description":"ID of the report template.","required":false,"type":"number"},"scheduled":{"description":"Flag indicating that the template is scheduled.","required":false,"type":"string"},"sharing":{"description":"List of the users the template is shared with (see ReportTemplateSharing).","required":false,"properties":{"users":{"description":"List of the users a template is shared with.","items":{"description":"User ID.","required":false,"type":"number"},"required":false,"id":"ReportTemplateSharingUsers","type":"array"}},"id":"ReportTemplateSharing","type":"object"},"layout":{"description":"Layout information.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"},"description":{"description":"Human-readable description of the template.","required":false,"type":"string"},"user_id":{"description":"User ID of the template owner.","required":false,"type":"number"},"shared":{"description":"Flag indicating that the template is shared with other users.","required":false,"type":"string","enum":["Private","Public","Users"]},"live":{"description":"Flag indicating that the template is a dashboard.","required":true,"type":"string"},"last_added_section_id":{"description":"ID of the last layout section added to the template.","required":false,"type":"number"},"name":{"description":"Human-readable name of the template.","required":true,"type":"string"},"last_added_widget_id":{"description":"ID of the last widget added to the template.","required":false,"type":"number"},"version":{"description":"Version of the specification.","required":false,"type":"string"},"disabled":{"description":"Flag indicating that the template is disabled.","required":false,"type":"string"},"timestamp":{"description":"Report time stamp (unix time).","required":false,"type":"string"},"sections":{"description":"List of layout sections.","items":{"description":"One TMSection object.","required":false,"properties":{"widgets":{"description":"List of widgets that belong to the section.","items":{"description":"One TMWidget object.","required":false,"properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object"},"required":false,"id":"TMWidgets","type":"array"},"section_id":{"description":"Section ID.","required":true,"type":"number"},"layout":{"description":"Internal section layout.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"}},"id":"TMSection","type":"object"},"required":false,"id":"TMSections","type":"array"},"img":{"description":"Images associaled with the template.","required":false,"properties":{"thumbnail":{"description":"A thumbnail-size image for the report template.","required":false,"properties":{"src":{"description":"Relative URL of an image.","required":true,"type":"string"}},"id":"ReportTemplateImgProperties","type":"object"},"full":{"description":"A full-size image for the report template.","required":false,"properties":{"src":{"description":"Relative URL of an image.","required":true,"type":"string"}},"id":"ReportTemplateImgProperties","type":"object"}},"id":"ReportTemplateImg","type":"object"}},"id":"ReportTemplateSpec","type":"object","example":{"layout":[{"flow_items":[{"id":1}]}],"name":"VOIP - Call Quality and Usage","user_id":1,"timestamp":"1383141976.674345","live":true,"last_added_widget_id":6,"traffic_expression":"app VoIP-RTP","version":"1.1","shared":"Private","sections":[{"widgets":[{"title":"VoIP-RTP: Applications","timestamp":"1383141976.674383","criteria":{"sort_column":33,"traffic_expression":"","sort_desc":true,"centricity":"host","limit":100,"columns":[17,33,34,757,766,781,803],"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"n_items":20},"config":{"widget_type":"APPS","visualization":"TABLE","datasource":"TRAFFIC"},"widget_id":1},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674428","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[803],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":1,"extend_to_zero":false,"line_scale":"LINEAR","line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":2},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674459","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[781],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":1,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":3},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674497","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[766],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":4},{"title":"VoIP-RTP: Traffic Volume","timestamp":"1383141976.674527","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[33],"time_frame":{"data_resolution":"15mins","type":"last_day","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":5},{"title":"Host Group Pairs","timestamp":"1383141976.674566","criteria":{"sort_column":33,"traffic_expression":"","host_group_type":"ByLocation","sort_desc":true,"centricity":"host","limit":100,"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","show_images":true,"layout":"HORIZONTAL_TREE","colspan":2,"moveable_nodes":true,"height":400,"edge_thickness":true,"pan_zoomable":true,"n_items":10},"config":{"widget_type":"HOST_GROUP_PAIRS","visualization":"CONN_GRAPH","datasource":"TRAFFIC"},"widget_id":6}],"layout":[{"flow_items":[{"id":1}]},{"flow_items":[{"id":2},{"id":3}]},{"flow_items":[{"id":4}]},{"flow_items":[{"id":5}]},{"flow_items":[{"id":6}]}],"section_id":1}],"id":5217,"description":""}},"authorization":"required"},"List categories":{"description":"Get a list of categories that this version of the API supports.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/categories","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of categories.","items":{"description":"Object representing a category.","required":false,"properties":{"id":{"description":"ID of a category. To be used in the API.","required":true,"type":"string"},"name":{"description":"Human-readable name of a category.","required":true,"type":"string"}},"id":"Category","type":"object"},"id":"Categories","type":"array","example":[{"id":"idx","name":"index"},{"id":"key","name":"key"}]},"authorization":"required"},"Get user attributes":{"description":"Get user-specific template attributes.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/templates\/{template_id}\/sections\/{section_id}\/widgets\/{widget_id}\/user_attributes","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Set of widget attributes.","properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object","example":[]},"authorization":"required"},"List statictics":{"description":"Get a list of statistics that this version of the API supports.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/statistics","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of statistics.","items":{"description":"Object representing a statistic.","required":false,"properties":{"id":{"description":"ID of a statistic. To be used in the API.","required":true,"type":"string"},"name":{"description":"Human-readable name of a statistic.","required":true,"type":"string"}},"id":"Statistic","type":"object"},"id":"Statistics","type":"array","example":[{"id":"tot","name":"total"},{"id":"avg","name":"average"},{"id":"pek","name":"peak"},{"id":"min","name":"min"}]},"authorization":"required"},"Set section layout":{"description":"Set the layout of widgets in a grid in the template section.","request":{"description":"Object representing visual layout of widgets in a secion.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"id":"TMFlowLines","type":"array","example":[]},"httpmethod":"PUT","path":"reporting\/templates\/{template_id}\/sections\/{section_id}\/layout","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"List widgets":{"description":"Get the widgets located in the template section.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/templates\/{template_id}\/sections\/{section_id}\/widgets","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of TMWidget objects.","items":{"description":"One TMWidget object.","required":false,"properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object"},"id":"TMWidgets","type":"array","example":[{"title":"VoIP-RTP: Applications","timestamp":"1383141976.674383","criteria":{"sort_column":33,"traffic_expression":"","centricity":"host","limit":100,"columns":[17,33,34,757,766,781,803],"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"n_items":20},"config":{"widget_type":"APPS","visualization":"TABLE","datasource":"TRAFFIC"},"widget_id":1}]},"authorization":"required"},"Delete report":{"description":"Delete a report.","httpmethod":"DELETE","path":"reporting\/reports\/{report_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"List realms":{"description":"Get a list of realms.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/realms","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of type of report queries (realms) that could be requested and run.","items":{"description":"Object representing a realm.","required":false,"properties":{"id":{"description":"ID of a realm. To be used in the API.","required":true,"type":"string"},"name":{"description":"Human-readable name of a realm.","required":true,"type":"string"}},"id":"Realm","type":"object"},"id":"Realms","type":"array","example":[{"id":"traffic_summary","name":"traffic summary"},{"id":"traffic_flow_list","name":"traffic flow list"},{"id":"traffic_overall_time_series","name":"traffic overall time series"}]},"authorization":"required"},"Delete widget":{"description":"Delete one widget from the template section.","httpmethod":"DELETE","path":"reporting\/templates\/{template_id}\/sections\/{section_id}\/widgets\/{widget_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Update widget":{"description":"Update one widget in the template section.","request":{"description":"Widget specification.","properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object","example":{"title":"VoIP-RTP: Applications","timestamp":"1383141976.674383","criteria":{"sort_column":33,"traffic_expression":"","centricity":"host","limit":100,"columns":[17,33,34,757,766,781,803],"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"n_items":20},"config":{"widget_type":"APPS","visualization":"TABLE","datasource":"TRAFFIC"},"widget_id":1}},"httpmethod":"PUT","path":"reporting\/templates\/{template_id}\/sections\/{section_id}\/widgets\/{widget_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"List centricities":{"description":"Get a list of centricities that this version of the API supports.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/centricities","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of centricities.","items":{"description":"Object representing a centricity.","required":false,"properties":{"id":{"description":"ID of a centricity. To be used in the API.","required":true,"type":"string"},"name":{"description":"Human-readable name of a centricity.","required":true,"type":"string"}},"id":"Centricity","type":"object"},"id":"Centricities","type":"array","example":[{"id":"hos","name":"host"},{"id":"int","name":"interface"}]},"authorization":"required"},"Import templates":{"description":"Import reporting templates.","request":{"description":"List of ReportTemplateSpec objects.","items":{"description":"One ReportTemplateSpes object.","required":false,"properties":{"traffic_expression":{"description":"Traffic expression applied to all widgets within the template.","required":false,"type":"string"},"id":{"description":"ID of the report template.","required":false,"type":"number"},"scheduled":{"description":"Flag indicating that the template is scheduled.","required":false,"type":"string"},"sharing":{"description":"List of the users the template is shared with (see ReportTemplateSharing).","required":false,"properties":{"users":{"description":"List of the users a template is shared with.","items":{"description":"User ID.","required":false,"type":"number"},"required":false,"id":"ReportTemplateSharingUsers","type":"array"}},"id":"ReportTemplateSharing","type":"object"},"layout":{"description":"Layout information.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"},"description":{"description":"Human-readable description of the template.","required":false,"type":"string"},"user_id":{"description":"User ID of the template owner.","required":false,"type":"number"},"shared":{"description":"Flag indicating that the template is shared with other users.","required":false,"type":"string","enum":["Private","Public","Users"]},"live":{"description":"Flag indicating that the template is a dashboard.","required":true,"type":"string"},"last_added_section_id":{"description":"ID of the last layout section added to the template.","required":false,"type":"number"},"name":{"description":"Human-readable name of the template.","required":true,"type":"string"},"last_added_widget_id":{"description":"ID of the last widget added to the template.","required":false,"type":"number"},"version":{"description":"Version of the specification.","required":false,"type":"string"},"disabled":{"description":"Flag indicating that the template is disabled.","required":false,"type":"string"},"timestamp":{"description":"Report time stamp (unix time).","required":false,"type":"string"},"sections":{"description":"List of layout sections.","items":{"description":"One TMSection object.","required":false,"properties":{"widgets":{"description":"List of widgets that belong to the section.","items":{"description":"One TMWidget object.","required":false,"properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object"},"required":false,"id":"TMWidgets","type":"array"},"section_id":{"description":"Section ID.","required":true,"type":"number"},"layout":{"description":"Internal section layout.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"}},"id":"TMSection","type":"object"},"required":false,"id":"TMSections","type":"array"},"img":{"description":"Images associaled with the template.","required":false,"properties":{"thumbnail":{"description":"A thumbnail-size image for the report template.","required":false,"properties":{"src":{"description":"Relative URL of an image.","required":true,"type":"string"}},"id":"ReportTemplateImgProperties","type":"object"},"full":{"description":"A full-size image for the report template.","required":false,"properties":{"src":{"description":"Relative URL of an image.","required":true,"type":"string"}},"id":"ReportTemplateImgProperties","type":"object"}},"id":"ReportTemplateImg","type":"object"}},"id":"ReportTemplateSpec","type":"object"},"id":"ReportTemplateSpecs","type":"array","example":[{"layout":[{"flow_items":[{"id":1}]}],"name":"VOIP - Call Quality and Usage","user_id":1,"timestamp":"1383141976.674345","live":true,"last_added_widget_id":6,"traffic_expression":"app VoIP-RTP","version":"1.1","shared":"Private","sections":[{"widgets":[{"title":"VoIP-RTP: Applications","timestamp":"1383141976.674383","criteria":{"sort_column":33,"traffic_expression":"","sort_desc":true,"centricity":"host","limit":100,"columns":[17,33,34,757,766,781,803],"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"n_items":20},"config":{"widget_type":"APPS","visualization":"TABLE","datasource":"TRAFFIC"},"widget_id":1},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674428","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[803],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":1,"extend_to_zero":false,"line_scale":"LINEAR","line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":2},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674459","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[781],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":1,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":3},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674497","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[766],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":4},{"title":"VoIP-RTP: Traffic Volume","timestamp":"1383141976.674527","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[33],"time_frame":{"data_resolution":"15mins","type":"last_day","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":5},{"title":"Host Group Pairs","timestamp":"1383141976.674566","criteria":{"sort_column":33,"traffic_expression":"","host_group_type":"ByLocation","sort_desc":true,"centricity":"host","limit":100,"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","show_images":true,"layout":"HORIZONTAL_TREE","colspan":2,"moveable_nodes":true,"height":400,"edge_thickness":true,"pan_zoomable":true,"n_items":10},"config":{"widget_type":"HOST_GROUP_PAIRS","visualization":"CONN_GRAPH","datasource":"TRAFFIC"},"widget_id":6}],"layout":[{"flow_items":[{"id":1}]},{"flow_items":[{"id":2},{"id":3}]},{"flow_items":[{"id":4}]},{"flow_items":[{"id":5}]},{"flow_items":[{"id":6}]}],"section_id":1}],"id":5217,"description":""}]},"httpmethod":"POST","path":"reporting\/templates\/import","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"List units":{"description":"Get a list of units that this version of the API supports.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/units","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of units.","items":{"description":"Object representing a unit.","required":false,"properties":{"id":{"description":"ID of a unit. To be used in the API.","required":true,"type":"string"},"name":{"description":"Human-readable name of a unit.","required":true,"type":"string"}},"id":"Unit","type":"object"},"id":"Units","type":"array","example":[{"id":"byt","name":"bytes"},{"id":"pkt","name":"packet"},{"id":"con","name":"conntions"}]},"authorization":"required"},"Create template":{"description":"Create a new reporting template.","formats":["xml","json"],"request":{"description":"Reporting template specification object.","properties":{"traffic_expression":{"description":"Traffic expression applied to all widgets within the template.","required":false,"type":"string"},"id":{"description":"ID of the report template.","required":false,"type":"number"},"scheduled":{"description":"Flag indicating that the template is scheduled.","required":false,"type":"string"},"sharing":{"description":"List of the users the template is shared with (see ReportTemplateSharing).","required":false,"properties":{"users":{"description":"List of the users a template is shared with.","items":{"description":"User ID.","required":false,"type":"number"},"required":false,"id":"ReportTemplateSharingUsers","type":"array"}},"id":"ReportTemplateSharing","type":"object"},"layout":{"description":"Layout information.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"},"description":{"description":"Human-readable description of the template.","required":false,"type":"string"},"user_id":{"description":"User ID of the template owner.","required":false,"type":"number"},"shared":{"description":"Flag indicating that the template is shared with other users.","required":false,"type":"string","enum":["Private","Public","Users"]},"live":{"description":"Flag indicating that the template is a dashboard.","required":true,"type":"string"},"last_added_section_id":{"description":"ID of the last layout section added to the template.","required":false,"type":"number"},"name":{"description":"Human-readable name of the template.","required":true,"type":"string"},"last_added_widget_id":{"description":"ID of the last widget added to the template.","required":false,"type":"number"},"version":{"description":"Version of the specification.","required":false,"type":"string"},"disabled":{"description":"Flag indicating that the template is disabled.","required":false,"type":"string"},"timestamp":{"description":"Report time stamp (unix time).","required":false,"type":"string"},"sections":{"description":"List of layout sections.","items":{"description":"One TMSection object.","required":false,"properties":{"widgets":{"description":"List of widgets that belong to the section.","items":{"description":"One TMWidget object.","required":false,"properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object"},"required":false,"id":"TMWidgets","type":"array"},"section_id":{"description":"Section ID.","required":true,"type":"number"},"layout":{"description":"Internal section layout.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"}},"id":"TMSection","type":"object"},"required":false,"id":"TMSections","type":"array"},"img":{"description":"Images associaled with the template.","required":false,"properties":{"thumbnail":{"description":"A thumbnail-size image for the report template.","required":false,"properties":{"src":{"description":"Relative URL of an image.","required":true,"type":"string"}},"id":"ReportTemplateImgProperties","type":"object"},"full":{"description":"A full-size image for the report template.","required":false,"properties":{"src":{"description":"Relative URL of an image.","required":true,"type":"string"}},"id":"ReportTemplateImgProperties","type":"object"}},"id":"ReportTemplateImg","type":"object"}},"id":"ReportTemplateSpec","type":"object","example":{"layout":[{"flow_items":[{"id":1}]}],"name":"VOIP - Call Quality and Usage","user_id":1,"timestamp":"1383141976.674345","live":true,"last_added_widget_id":6,"traffic_expression":"app VoIP-RTP","version":"1.1","shared":"Private","sections":[{"widgets":[{"title":"VoIP-RTP: Applications","timestamp":"1383141976.674383","criteria":{"sort_column":33,"traffic_expression":"","sort_desc":true,"centricity":"host","limit":100,"columns":[17,33,34,757,766,781,803],"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"n_items":20},"config":{"widget_type":"APPS","visualization":"TABLE","datasource":"TRAFFIC"},"widget_id":1},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674428","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[803],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":1,"extend_to_zero":false,"line_scale":"LINEAR","line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":2},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674459","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[781],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":1,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":3},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674497","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[766],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":4},{"title":"VoIP-RTP: Traffic Volume","timestamp":"1383141976.674527","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[33],"time_frame":{"data_resolution":"15mins","type":"last_day","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":5},{"title":"Host Group Pairs","timestamp":"1383141976.674566","criteria":{"sort_column":33,"traffic_expression":"","host_group_type":"ByLocation","sort_desc":true,"centricity":"host","limit":100,"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","show_images":true,"layout":"HORIZONTAL_TREE","colspan":2,"moveable_nodes":true,"height":400,"edge_thickness":true,"pan_zoomable":true,"n_items":10},"config":{"widget_type":"HOST_GROUP_PAIRS","visualization":"CONN_GRAPH","datasource":"TRAFFIC"},"widget_id":6}],"layout":[{"flow_items":[{"id":1}]},{"flow_items":[{"id":2},{"id":3}]},{"flow_items":[{"id":4}]},{"flow_items":[{"id":5}]},{"flow_items":[{"id":6}]}],"section_id":1}],"id":5217,"description":""}},"httpmethod":"POST","path":"reporting\/templates","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"A template for running reports.","properties":{"traffic_expression":{"description":"Traffic expression applied to all widgets within this template.","required":false,"type":"string"},"schedule_type":{"description":"Type of template scheduling.","required":false,"type":"string","enum":["Once","Hourly","Daily","Weekly","Monthly","Quarterly"]},"id":{"description":"ID of the template.","required":true,"type":"number"},"scheduled":{"description":"Flag indicating that the template is scheduled.","required":false,"type":"string"},"sharing":{"description":"List of the users the template is shared with (see ReportTemplateSharing).","required":false,"properties":{"users":{"description":"List of the users a template is shared with.","items":{"description":"User ID.","required":false,"type":"number"},"required":false,"id":"ReportTemplateSharingUsers","type":"array"}},"id":"ReportTemplateSharing","type":"object"},"description":{"description":"Description of the template.","required":false,"type":"string"},"user_id":{"description":"ID of the user who owns the template.","required":false,"type":"number"},"shared":{"description":"Flag indicating that the template is shared with other users.","required":false,"type":"string","enum":["Private","Public","Users"]},"live":{"description":"Flag indicating that the template is a dashboard.","required":true,"type":"string"},"name":{"description":"Human-readable name of the template.","required":true,"type":"string"},"disabled":{"description":"Flag indicating that data collection for the template is disabled.","required":false,"type":"string"},"next_run":{"description":"Next run time for the template if the template is scheduled to run.","required":false,"type":"number"}},"id":"ReportTemplate","type":"object","example":{"user_id":1,"live":true,"id":1000,"name":"My Template"}},"authorization":"required"},"Get reporting end times":{"description":"List end times for each data source.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/timestamps","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Collection of ReportTimestamp objects.","items":{"description":"Object representing report timing information.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. (can be: 1min, 15min, hour, 6hour, day, week, month).","required":true,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"end_time":{"description":"Report end time (unix time).","required":true,"type":"number"},"datasource":{"description":"Report data source type (can be: TRAFFIC, SERVICE, EVENTS, ACTIVE_DIRECTORY).","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]}},"id":"ReportTimestamp","type":"object"},"id":"ReportTimestamps","type":"array","example":[{"data_resolution":"day","end_time":1383105600,"datasource":"TRAFFIC"},{"data_resolution":"15mins","end_time":1383160500,"datasource":"SERVICE"},{"data_resolution":"min","end_time":1383161280,"datasource":"TRAFFIC"},{"data_resolution":"6hours","end_time":1383148800,"datasource":"TRAFFIC"},{"data_resolution":"hour","end_time":1383159600,"datasource":"TRAFFIC"},{"data_resolution":"15mins","end_time":1383160500,"datasource":"TRAFFIC"}]},"authorization":"required"},"List severities":{"description":"Get a list of severities that this version of the API supports.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/severities","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of severities.","items":{"description":"Object representing a severity.","required":false,"properties":{"id":{"description":"ID of a severity. To be used in the API.","required":true,"type":"string"},"name":{"description":"Human-readable name of a severity.","required":true,"type":"string"}},"id":"Severity","type":"object"},"id":"Severities","type":"array","example":[{"id":"nav","name":"not available"},{"id":"nml","name":"normal"},{"id":"low","name":"low"},{"id":"med","name":"medium"},{"id":"hgh","name":"high"},{"id":"all","name":"all"}]},"authorization":"required"},"Get query data":{"description":"Get data for one or many columns from this query.","parameters":{"columns":{"required":false,"type":"string","description":"Comma-separated list of column ids."},"offset":{"required":false,"type":"number","description":"Start row."},"limit":{"required":false,"type":"number","description":"Number of rows to be returned."}},"formats":["xml","json"],"httpmethod":"GET","path":"reporting\/reports\/{report_id}\/queries\/{query_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing a 2-dimensional array of query data and totals.","properties":{"data":{"description":"Two-dimensional data array.","items":{"description":"One row in the list of rows.","items":{"description":"One value datum.","required":false,"type":"string"},"required":false,"id":"Row","type":"array"},"required":true,"id":"Rows","type":"array"},"data_size":{"description":"Number of rows in the data array.","required":false,"type":"number"},"totals":{"description":"Object representing a row of total values (totals).","items":{"description":"One total datum.","required":false,"type":"string"},"required":false,"id":"Totals","type":"array"}},"id":"DataResults","type":"object","example":{"data":[["10.38.8.202|","6878717.15556","7041.06111111"],["10.38.9.152|","1996165.24167","2049.01388889"]],"data_size":3744,"totals":["","20293913.8417","23577.3055556"]}},"authorization":"required"},"List group bys":{"description":"Get a list of reporting summarizations (group bys).","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/group_bys","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of reporting summarizations (group-bys).","items":{"description":"Object representing a group by.","required":false,"properties":{"id":{"description":"ID of a group by. To be used in the API.","required":true,"type":"string"},"name":{"description":"Human-readable name of a group by.","required":true,"type":"string"}},"id":"GroupBy","type":"object"},"id":"GroupBys","type":"array","example":[{"id":"hos","name":"host"},{"id":"hop","name":"host pair"},{"id":"gro","name":"host group"},{"id":"gpp","name":"host group pair"}]},"authorization":"required"},"Create widget":{"description":"Create a new widget in the template section.","formats":["xml","json"],"request":{"description":"Widget specification.","properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object","example":{"title":"VoIP-RTP: Applications","timestamp":"1383141976.674383","criteria":{"sort_column":33,"traffic_expression":"","centricity":"host","limit":100,"columns":[17,33,34,757,766,781,803],"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"n_items":20},"config":{"widget_type":"APPS","visualization":"TABLE","datasource":"TRAFFIC"},"widget_id":1}},"httpmethod":"POST","path":"reporting\/templates\/{template_id}\/sections\/{section_id}\/widgets","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Widget specification.","properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object","example":{"title":"VoIP-RTP: Applications","timestamp":"1383141976.674383","criteria":{"sort_column":33,"traffic_expression":"","centricity":"host","limit":100,"columns":[17,33,34,757,766,781,803],"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"n_items":20},"config":{"widget_type":"APPS","visualization":"TABLE","datasource":"TRAFFIC"},"widget_id":1}},"authorization":"required"},"List columns":{"description":"Get a list of columns.","parameters":{"metric":{"required":false,"type":"string","description":"Filter the list of columns by metric."},"statistic":{"required":false,"type":"string","description":"Filter the list of columns by statistic."},"severity":{"required":false,"type":"string","description":"Filter the list of columns by severity."},"role":{"required":false,"type":"string","description":"Filter the list of columns by role."},"category":{"required":false,"type":"string","description":"Filter the list of columns by category."},"group_by":{"required":false,"type":"string","description":"Filter the list of columns by group by."},"direction":{"required":false,"type":"string","description":"Filter the list of columns by direction."},"area":{"required":false,"type":"string","description":"Filter the list of columns by area."},"centricity":{"required":false,"type":"string","description":"Filter the list of columns by centricity."},"unit":{"required":false,"type":"string","description":"Filter the list of columns by unit."},"rate":{"required":false,"type":"string","description":"Filter the list of columns by rate."},"realm":{"required":false,"type":"string","description":"Filter the list of columns by realm."}},"formats":["xml","json"],"httpmethod":"GET","path":"reporting\/columns","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of reporting query columns.","items":{"description":"A column for reporting query.","required":false,"properties":{"metric":{"description":"Column 'metric'. See 'reporting\/metrics'.","required":true,"type":"string"},"cli_srv":{"description":"Text flag indicating if the column is for the clients or servers.","required":true,"type":"string"},"comparison_parameter":{"description":"Parameter for column comparison.","required":true,"type":"string"},"internal":{"description":"Boolean flag indicating if the column is internal to the system.","required":true,"type":"string"},"id":{"description":"System ID for the column. Used in the API.","required":true,"type":"number"},"strid":{"description":"String ID for the column. Not used by the API, but easier for the human user to see.","required":true,"type":"string"},"statistic":{"description":"Column 'statistic'. See 'reporting\/statistics'.","required":true,"type":"string"},"severity":{"description":"Column 'severity'. See 'reporting\/severities.","required":true,"type":"string"},"role":{"description":"Column 'role'. See 'reporting\/roles'.","required":true,"type":"string"},"category":{"description":"Column 'category'. See 'reporting\/categories'.","required":true,"type":"string"},"name":{"description":"Column name. Format used for column names is similar to the format used for column data.","required":true,"type":"string"},"comparison":{"description":"Column 'comparison'. See 'reporting\/comparisons'.","required":true,"type":"string"},"sortable":{"description":"Boolean flag indicating if this data can be sorted on this column when running the template.","required":true,"type":"string"},"type":{"description":"Type of the column data. See 'reporting\/types'.","required":true,"type":"string"},"direction":{"description":"Column 'direction'. See 'reporting\/directions'.","required":true,"type":"string"},"available":{"description":"Boolean flag indicating that the data for the column is available without the need to re-run the template.","required":true,"type":"string"},"context":{"description":"Internal flag used for formatting certain kinds of data.","required":true,"type":"string"},"area":{"description":"Column 'area'. See 'reporting\/area'.","required":true,"type":"string"},"has_others":{"description":"Boolean flag indicating if the column's 'other' row can be computed.","required":true,"type":"string"},"unit":{"description":"Column 'unit'. See 'reporting\/units'.","required":true,"type":"string"},"name_type":{"description":"Type of the column name. See 'reporting\/types'.","required":true,"type":"string"},"rate":{"description":"Column 'rate'. See 'reporting\/rates'.","required":true,"type":"string"}},"id":"Column","type":"object"},"id":"Columns","type":"array","example":[{"strid":"ID_TOTAL_BYTES","metric":"net_bw","rate":"count","statistic":"total","id":30,"unit":"bytes","category":"data","severity":"none","area":"none","internal":false,"role":"none","cli_srv":"none","type":"int","available":false,"direction":"none","comparison":"none","sortable":true,"name":"Total Bytes","comparison_parameter":"","has_others":false,"context":false,"name_type":"colname_parts"},{"strid":"ID_TOTAL_PKTS","metric":"net_bw","rate":"count","statistic":"total","id":31,"unit":"pkts","category":"data","severity":"none","area":"none","internal":false,"role":"none","cli_srv":"none","type":"int","available":false,"direction":"none","comparison":"none","sortable":true,"name":"Total Packets","comparison_parameter":"","has_others":false,"context":false,"name_type":"colname_parts"}]},"authorization":"required"},"Get section layout":{"description":"Get the layout of the template section.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/templates\/{template_id}\/sections\/{section_id}\/layout","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing visual layout of widgets in a secion.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"id":"TMFlowLines","type":"array","example":[]},"authorization":"required"},"Get report":{"description":"Get information for report. Includes progress information for running reports.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/reports\/{report_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing report information.","properties":{"run_time":{"description":"Time when the report was run (Unix time).","required":true,"type":"number"},"error_text":{"description":"A report can be completed with an error. Error message may provide more detailed info.","required":false,"type":"string"},"remaining_seconds":{"description":"Number of seconds remaining to run the report. Even if this number is 0, the report may not yet be completed, so check 'status' to make sure what the status is.","required":true,"type":"number"},"saved":{"description":"Boolean flag indicating if the report was saved.","required":true,"type":"string"},"id":{"description":"ID of the report. To be used in the API.","required":true,"type":"number"},"status":{"description":"Status of the report.","required":true,"type":"string","enum":["completed","running","waiting"]},"percent":{"description":"Progress of the report represented by percentage of report completion.","required":true,"type":"number"},"user_id":{"description":"ID of the user who owns the report.","required":true,"type":"number"},"size":{"description":"Size of the report in kilobytes.","required":true,"type":"number"},"name":{"description":"Name of the report. Could be given by a user or automatically generated by the system.","required":false,"type":"string"},"template_id":{"description":"ID of the template that the report is based on.","required":true,"type":"number"}},"id":"ReportInfo","type":"object","example":{"status":"completed","user_id":1,"name":"Host Information Report","percent":100,"id":1001,"remaining_seconds":0,"run_time":1352494550,"saved":true,"template_id":952,"error_text":"","size":140}},"authorization":"required"},"Get template configuration":{"description":"Get template configuration data.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/templates\/{template_id}\/config","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Reporting template specification object.","properties":{"traffic_expression":{"description":"Traffic expression applied to all widgets within the template.","required":false,"type":"string"},"id":{"description":"ID of the report template.","required":false,"type":"number"},"scheduled":{"description":"Flag indicating that the template is scheduled.","required":false,"type":"string"},"sharing":{"description":"List of the users the template is shared with (see ReportTemplateSharing).","required":false,"properties":{"users":{"description":"List of the users a template is shared with.","items":{"description":"User ID.","required":false,"type":"number"},"required":false,"id":"ReportTemplateSharingUsers","type":"array"}},"id":"ReportTemplateSharing","type":"object"},"layout":{"description":"Layout information.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"},"description":{"description":"Human-readable description of the template.","required":false,"type":"string"},"user_id":{"description":"User ID of the template owner.","required":false,"type":"number"},"shared":{"description":"Flag indicating that the template is shared with other users.","required":false,"type":"string","enum":["Private","Public","Users"]},"live":{"description":"Flag indicating that the template is a dashboard.","required":true,"type":"string"},"last_added_section_id":{"description":"ID of the last layout section added to the template.","required":false,"type":"number"},"name":{"description":"Human-readable name of the template.","required":true,"type":"string"},"last_added_widget_id":{"description":"ID of the last widget added to the template.","required":false,"type":"number"},"version":{"description":"Version of the specification.","required":false,"type":"string"},"disabled":{"description":"Flag indicating that the template is disabled.","required":false,"type":"string"},"timestamp":{"description":"Report time stamp (unix time).","required":false,"type":"string"},"sections":{"description":"List of layout sections.","items":{"description":"One TMSection object.","required":false,"properties":{"widgets":{"description":"List of widgets that belong to the section.","items":{"description":"One TMWidget object.","required":false,"properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object"},"required":false,"id":"TMWidgets","type":"array"},"section_id":{"description":"Section ID.","required":true,"type":"number"},"layout":{"description":"Internal section layout.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"}},"id":"TMSection","type":"object"},"required":false,"id":"TMSections","type":"array"},"img":{"description":"Images associaled with the template.","required":false,"properties":{"thumbnail":{"description":"A thumbnail-size image for the report template.","required":false,"properties":{"src":{"description":"Relative URL of an image.","required":true,"type":"string"}},"id":"ReportTemplateImgProperties","type":"object"},"full":{"description":"A full-size image for the report template.","required":false,"properties":{"src":{"description":"Relative URL of an image.","required":true,"type":"string"}},"id":"ReportTemplateImgProperties","type":"object"}},"id":"ReportTemplateImg","type":"object"}},"id":"ReportTemplateSpec","type":"object","example":{"layout":[{"flow_items":[{"id":1}]}],"name":"VOIP - Call Quality and Usage","user_id":1,"timestamp":"1383141976.674345","live":true,"last_added_widget_id":6,"traffic_expression":"app VoIP-RTP","version":"1.1","shared":"Private","sections":[{"widgets":[{"title":"VoIP-RTP: Applications","timestamp":"1383141976.674383","criteria":{"sort_column":33,"traffic_expression":"","sort_desc":true,"centricity":"host","limit":100,"columns":[17,33,34,757,766,781,803],"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"n_items":20},"config":{"widget_type":"APPS","visualization":"TABLE","datasource":"TRAFFIC"},"widget_id":1},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674428","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[803],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":1,"extend_to_zero":false,"line_scale":"LINEAR","line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":2},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674459","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[781],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":1,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":3},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674497","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[766],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":4},{"title":"VoIP-RTP: Traffic Volume","timestamp":"1383141976.674527","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[33],"time_frame":{"data_resolution":"15mins","type":"last_day","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":5},{"title":"Host Group Pairs","timestamp":"1383141976.674566","criteria":{"sort_column":33,"traffic_expression":"","host_group_type":"ByLocation","sort_desc":true,"centricity":"host","limit":100,"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","show_images":true,"layout":"HORIZONTAL_TREE","colspan":2,"moveable_nodes":true,"height":400,"edge_thickness":true,"pan_zoomable":true,"n_items":10},"config":{"widget_type":"HOST_GROUP_PAIRS","visualization":"CONN_GRAPH","datasource":"TRAFFIC"},"widget_id":6}],"layout":[{"flow_items":[{"id":1}]},{"flow_items":[{"id":2},{"id":3}]},{"flow_items":[{"id":4}]},{"flow_items":[{"id":5}]},{"flow_items":[{"id":6}]}],"section_id":1}],"id":5217,"description":""}},"authorization":"required"},"Clone template":{"description":"Clone the specified reporting template.","parameters":{"template":{"required":true,"type":"number","description":"ID of the template being cloned."},"name":{"required":false,"type":"string","description":"A new unique name for the copy."}},"formats":["xml","json"],"httpmethod":"POST","path":"reporting\/templates\/copy","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"A template for running reports.","properties":{"traffic_expression":{"description":"Traffic expression applied to all widgets within this template.","required":false,"type":"string"},"schedule_type":{"description":"Type of template scheduling.","required":false,"type":"string","enum":["Once","Hourly","Daily","Weekly","Monthly","Quarterly"]},"id":{"description":"ID of the template.","required":true,"type":"number"},"scheduled":{"description":"Flag indicating that the template is scheduled.","required":false,"type":"string"},"sharing":{"description":"List of the users the template is shared with (see ReportTemplateSharing).","required":false,"properties":{"users":{"description":"List of the users a template is shared with.","items":{"description":"User ID.","required":false,"type":"number"},"required":false,"id":"ReportTemplateSharingUsers","type":"array"}},"id":"ReportTemplateSharing","type":"object"},"description":{"description":"Description of the template.","required":false,"type":"string"},"user_id":{"description":"ID of the user who owns the template.","required":false,"type":"number"},"shared":{"description":"Flag indicating that the template is shared with other users.","required":false,"type":"string","enum":["Private","Public","Users"]},"live":{"description":"Flag indicating that the template is a dashboard.","required":true,"type":"string"},"name":{"description":"Human-readable name of the template.","required":true,"type":"string"},"disabled":{"description":"Flag indicating that data collection for the template is disabled.","required":false,"type":"string"},"next_run":{"description":"Next run time for the template if the template is scheduled to run.","required":false,"type":"number"}},"id":"ReportTemplate","type":"object","example":{"user_id":1,"live":true,"id":1000,"name":"My Template"}},"authorization":"required"},"Delete template":{"description":"Delete reporting template.","formats":["xml","json"],"httpmethod":"DELETE","path":"reporting\/templates\/{template_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"A template for running reports.","properties":{"traffic_expression":{"description":"Traffic expression applied to all widgets within this template.","required":false,"type":"string"},"schedule_type":{"description":"Type of template scheduling.","required":false,"type":"string","enum":["Once","Hourly","Daily","Weekly","Monthly","Quarterly"]},"id":{"description":"ID of the template.","required":true,"type":"number"},"scheduled":{"description":"Flag indicating that the template is scheduled.","required":false,"type":"string"},"sharing":{"description":"List of the users the template is shared with (see ReportTemplateSharing).","required":false,"properties":{"users":{"description":"List of the users a template is shared with.","items":{"description":"User ID.","required":false,"type":"number"},"required":false,"id":"ReportTemplateSharingUsers","type":"array"}},"id":"ReportTemplateSharing","type":"object"},"description":{"description":"Description of the template.","required":false,"type":"string"},"user_id":{"description":"ID of the user who owns the template.","required":false,"type":"number"},"shared":{"description":"Flag indicating that the template is shared with other users.","required":false,"type":"string","enum":["Private","Public","Users"]},"live":{"description":"Flag indicating that the template is a dashboard.","required":true,"type":"string"},"name":{"description":"Human-readable name of the template.","required":true,"type":"string"},"disabled":{"description":"Flag indicating that data collection for the template is disabled.","required":false,"type":"string"},"next_run":{"description":"Next run time for the template if the template is scheduled to run.","required":false,"type":"number"}},"id":"ReportTemplate","type":"object","example":{"user_id":1,"live":true,"id":1000,"name":"My Template"}},"authorization":"required"},"List templates":{"description":"Get a list of templates.","parameters":{"offset":{"required":false,"type":"number","description":"Starting element number."},"access":{"required":false,"type":"string","description":"Get only template with the specified access level: 'public' or 'private'."},"filter":{"required":false,"type":"string","description":"Apply a named filter: 'owned' to get only templates owned by the current user."},"live":{"required":false,"type":"string","description":"Filter only live (dashboard) templates."},"limit":{"required":false,"type":"number","description":"Number of rows to be returned."}},"formats":["xml","json"],"httpmethod":"GET","path":"reporting\/templates","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of templates available on the system.","items":{"description":"One template in the list of templates.","required":false,"properties":{"traffic_expression":{"description":"Traffic expression applied to all widgets within this template.","required":false,"type":"string"},"schedule_type":{"description":"Type of template scheduling.","required":false,"type":"string","enum":["Once","Hourly","Daily","Weekly","Monthly","Quarterly"]},"id":{"description":"ID of the template.","required":true,"type":"number"},"scheduled":{"description":"Flag indicating that the template is scheduled.","required":false,"type":"string"},"sharing":{"description":"List of the users the template is shared with (see ReportTemplateSharing).","required":false,"properties":{"users":{"description":"List of the users a template is shared with.","items":{"description":"User ID.","required":false,"type":"number"},"required":false,"id":"ReportTemplateSharingUsers","type":"array"}},"id":"ReportTemplateSharing","type":"object"},"description":{"description":"Description of the template.","required":false,"type":"string"},"user_id":{"description":"ID of the user who owns the template.","required":false,"type":"number"},"shared":{"description":"Flag indicating that the template is shared with other users.","required":false,"type":"string","enum":["Private","Public","Users"]},"live":{"description":"Flag indicating that the template is a dashboard.","required":true,"type":"string"},"name":{"description":"Human-readable name of the template.","required":true,"type":"string"},"disabled":{"description":"Flag indicating that data collection for the template is disabled.","required":false,"type":"string"},"next_run":{"description":"Next run time for the template if the template is scheduled to run.","required":false,"type":"number"}},"id":"ReportTemplate","type":"object"},"id":"ReportTemplates","type":"array","example":[{"scheduled":false,"live":false,"id":184,"name":"Default template for class QUERY"},{"scheduled":true,"next_run":1352328480,"user_id":1,"live":true,"schedule_type":"Hourly","id":1000,"name":"My Template"}]},"authorization":"required"},"Get factory widgets":{"description":"Get a list of all available stock widget configurations.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/templates\/widgets","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of TMWidget objects.","items":{"description":"One TMWidget object.","required":false,"properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object"},"id":"TMWidgets","type":"array","example":[{"title":"VoIP-RTP: Applications","timestamp":"1383141976.674383","criteria":{"sort_column":33,"traffic_expression":"","centricity":"host","limit":100,"columns":[17,33,34,757,766,781,803],"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"n_items":20},"config":{"widget_type":"APPS","visualization":"TABLE","datasource":"TRAFFIC"},"widget_id":1}]},"authorization":"required"},"Export templates":{"description":"Export all reporting templates.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/templates\/export","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of ReportTemplateSpec objects.","items":{"description":"One ReportTemplateSpes object.","required":false,"properties":{"traffic_expression":{"description":"Traffic expression applied to all widgets within the template.","required":false,"type":"string"},"id":{"description":"ID of the report template.","required":false,"type":"number"},"scheduled":{"description":"Flag indicating that the template is scheduled.","required":false,"type":"string"},"sharing":{"description":"List of the users the template is shared with (see ReportTemplateSharing).","required":false,"properties":{"users":{"description":"List of the users a template is shared with.","items":{"description":"User ID.","required":false,"type":"number"},"required":false,"id":"ReportTemplateSharingUsers","type":"array"}},"id":"ReportTemplateSharing","type":"object"},"layout":{"description":"Layout information.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"},"description":{"description":"Human-readable description of the template.","required":false,"type":"string"},"user_id":{"description":"User ID of the template owner.","required":false,"type":"number"},"shared":{"description":"Flag indicating that the template is shared with other users.","required":false,"type":"string","enum":["Private","Public","Users"]},"live":{"description":"Flag indicating that the template is a dashboard.","required":true,"type":"string"},"last_added_section_id":{"description":"ID of the last layout section added to the template.","required":false,"type":"number"},"name":{"description":"Human-readable name of the template.","required":true,"type":"string"},"last_added_widget_id":{"description":"ID of the last widget added to the template.","required":false,"type":"number"},"version":{"description":"Version of the specification.","required":false,"type":"string"},"disabled":{"description":"Flag indicating that the template is disabled.","required":false,"type":"string"},"timestamp":{"description":"Report time stamp (unix time).","required":false,"type":"string"},"sections":{"description":"List of layout sections.","items":{"description":"One TMSection object.","required":false,"properties":{"widgets":{"description":"List of widgets that belong to the section.","items":{"description":"One TMWidget object.","required":false,"properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object"},"required":false,"id":"TMWidgets","type":"array"},"section_id":{"description":"Section ID.","required":true,"type":"number"},"layout":{"description":"Internal section layout.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"}},"id":"TMSection","type":"object"},"required":false,"id":"TMSections","type":"array"},"img":{"description":"Images associaled with the template.","required":false,"properties":{"thumbnail":{"description":"A thumbnail-size image for the report template.","required":false,"properties":{"src":{"description":"Relative URL of an image.","required":true,"type":"string"}},"id":"ReportTemplateImgProperties","type":"object"},"full":{"description":"A full-size image for the report template.","required":false,"properties":{"src":{"description":"Relative URL of an image.","required":true,"type":"string"}},"id":"ReportTemplateImgProperties","type":"object"}},"id":"ReportTemplateImg","type":"object"}},"id":"ReportTemplateSpec","type":"object"},"id":"ReportTemplateSpecs","type":"array","example":[{"layout":[{"flow_items":[{"id":1}]}],"name":"VOIP - Call Quality and Usage","user_id":1,"timestamp":"1383141976.674345","live":true,"last_added_widget_id":6,"traffic_expression":"app VoIP-RTP","version":"1.1","shared":"Private","sections":[{"widgets":[{"title":"VoIP-RTP: Applications","timestamp":"1383141976.674383","criteria":{"sort_column":33,"traffic_expression":"","sort_desc":true,"centricity":"host","limit":100,"columns":[17,33,34,757,766,781,803],"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"n_items":20},"config":{"widget_type":"APPS","visualization":"TABLE","datasource":"TRAFFIC"},"widget_id":1},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674428","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[803],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":1,"extend_to_zero":false,"line_scale":"LINEAR","line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":2},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674459","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[781],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":1,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":3},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674497","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[766],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":4},{"title":"VoIP-RTP: Traffic Volume","timestamp":"1383141976.674527","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[33],"time_frame":{"data_resolution":"15mins","type":"last_day","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":5},{"title":"Host Group Pairs","timestamp":"1383141976.674566","criteria":{"sort_column":33,"traffic_expression":"","host_group_type":"ByLocation","sort_desc":true,"centricity":"host","limit":100,"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","show_images":true,"layout":"HORIZONTAL_TREE","colspan":2,"moveable_nodes":true,"height":400,"edge_thickness":true,"pan_zoomable":true,"n_items":10},"config":{"widget_type":"HOST_GROUP_PAIRS","visualization":"CONN_GRAPH","datasource":"TRAFFIC"},"widget_id":6}],"layout":[{"flow_items":[{"id":1}]},{"flow_items":[{"id":2},{"id":3}]},{"flow_items":[{"id":4}]},{"flow_items":[{"id":5}]},{"flow_items":[{"id":6}]}],"section_id":1}],"id":5217,"description":""}]},"authorization":"required"},"Get report config":{"description":"Get configuration information for one report. Includes criteria, layout and GUI attributes.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/reports\/{report_id}\/config","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing report configuration.","properties":{"criteria":{"description":"Report criteria.","required":true,"properties":{"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"time_frame":{"description":"Time frame object.","required":false,"properties":{"resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month. If not specified a resolution will automatically be selected based on time frame of the report.","required":false,"type":"string"},"end":{"description":"Report end time (unix time).","required":false,"type":"number"},"expression":{"description":"Traffic expression.","required":false,"type":"string"},"start":{"description":"Report start time (unix time).","required":false,"type":"number"}},"id":"ReportTimeFrame","type":"object"},"query":{"description":"Query object.","required":false,"properties":{"columns":{"description":"Query columns. Can be many of GET \/reporting\/columns.","items":{"description":"Query column.","required":false,"type":"number"},"required":false,"id":"ReportQueryFilterColumns","type":"array"},"role":{"description":"Query role. Can be one of \/reporting\/roles.","required":false,"type":"string"},"group_by":{"description":"Query group_by. Can be one of GET \/reporting\/group_bys.","required":false,"type":"string"},"host_group_type":{"description":"Query host group type. Required for \"host group (gro)\" \"host group pairs (gpp)\" and \"host group pairs with ports (gpr)\" queries.","required":false,"type":"string"},"direction":{"description":"Query direction. Can be one of GET \/reporting\/directions.","required":false,"type":"string"},"sort_column":{"description":"Query sort column. Can be one of GET \/reporting\/columns.","required":false,"type":"number"},"area":{"description":"Query area. Can be one of GET \/reporting\/areas.","required":false,"type":"string"},"centricity":{"description":"Query centricity. Can be one of GET \/reporting\/centricities.","required":false,"type":"string"},"realm":{"description":"Query realm. Can be one of GET \/reporting\/realms.","required":true,"type":"string"}},"id":"ReportQueryFilter","type":"object"},"deprecated":{"description":"Map with legacy criteria attributes that will not be supported soon.","required":false,"additionalProperties":{"description":"ReportDeprecatedFilters map value.","required":false,"xmlKeyName":"key","type":"string"},"id":"ReportDeprecatedFilters","type":"object"}},"id":"ReportCriteria","type":"object"},"attributes":{"description":"Report attributes.","required":true,"additionalProperties":{"description":"Report attributes value.","required":false,"xmlKeyName":"key","type":"string"},"id":"ReportConfigAttrs","type":"object"},"sections":{"description":"Report sections.","items":{"description":"One section of a report.","required":false,"properties":{"widgets":{"description":"List of section widgets.","items":{"description":"One widget from a list of widgets.","required":false,"properties":{"query_id":{"description":"Query ID for the query that the widget is based on.","required":true,"type":"string"},"id":{"description":"Widget ID used to reference a widget from the API.","required":true,"type":"string"},"type":{"description":"Visual type of the widget.","required":true,"type":"string"},"attributes":{"description":"Widget attributes.","required":true,"additionalProperties":{"description":"Attribute value in the map.","required":false,"xmlKeyName":"key","type":"string"},"id":"ReportWidgetAttrs","type":"object"}},"id":"ReportWidget","type":"object"},"required":true,"id":"ReportWidgets","type":"array"},"layout":{"description":"Section widget layout.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"items":{"description":"List of items (widgets) on the line.","items":{"description":"One item in the list of layout items.","required":false,"properties":{"id":{"description":"ID of the layout item.","required":false,"type":"string"}},"id":"ReportLayoutItem","type":"object"},"required":true,"id":"ReportLayoutItems","type":"array"},"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"},"line_spacing":{"description":"Line spacing.","required":false,"type":"string"}},"id":"ReportLayoutLine","type":"object"},"required":false,"id":"ReportSectionLayout","type":"array"},"attributes":{"description":"Section attributes.","required":true,"additionalProperties":{"description":"Attribute value in the map.","required":false,"xmlKeyName":"key","type":"string"},"id":"ReportSectionAttrs","type":"object"}},"id":"ReportSection","type":"object"},"required":true,"id":"ReportSections","type":"array"}},"id":"ReportConfig","type":"object","example":{"attributes":{"title":"Report name"},"sections":[{"widgets":[{"type":"table","query_id":"0:sum_hos_non_non_non_non_non_non_non_33_d_0","id":"sum_hos_non_non_non_non_non_non_non_tbl_0_0","attributes":{"page_size":"20","sort_col":"33","col_order":"6,33,34"}}],"attributes":{"sort_desc":"1"},"layout":[{"items":[{"id":"sum_hos_non_non_non_non_non_non_non_tbl_0_0"}]}]}],"criteria":{"time_frame":{"start":1352319891,"end":1352320191},"query":{"realm":"traffic_summary","sort_column":33,"centricity":"hos","group_by":"hos","columns":[6,33,34]}}}},"authorization":"required"},"List areas":{"description":"Get a list of areas that this version of the API supports.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/areas","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of areas.","items":{"description":"Object representing an area.","required":false,"properties":{"id":{"description":"ID of an area. To be used in the API.","required":true,"type":"string"},"name":{"description":"Human-readable name of a area.","required":true,"type":"string"}},"id":"Area","type":"object"},"id":"Areas","type":"array","example":[{"id":"wan","name":"wan"},{"id":"lan","name":"lan"}]},"authorization":"required"},"Update user attributes":{"description":"Merge user-specific template attributes with the new attribute values.","request":{"description":"Set of widget attributes.","properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object","example":[]},"httpmethod":"PUT","path":"reporting\/templates\/{template_id}\/sections\/{section_id}\/widgets\/{widget_id}\/user_attributes","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"List metrics":{"description":"Get a list of metrics that this version of the API supports.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/metrics","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of metrics.","items":{"description":"Object representing a metric.","required":false,"properties":{"id":{"description":"ID of a metric. To be used in the API.","required":true,"type":"string"},"name":{"description":"Human-readable name of a metric.","required":true,"type":"string"}},"id":"Metric","type":"object"},"id":"Metrics","type":"array","example":[{"id":"nbw","name":"net bandwidth"},{"id":"nrt","name":"net rtt"},{"id":"rtm","name":"response time"}]},"authorization":"required"},"List rates":{"description":"Get a list of rates that this version of the API supports.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/rates","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of rates.","items":{"description":"Object representing a rate.","required":false,"properties":{"id":{"description":"ID of a rate. To be used in the API.","required":true,"type":"string"},"name":{"description":"Human-readable name of a rate.","required":true,"type":"string"}},"id":"Rate","type":"object"},"id":"Rates","type":"array","example":[{"id":"cnt","name":"count"},{"id":"psc","name":"per second"}]},"authorization":"required"},"Get template section":{"description":"Get the specific section from the template.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/templates\/{template_id}\/sections\/{section_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"One section in the report layout.","properties":{"widgets":{"description":"List of widgets that belong to the section.","items":{"description":"One TMWidget object.","required":false,"properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object"},"required":false,"id":"TMWidgets","type":"array"},"section_id":{"description":"Section ID.","required":true,"type":"number"},"layout":{"description":"Internal section layout.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"}},"id":"TMSection","type":"object"},"authorization":"required"},"Get template sections":{"description":"Get a list of sections in the template.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/templates\/{template_id}\/sections","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of TMSection objects.","items":{"description":"One TMSection object.","required":false,"properties":{"widgets":{"description":"List of widgets that belong to the section.","items":{"description":"One TMWidget object.","required":false,"properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object"},"required":false,"id":"TMWidgets","type":"array"},"section_id":{"description":"Section ID.","required":true,"type":"number"},"layout":{"description":"Internal section layout.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"}},"id":"TMSection","type":"object"},"id":"TMSections","type":"array","example":[]},"authorization":"required"},"Get template":{"description":"Get a template.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/templates\/{template_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Reporting template specification object.","properties":{"traffic_expression":{"description":"Traffic expression applied to all widgets within the template.","required":false,"type":"string"},"id":{"description":"ID of the report template.","required":false,"type":"number"},"scheduled":{"description":"Flag indicating that the template is scheduled.","required":false,"type":"string"},"sharing":{"description":"List of the users the template is shared with (see ReportTemplateSharing).","required":false,"properties":{"users":{"description":"List of the users a template is shared with.","items":{"description":"User ID.","required":false,"type":"number"},"required":false,"id":"ReportTemplateSharingUsers","type":"array"}},"id":"ReportTemplateSharing","type":"object"},"layout":{"description":"Layout information.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"},"description":{"description":"Human-readable description of the template.","required":false,"type":"string"},"user_id":{"description":"User ID of the template owner.","required":false,"type":"number"},"shared":{"description":"Flag indicating that the template is shared with other users.","required":false,"type":"string","enum":["Private","Public","Users"]},"live":{"description":"Flag indicating that the template is a dashboard.","required":true,"type":"string"},"last_added_section_id":{"description":"ID of the last layout section added to the template.","required":false,"type":"number"},"name":{"description":"Human-readable name of the template.","required":true,"type":"string"},"last_added_widget_id":{"description":"ID of the last widget added to the template.","required":false,"type":"number"},"version":{"description":"Version of the specification.","required":false,"type":"string"},"disabled":{"description":"Flag indicating that the template is disabled.","required":false,"type":"string"},"timestamp":{"description":"Report time stamp (unix time).","required":false,"type":"string"},"sections":{"description":"List of layout sections.","items":{"description":"One TMSection object.","required":false,"properties":{"widgets":{"description":"List of widgets that belong to the section.","items":{"description":"One TMWidget object.","required":false,"properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object"},"required":false,"id":"TMWidgets","type":"array"},"section_id":{"description":"Section ID.","required":true,"type":"number"},"layout":{"description":"Internal section layout.","items":{"description":"One horizontal line of widgets.","required":false,"properties":{"flow_items":{"description":"List of line items.","items":{"description":"Object replesenting one layout item.","required":false,"properties":{"id":{"description":"Widget ID.","required":false,"type":"number"}},"id":"TMFlowItem","type":"object"},"required":false,"id":"TMFlowItems","type":"array"},"attributes":{"description":"List of line attributes.","required":false,"properties":{"wrappable":{"description":"Flag allowing wrapping.","required":false,"type":"string"},"full_width":{"description":"Flag representing width of the layout line.","required":false,"type":"string"},"item_spacing":{"description":"Item spacing between widgets.","required":false,"type":"string"}},"id":"TMFlowLineAttributes","type":"object"}},"id":"TMFlowLine","type":"object"},"required":false,"id":"TMFlowLines","type":"array"}},"id":"TMSection","type":"object"},"required":false,"id":"TMSections","type":"array"},"img":{"description":"Images associaled with the template.","required":false,"properties":{"thumbnail":{"description":"A thumbnail-size image for the report template.","required":false,"properties":{"src":{"description":"Relative URL of an image.","required":true,"type":"string"}},"id":"ReportTemplateImgProperties","type":"object"},"full":{"description":"A full-size image for the report template.","required":false,"properties":{"src":{"description":"Relative URL of an image.","required":true,"type":"string"}},"id":"ReportTemplateImgProperties","type":"object"}},"id":"ReportTemplateImg","type":"object"}},"id":"ReportTemplateSpec","type":"object","example":{"layout":[{"flow_items":[{"id":1}]}],"name":"VOIP - Call Quality and Usage","user_id":1,"timestamp":"1383141976.674345","live":true,"last_added_widget_id":6,"traffic_expression":"app VoIP-RTP","version":"1.1","shared":"Private","sections":[{"widgets":[{"title":"VoIP-RTP: Applications","timestamp":"1383141976.674383","criteria":{"sort_column":33,"traffic_expression":"","sort_desc":true,"centricity":"host","limit":100,"columns":[17,33,34,757,766,781,803],"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"n_items":20},"config":{"widget_type":"APPS","visualization":"TABLE","datasource":"TRAFFIC"},"widget_id":1},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674428","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[803],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":1,"extend_to_zero":false,"line_scale":"LINEAR","line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":2},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674459","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[781],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":1,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":3},{"title":"VoIP-RTP: Traffic Quality","timestamp":"1383141976.674497","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[766],"time_frame":{"data_resolution":"min","type":"last_hour","refresh_interval":"min"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":4},{"title":"VoIP-RTP: Traffic Volume","timestamp":"1383141976.674527","criteria":{"traffic_expression":"","sort_desc":true,"centricity":"host","columns":[33],"time_frame":{"data_resolution":"15mins","type":"last_day","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"extend_to_zero":false,"line_style":"STACKED"},"config":{"widget_type":"TRAFFIC_OVERALL","visualization":"LINE","datasource":"TRAFFIC"},"widget_id":5},{"title":"Host Group Pairs","timestamp":"1383141976.674566","criteria":{"sort_column":33,"traffic_expression":"","host_group_type":"ByLocation","sort_desc":true,"centricity":"host","limit":100,"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","show_images":true,"layout":"HORIZONTAL_TREE","colspan":2,"moveable_nodes":true,"height":400,"edge_thickness":true,"pan_zoomable":true,"n_items":10},"config":{"widget_type":"HOST_GROUP_PAIRS","visualization":"CONN_GRAPH","datasource":"TRAFFIC"},"widget_id":6}],"layout":[{"flow_items":[{"id":1}]},{"flow_items":[{"id":2},{"id":3}]},{"flow_items":[{"id":4}]},{"flow_items":[{"id":5}]},{"flow_items":[{"id":6}]}],"section_id":1}],"id":5217,"description":""}},"authorization":"required"},"Get report view (PDF, CSV)":{"description":"Get GUI view of a report (PDF, CSV).","formats":["pdf","csv"],"httpmethod":"GET","path":"reporting\/reports\/{report_id}\/view","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"List roles":{"description":"Get a list of roles that this version of the API supports.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/roles","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of roles.","items":{"description":"Object representing a roles.","required":false,"properties":{"id":{"description":"ID of a role. To be used in the API.","required":true,"type":"string"},"name":{"description":"Human-readable name of a role.","required":true,"type":"string"}},"id":"Role","type":"object"},"id":"Roles","type":"array","example":[{"id":"cli","name":"client"},{"id":"srv","name":"server"}]},"authorization":"required"},"Copy widget":{"description":"Copy a widget from one template to another.","parameters":{"widget":{"required":true,"type":"number","description":"ID of the widget being copied."},"dest_template":{"required":true,"type":"number","description":"Destination template ID."},"src_template":{"required":true,"type":"number","description":"Source template ID."}},"formats":["xml","json"],"httpmethod":"POST","path":"reporting\/templates\/widgets\/copy","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Widget specification.","properties":{"config":{"description":"Widget configuration: data source type, widget type, and visualization type.","required":true,"properties":{"datasource":{"description":"Data source type.","required":true,"type":"string","enum":["TRAFFIC","WAN","SERVICE","EVENTS","ACTIVE_DIRECTORY"]},"visualization":{"description":"Visualization type.","required":true,"type":"string","enum":["TABLE","PIE","BAR","LINE","CONN_GRAPH","TREE_TABLE","INVISIBLE"]},"widget_type":{"description":"Widget type.","required":true,"type":"string","enum":["TRAFFIC_OVERALL","TRAFFIC_OVERALL_CRTT","HOSTS","PEER_HOSTS","PEER_HOST_GROUPS","HOST_PAIRS_PORTS","HOST_PAIRS_APP_PORTS","HOST_PAIRS","HOST_GROUPS","HOST_GROUP_PAIRS","HOST_GROUP_PAIR_PORTS","APPS","APP_PORTS","SERVER_APPS","PORTS","PORT_GROUPS","PROTOCOLS","DEVICES","INTERFACES","NETWORK_SEGMENTS","DSCPS","DSCP_APP_PORTS","DSCP_IFACES","CURRENT_EVENTS","UNACKED_EVENTS","ACTIVE_DIRECTORY","SERVICE_HEALTH","LOCATION_HEALTH","SERVICE_HEALTH_MAP","LOCATION_HEALTH_MAP"]}},"id":"TMConfig","type":"object"},"widget_id":{"description":"Internal widget ID within a dashboard.","required":false,"type":"number"},"criteria":{"description":"Query criteria for the widget.","required":true,"properties":{"ports":{"description":"Watched ports.","items":{"description":"One CProtoPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"required":false,"id":"CProtoPorts","type":"array"},"dscp_app_ports":{"description":"Watched combinations of DSCPs, applications, and ports.","items":{"description":"One CDSCPAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPAppPort","type":"object"},"required":false,"id":"CDSCPAppPorts","type":"array"},"services":{"description":"Watched services.","items":{"description":"One CService object.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"required":false,"id":"CServices","type":"array"},"port_groups":{"description":"Watched port groups.","items":{"description":"One CPortGroup object.","required":false,"properties":{"name":{"description":"Name of the port group.","required":false,"type":"string"},"group_id":{"description":"ID of the port group.","required":false,"type":"number"}},"id":"CPortGroup","type":"object"},"required":false,"id":"CPortGroups","type":"array"},"comparison_time_frame":{"description":"Alternative time frame specification to be used in a comparison widget.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"host_group_pairs":{"description":"Watched group pairs.","items":{"description":"One CHostGroupPair object.","required":false,"properties":{"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPair","type":"object"},"required":false,"id":"CHostGroupPairs","type":"array"},"wan_group":{"description":"WAN group used in WAN Optimization widgets. Can be one of '\/WAN', '\/WAN\/Optimized', '\/WAN\/Non-optimized'.","required":false,"type":"string"},"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"split_direction":{"description":"Split inbound\/outbound or received\/transmitted data.","required":false,"type":"string"},"include_successes":{"description":"Include successful requests in active directory report.","required":false,"type":"string"},"include_non_optimized_sites":{"description":"Flag indicating whether to include WAN non optimized sites.","required":false,"type":"string"},"columns":{"description":"List of column ID.","items":{"description":"Column ID.","required":false,"type":"number"},"required":false,"id":"TMColumns","type":"array"},"application_servers":{"description":"Watched combinations of applications and servers.","items":{"description":"One CApplicationServer object.","required":false,"properties":{"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CApplicationServer","type":"object"},"required":false,"id":"CApplicationServers","type":"array"},"devices":{"description":"Watched devices.","items":{"description":"One CDevice object.","required":false,"properties":{"ipaddr":{"description":"Device IP address.","required":false,"type":"string"},"name":{"description":"Device name.","required":false,"type":"string"}},"id":"CDevice","type":"object"},"required":false,"id":"CDevices","type":"array"},"application_ports":{"description":"Watched combinations of applications and ports.","items":{"description":"One CApplicationPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"}},"id":"CApplicationPort","type":"object"},"required":false,"id":"CApplicationPorts","type":"array"},"include_failures":{"description":"Include failed requests in active directory report.","required":false,"type":"string"},"host_pair_ports":{"description":"Watched combinations of host pairs and ports.","items":{"description":"One CHostPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairPort","type":"object"},"required":false,"id":"CHostPairPorts","type":"array"},"dscp_interfaces":{"description":"Watched combinations of DSCPs and interfaces.","items":{"description":"One CDSCPInterface object.","required":false,"properties":{"interface":{"description":"Interface specification.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dscp":{"description":"DSCP specification.","required":true,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"}},"id":"CDSCPInterface","type":"object"},"required":false,"id":"CDSCPInterfaces","type":"array"},"time_frame":{"description":"Widget time frame specification.","required":false,"properties":{"data_resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"refresh_interval":{"description":"Report refresh interval. It can be one of: min, 15mins, hour, 6hours, day, week, month.","required":false,"type":"string","enum":["min","15mins","hour","6hours","day","week","month"]},"type":{"description":"Type of time frame. Can be one of: last_min, last_15mins, last_hour, last_6hours, last_12hours, last_day, last_week, last_month, previous_hour, previous_day, previous_week, previous_month.","required":false,"type":"string","enum":["last_min","last_15mins","last_hour","last_6hours","last_12hours","last_day","last_week","last_month","previous_hour","previous_day","previous_week","previous_month"]}},"id":"TMWidgetTimeFrame","type":"object"},"service":{"description":"Watched service.","required":false,"properties":{"name":{"description":"Service name.","required":true,"type":"string"},"service_id":{"description":"Service ID.","required":false,"type":"number"}},"id":"CService","type":"object"},"severity":{"description":"Minimum severity filter for an event report.","required":false,"type":"number"},"role":{"description":"Which host roles to include in a report ('CLIENT_SERVER', 'CLIENT', 'SERVER').","required":false,"type":"string","enum":["CLIENT_SERVER","CLIENT","SERVER"]},"event_policies":{"description":"List of event policies to include in an event report.","items":{"description":"Event policy ID.","required":false,"type":"number"},"required":false,"id":"EventPolicies","type":"array"},"service_locations":{"description":"Watched service locations.","items":{"description":"One CServiceLocation object.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"required":false,"id":"CServiceLocations","type":"array"},"case_insensitive":{"description":"Case-insensitive usernames in an identity report.","required":false,"type":"string"},"service_location":{"description":"Watched service location.","required":false,"properties":{"name":{"description":"Service location name.","required":true,"type":"string"},"location_id":{"description":"Service location ID.","required":false,"type":"string"}},"id":"CServiceLocation","type":"object"},"include_backend_segments":{"description":"Flag indicating whether to include back-end segments.","required":false,"type":"string"},"host_group_type":{"description":"Host group type used.","required":false,"type":"string"},"host_pair_app_ports":{"description":"Watched combinations of host pairs, applications, and ports.","items":{"description":"One CHostPairAppPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"app":{"description":"Application specification.","required":true,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"server":{"description":"Server host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Client host specification.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPairAppPort","type":"object"},"required":false,"id":"CHostPairAppPorts","type":"array"},"users":{"description":"Watched users.","items":{"description":"One CUser object.","required":false,"properties":{"name":{"description":"Active Directory user name.","required":true,"type":"string"}},"id":"CUser","type":"object"},"required":false,"id":"CUsers","type":"array"},"sort_desc":{"description":"Sorting direction (true for descending, false for ascending).","required":false,"type":"string"},"sort_column":{"description":"Sorting column ID.","required":false,"type":"number"},"host_group_pair_ports":{"description":"Watched combinations of host groups pairs and ports.","items":{"description":"One CHostGroupPairPort object.","required":false,"properties":{"port":{"description":"Port specification.","required":true,"properties":{"port":{"description":"Port specification.","required":false,"type":"number"},"protocol":{"description":"Protocol specification.","required":false,"type":"number"},"name":{"description":"Protocol + port combination name.","required":false,"type":"string"}},"id":"CProtoPort","type":"object"},"server":{"description":"Server host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"client":{"description":"Client host group specification.","required":true,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"}},"id":"CHostGroupPairPort","type":"object"},"required":false,"id":"CHostGroupPairPorts","type":"array"},"network_segments":{"description":"Watched network segments.","items":{"description":"One CNetworkSegment object.","required":false,"properties":{"src":{"description":"Segment source.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"dst":{"description":"Segment destination.","required":true,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"}},"id":"CNetworkSegment","type":"object"},"required":false,"id":"CNetworkSegments","type":"array"},"hosts":{"description":"Watched hosts.","items":{"description":"One CHost object.","required":false,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"required":false,"id":"CHosts","type":"array"},"host_pairs":{"description":"Watched host pairs.","items":{"description":"One CHostPair object.","required":false,"properties":{"server":{"description":"Specification of the server host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"},"client":{"description":"Specification of the client host.","required":true,"properties":{"mac":{"description":"Host MAC address.","required":false,"type":"string"},"ipaddr":{"description":"Host IP address.","required":false,"type":"string"},"name":{"description":"Host name.","required":false,"type":"string"}},"id":"CHost","type":"object"}},"id":"CHostPair","type":"object"},"required":false,"id":"CHostPairs","type":"array"},"protocols":{"description":"Watched protocols.","items":{"description":"Object representing Protocol information.","required":false,"properties":{"id":{"description":"ID of the Protocol.","required":false,"type":"number"},"name":{"description":"Name of the Protocol.","required":false,"type":"string"}},"id":"CProtocol","type":"object"},"required":false,"id":"CProtocols","type":"array"},"centricity":{"description":"Centricity used to run the report.","required":false,"type":"string"},"limit":{"description":"Maximum number of data rows in the report for the widget.","required":false,"type":"number"},"interfaces":{"description":"Watched interfaces.","items":{"description":"One CInterface object.","required":false,"properties":{"ipaddr":{"description":"Interface IP address.","required":false,"type":"string"},"name":{"description":"Interface name.","required":false,"type":"string"},"ifindex":{"description":"Interface index.","required":false,"type":"number"}},"id":"CInterface","type":"object"},"required":false,"id":"CInterfaces","type":"array"},"host_groups":{"description":"Watched host groups.","items":{"description":"One CHostGroup object.","required":false,"properties":{"name":{"description":"Host group name.","required":false,"type":"string"},"group_id":{"description":"Host group ID.","required":false,"type":"number"}},"id":"CHostGroup","type":"object"},"required":false,"id":"CHostGroups","type":"array"},"dscps":{"description":"Watched DSCPs.","items":{"description":"One CDSCP object.","required":false,"properties":{"name":{"description":"DSCP name.","required":false,"type":"string"},"code_point":{"description":"DSCP code point.","required":false,"type":"number"}},"id":"CDSCP","type":"object"},"required":false,"id":"CDSCPs","type":"array"},"applications":{"description":"Watched applications.","items":{"description":"One CApplication object.","required":false,"properties":{"code":{"description":"Application code.","required":false,"type":"string"},"name":{"description":"Application name.","required":false,"type":"string"},"tunneled":{"description":"Flag: is the application tunneled.","required":false,"type":"string"}},"id":"CApplication","type":"object"},"required":false,"id":"CApplications","type":"array"}},"id":"TMWidgetCriteria","type":"object"},"title":{"description":"Widget title.","required":true,"type":"string"},"attributes":{"description":"Widget common attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"user_attributes":{"description":"User-specific attributes.","required":false,"properties":{"pan_zoomable":{"description":"Flag making the graph interactive.","required":false,"type":"string"},"line_scale":{"description":"Line scale for a line chart (can be: LINEAR, LOG).","required":false,"type":"string","enum":["LINEAR","LOG"]},"format_bytes":{"description":"What unit to use for formating traffic values (BITS, BYTES, KBITS, KBYTES, MBITS, MBYTES, GBITS, GBYTES, AUTOBITS, AUTOBYTES, UI_PREF).","required":false,"type":"string","enum":["BITS","BYTES","KBITS","KBYTES","MBITS","MBYTES","GBITS","GBYTES","AUTOBITS","AUTOBYTES","UI_PREF"]},"show_images":{"description":"Flag showing images in a connection graph.","required":false,"type":"string"},"open_nodes":{"description":"List of open node IDs for a tree widget.","items":{"description":"ID of an expanded nodes in a tree widget.","required":false,"type":"string"},"required":false,"id":"TMWAOpenNodes","type":"array"},"line_style":{"description":"Line chart style (can be: LINE, STACKED).","required":false,"type":"string","enum":["LINE","STACKED"]},"layout":{"description":"Connection graph layout type (can be: HORIZONTAL_CLISRV, VERTICAL_CLISRV, HORIZONTAL_TREE, VERTICAL_TREE, RADIAL_TREE, SYMMETRIC).","required":false,"type":"string","enum":["HORIZONTAL_CLISRV","VERTICAL_CLISRV","HORIZONTAL_TREE","VERTICAL_TREE","RADIAL_TREE","SYMMETRIC"]},"width":{"description":"Widget width.","required":false,"type":"number"},"height":{"description":"Widget height.","required":false,"type":"number"},"percent_of_total":{"description":"Flag including the 'total' item in a pie chart.","required":false,"type":"string"},"edge_thickness":{"description":"Widget edge thickness.","required":false,"type":"string"},"display_host_group_type":{"description":"Default host grouping type for displaying grouped hosts.","required":false,"type":"string"},"extend_to_zero":{"description":"Flag: extending the Y-axis to zero.","required":false,"type":"string"},"collapsible":{"description":"Flag indicating if the widget is collapsible.","required":false,"type":"string"},"high_threshold":{"description":"High threshold on the chart (in bytes).","required":false,"type":"string"},"n_items":{"description":"Maximum number of items shown.","required":false,"type":"number"},"colspan":{"description":"How many columns the widget occupies in layout.","required":false,"type":"number"},"low_threshold":{"description":"Low threshold on the chart (in bytes).","required":false,"type":"string"},"moveable_nodes":{"description":"Flag allowing the user to reposition nodes in a connection graph.","required":false,"type":"string"},"orientation":{"description":"Bar chart orientation (can be: VERTICAL, HORIZONTAL).","required":false,"type":"string","enum":["VERTICAL","HORIZONTAL"]},"modal_links":{"description":"Flag adding modal links on a widget.","required":false,"type":"number"}},"id":"TMWidgetAttributes","type":"object"},"timestamp":{"description":"Widget time stamp specification.","required":false,"type":"string"}},"id":"TMWidget","type":"object","example":{"title":"VoIP-RTP: Applications","timestamp":"1383141976.674383","criteria":{"sort_column":33,"traffic_expression":"","centricity":"host","limit":100,"columns":[17,33,34,757,766,781,803],"time_frame":{"data_resolution":"15mins","type":"last_hour","refresh_interval":"15mins"}},"attributes":{"format_bytes":"UI_PREF","colspan":2,"n_items":20},"config":{"widget_type":"APPS","visualization":"TABLE","datasource":"TRAFFIC"},"widget_id":1}},"authorization":"required"},"Get report queries":{"description":"Get information for all queries run as part of this report. Each query has a list of columns.","formats":["xml","json"],"httpmethod":"GET","path":"reporting\/reports\/{report_id}\/queries","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of queries. Query is one tabular unit of report data.","items":{"description":"A query.","required":false,"properties":{"metric":{"description":"Query 'metric'. See 'reporting\/metrics'.","required":true,"type":"string"},"actual_log":{"description":"Type of data log file that was used to get data for the query.","required":true,"type":"string"},"columns":{"description":"List of columns that consitute the query. See 'reporting\/columns'.","items":{"description":"A column for reporting query.","required":false,"properties":{"metric":{"description":"Column 'metric'. See 'reporting\/metrics'.","required":true,"type":"string"},"cli_srv":{"description":"Text flag indicating if the column is for the clients or servers.","required":true,"type":"string"},"comparison_parameter":{"description":"Parameter for column comparison.","required":true,"type":"string"},"internal":{"description":"Boolean flag indicating if the column is internal to the system.","required":true,"type":"string"},"id":{"description":"System ID for the column. Used in the API.","required":true,"type":"number"},"strid":{"description":"String ID for the column. Not used by the API, but easier for the human user to see.","required":true,"type":"string"},"statistic":{"description":"Column 'statistic'. See 'reporting\/statistics'.","required":true,"type":"string"},"severity":{"description":"Column 'severity'. See 'reporting\/severities.","required":true,"type":"string"},"role":{"description":"Column 'role'. See 'reporting\/roles'.","required":true,"type":"string"},"category":{"description":"Column 'category'. See 'reporting\/categories'.","required":true,"type":"string"},"name":{"description":"Column name. Format used for column names is similar to the format used for column data.","required":true,"type":"string"},"comparison":{"description":"Column 'comparison'. See 'reporting\/comparisons'.","required":true,"type":"string"},"sortable":{"description":"Boolean flag indicating if this data can be sorted on this column when running the template.","required":true,"type":"string"},"type":{"description":"Type of the column data. See 'reporting\/types'.","required":true,"type":"string"},"direction":{"description":"Column 'direction'. See 'reporting\/directions'.","required":true,"type":"string"},"available":{"description":"Boolean flag indicating that the data for the column is available without the need to re-run the template.","required":true,"type":"string"},"context":{"description":"Internal flag used for formatting certain kinds of data.","required":true,"type":"string"},"area":{"description":"Column 'area'. See 'reporting\/area'.","required":true,"type":"string"},"has_others":{"description":"Boolean flag indicating if the column's 'other' row can be computed.","required":true,"type":"string"},"unit":{"description":"Column 'unit'. See 'reporting\/units'.","required":true,"type":"string"},"name_type":{"description":"Type of the column name. See 'reporting\/types'.","required":true,"type":"string"},"rate":{"description":"Column 'rate'. See 'reporting\/rates'.","required":true,"type":"string"}},"id":"Column","type":"object"},"required":true,"id":"Columns","type":"array"},"id":{"description":"ID for the query. Used in the API.","required":true,"type":"string"},"statistic":{"description":"Query 'statistic'. See 'reporting\/statistics'.","required":true,"type":"string"},"role":{"description":"Query 'role'. See 'reporting\/roles.'.","required":true,"type":"string"},"group_by":{"description":"Grouping of data in the query. See 'reporting\/group_bys'.","required":true,"type":"string"},"actual_t0":{"description":"Actual start time for data in the query. This could be different from the requested start time because of time interval snapping and other similar features.","required":true,"type":"number"},"parent_id":{"description":"Query ID of the query that preceeded this query and influenced data selection for it. For example, if one runs a query that returns time-series data for top 10 protocols in the network, the first query that would need to run is the one to pick top 10 protocols. That query would be the parent one to the follow-up query to get time-series data for those selected 10 protocols.","required":true,"type":"string"},"actual_t1":{"description":"Actual end time for the data in the query. See 'actual_t0' for more detail.","required":true,"type":"number"},"type":{"description":"Internal value. Reserved.","required":true,"type":"string"},"sort_col":{"description":"ID of that column that was used to sort the query when it ran.","required":true,"type":"number"},"direction":{"description":"Query 'direction. See 'reporting\/directions'.","required":true,"type":"string"},"sort_desc":{"description":"Boolean flag indicating if the sorting was in the descending order.","required":true,"type":"string"},"area":{"description":"Query 'area'. See 'reporting\/areas'.","required":true,"type":"string"},"unit":{"description":"Query 'unit'. See 'reporting\/units'.","required":true,"type":"string"},"rate":{"description":"Query 'rate'. See 'reporting\/rates.","required":true,"type":"string"}},"id":"Query","type":"object"},"id":"Queries","type":"array","example":[{"direction":"none","actual_log":"flow","actual_t0":1352319840,"sort_desc":true,"area":"none","metric":"none","sort_col":33,"parent_id":"","rate":"none","group_by":"hos","role":"none","columns":[{"strid":"ID_AVG_BYTES","metric":"net_bw","rate":"persec","statistic":"avg","id":33,"unit":"bytes","category":"data","severity":"none","area":"none","internal":false,"role":"none","cli_srv":"none","type":"float","available":true,"direction":"none","comparison":"none","sortable":true,"name":"Avg Bytes\/s","comparison_parameter":"","has_others":false,"context":false,"name_type":"colname_parts"},{"strid":"ID_AVG_BYTES_RTX","metric":"rtx","rate":"persec","statistic":"avg","id":391,"unit":"bytes","category":"data","severity":"none","area":"none","internal":false,"role":"none","cli_srv":"none","type":"float","available":false,"direction":"none","comparison":"none","sortable":true,"name":"Avg Retrans Bytes\/s","comparison_parameter":"","has_others":false,"context":false,"name_type":"colname_parts"}],"statistic":"none","type":"summary","id":"0:sum_hos_non_non_non_non_non_non_non_33_d_0","unit":"none","actual_t1":1352320200}]},"authorization":"required"},"Create report":{"description":"Generate a new report.","formats":["xml","json"],"request":{"description":"ReportInputs object.","properties":{"criteria":{"description":"Criteria neeed to run the report.","required":false,"properties":{"traffic_expression":{"description":"Traffic expression.","required":false,"type":"string"},"time_frame":{"description":"Time frame object.","required":false,"properties":{"resolution":{"description":"Report data resolution. It can be one of: 1min, 15min, hour, 6hour, day, week, month. If not specified a resolution will automatically be selected based on time frame of the report.","required":false,"type":"string"},"end":{"description":"Report end time (unix time).","required":false,"type":"number"},"expression":{"description":"Traffic expression.","required":false,"type":"string"},"start":{"description":"Report start time (unix time).","required":false,"type":"number"}},"id":"ReportTimeFrame","type":"object"},"query":{"description":"Query object.","required":false,"properties":{"columns":{"description":"Query columns. Can be many of GET \/reporting\/columns.","items":{"description":"Query column.","required":false,"type":"number"},"required":false,"id":"ReportQueryFilterColumns","type":"array"},"role":{"description":"Query role. Can be one of \/reporting\/roles.","required":false,"type":"string"},"group_by":{"description":"Query group_by. Can be one of GET \/reporting\/group_bys.","required":false,"type":"string"},"host_group_type":{"description":"Query host group type. Required for \"host group (gro)\" \"host group pairs (gpp)\" and \"host group pairs with ports (gpr)\" queries.","required":false,"type":"string"},"direction":{"description":"Query direction. Can be one of GET \/reporting\/directions.","required":false,"type":"string"},"sort_column":{"description":"Query sort column. Can be one of GET \/reporting\/columns.","required":false,"type":"number"},"area":{"description":"Query area. Can be one of GET \/reporting\/areas.","required":false,"type":"string"},"centricity":{"description":"Query centricity. Can be one of GET \/reporting\/centricities.","required":false,"type":"string"},"realm":{"description":"Query realm. Can be one of GET \/reporting\/realms.","required":true,"type":"string"}},"id":"ReportQueryFilter","type":"object"},"deprecated":{"description":"Map with legacy criteria attributes that will not be supported soon.","required":false,"additionalProperties":{"description":"ReportDeprecatedFilters map value.","required":false,"xmlKeyName":"key","type":"string"},"id":"ReportDeprecatedFilters","type":"object"}},"id":"ReportCriteria","type":"object"},"name":{"description":"Report name.","required":false,"type":"string"},"template_id":{"description":"Template ID. Can be one of GET \/reporting\/templates.","required":true,"type":"number"}},"id":"ReportInputs","type":"object","example":{"criteria":{"traffic_expression":"app WEB","time_frame":{"start":1352314764,"end":1352315064},"query":{"realm":"traffic_summary","sort_column":33,"group_by":"hos","columns":[6,33,34]}},"template_id":184,"name":"Bytes and packets for the top 20 hosts using application WEB"}},"httpmethod":"POST","path":"reporting\/reports","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing report information.","properties":{"run_time":{"description":"Time when the report was run (Unix time).","required":true,"type":"number"},"error_text":{"description":"A report can be completed with an error. Error message may provide more detailed info.","required":false,"type":"string"},"remaining_seconds":{"description":"Number of seconds remaining to run the report. Even if this number is 0, the report may not yet be completed, so check 'status' to make sure what the status is.","required":true,"type":"number"},"saved":{"description":"Boolean flag indicating if the report was saved.","required":true,"type":"string"},"id":{"description":"ID of the report. To be used in the API.","required":true,"type":"number"},"status":{"description":"Status of the report.","required":true,"type":"string","enum":["completed","running","waiting"]},"percent":{"description":"Progress of the report represented by percentage of report completion.","required":true,"type":"number"},"user_id":{"description":"ID of the user who owns the report.","required":true,"type":"number"},"size":{"description":"Size of the report in kilobytes.","required":true,"type":"number"},"name":{"description":"Name of the report. Could be given by a user or automatically generated by the system.","required":false,"type":"string"},"template_id":{"description":"ID of the template that the report is based on.","required":true,"type":"number"}},"id":"ReportInfo","type":"object","example":{"status":"completed","user_id":1,"name":"Host Information Report","percent":100,"id":1001,"remaining_seconds":0,"run_time":1352494550,"saved":true,"template_id":952,"error_text":"","size":140}},"authorization":"required"}}},"Host_Group_Types":{"methods":{"Get host group members":{"description":"Get a list of hosts in a specified host group.","parameters":{"offset":{"required":false,"type":"number","description":"Starting element number."},"sort":{"required":false,"type":"string","description":"Sorting direction: 'asc' or 'desc' (default: 'asc')."},"limit":{"required":false,"type":"number","description":"Number of rows to be returned."}},"formats":["xml","json"],"httpmethod":"GET","path":"host_group_types\/{host_group_type_id}\/groups\/{group_id}\/members","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of host group members.","items":{"description":"Object representing a host group memeber.","required":false,"properties":{"idaddr":{"description":"Host group memeber's IP address.","required":true,"type":"string"}},"id":"HostGroupMember","type":"object"},"id":"HostGroupMembers","type":"array","example":[{"idaddr":"10.99.16.41"},{"idaddr":"10.99.16.43"}]},"authorization":"required"},"Get host group type":{"description":"Get one host grouping type.","formats":["xml","json"],"httpmethod":"GET","path":"host_group_types\/{host_group_type_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing a host group type.","properties":{"favorite":{"description":"If the host group type is favorite.","required":true,"type":"string"},"id":{"description":"Host group type's ID.","required":true,"type":"number"},"description":{"description":"Host group type's description.","required":true,"type":"string"},"name":{"description":"Host group type's name.","required":true,"type":"string"},"type":{"description":"Host group type's type.","required":true,"type":"string","enum":["User-created","System-created"]}},"id":"HostGroupType","type":"object","example":{"favorite":true,"description":"Groups based on the location of their member hosts, such as NY, Dallas, DataCenter1, etc.","type":"User-created","name":"ByLocation","id":102}},"authorization":"required"},"Get host group":{"description":"Get one host group.","formats":["xml","json"],"httpmethod":"GET","path":"host_group_types\/{host_group_type_id}\/groups\/{group_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing a host group.","properties":{"id":{"description":"Host group's ID.","required":true,"type":"number"},"name":{"description":"Host group's name.","required":true,"type":"string"}},"id":"HostGroup","type":"object","example":{"name":"Columbus","id":6}},"authorization":"required"},"Delete host group type":{"description":"Delete one host grouping type.","httpmethod":"DELETE","path":"host_group_types\/{host_group_type_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"List host group types":{"description":"Get a list of host grouping types.","parameters":{"favorite":{"required":false,"type":"string","description":"Show only host grouping types with specific state of the 'favorite' flag."},"offset":{"required":false,"type":"number","description":"Starting element number."},"sortby":{"required":false,"type":"string","description":"Sorting field name."},"sort":{"required":false,"type":"string","description":"Sorting direction: 'asc' or 'desc' (default: 'asc')."},"type":{"required":false,"type":"string","description":"Show only host grouping types of type: 'User-created' or 'System-created'."},"limit":{"required":false,"type":"number","description":"Number of rows to be returned."}},"formats":["xml","json"],"httpmethod":"GET","path":"host_group_types","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of host group types.","items":{"description":"Object representing a host group type.","required":false,"properties":{"favorite":{"description":"If the host group type is favorite.","required":true,"type":"string"},"id":{"description":"Host group type's ID.","required":true,"type":"number"},"description":{"description":"Host group type's description.","required":true,"type":"string"},"name":{"description":"Host group type's name.","required":true,"type":"string"},"type":{"description":"Host group type's type.","required":true,"type":"string","enum":["User-created","System-created"]}},"id":"HostGroupType","type":"object"},"id":"HostGroupTypes","type":"array","example":[{"favorite":true,"description":"Groups based on the function of their member hosts, such as Email, Web, etc. ","type":"User-created","name":"ByFunction","id":100},{"favorite":true,"description":"Groups based on the location of their member hosts, such as NY, Dallas, DataCenter1, etc.","type":"User-created","name":"ByLocation","id":102}]},"authorization":"required"},"List host groups":{"description":"Get a list of host groups for a given host grouping type.","parameters":{"offset":{"required":false,"type":"number","description":"Starting element number."},"sortby":{"required":false,"type":"string","description":"Sorting field name (default: 'name')."},"sort":{"required":false,"type":"string","description":"Sorting direction: 'asc' or 'desc' (default: 'asc')."},"limit":{"required":false,"type":"number","description":"Number of rows to be returned."}},"formats":["xml","json"],"httpmethod":"GET","path":"host_group_types\/{host_group_type_id}\/groups","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of host groups.","items":{"description":"Object representing a host group.","required":false,"properties":{"id":{"description":"Host group's ID.","required":true,"type":"number"},"name":{"description":"Host group's name.","required":true,"type":"string"}},"id":"HostGroup","type":"object"},"id":"HostGroups","type":"array","example":[{"name":"Austin","id":13},{"name":"Columbus","id":6}]},"authorization":"required"},"Get host group type config":{"description":"Get host grouping type configuration.","formats":["xml","json"],"httpmethod":"GET","path":"host_group_types\/{host_group_type_id}\/config","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of host group type definitions.","items":{"description":"Object representing host group type's definition.","required":false,"properties":{"name":{"description":"Host group type definition's name.","required":true,"type":"string"},"cidr":{"description":"Host group type defiintion's CIDRs.","required":true,"type":"string"}},"id":"HostGroupTypeDef","type":"object"},"id":"HostGroupTypeDefs","type":"array","example":[{"cidr":"10.99.11.0\/255.255.255.0","name":"Seattle"},{"cidr":"10.99.12.0\/255.255.255.0","name":"LosAngeles"}]},"authorization":"required"},"Create host group type":{"description":"Create a new host grouping type.","formats":["xml","json"],"request":{"description":"Object representing a new host group type.","properties":{"favorite":{"description":"If new host group type is favorite.","required":true,"type":"string"},"config":{"description":"Optional configuration of the grouptype.","items":{"description":"Object representing host group type's definition.","required":false,"properties":{"name":{"description":"Host group type definition's name.","required":true,"type":"string"},"cidr":{"description":"Host group type defiintion's CIDRs.","required":true,"type":"string"}},"id":"HostGroupTypeDef","type":"object"},"required":false,"id":"HostGroupTypeDefs","type":"array"},"description":{"description":"New host group type's description.","required":true,"type":"string"},"name":{"description":"New host group type's name.","required":true,"type":"string"}},"id":"HostGroupTypeUp","type":"object","example":{"favorite":true,"name":"ByLocation","description":"Groups based on the location of their member hosts, such as NY, Dallas, DataCenter1, etc."}},"httpmethod":"POST","path":"host_group_types","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing a new host group type.","properties":{"favorite":{"description":"If new host group type is favorite.","required":true,"type":"string"},"config":{"description":"Optional configuration of the grouptype.","items":{"description":"Object representing host group type's definition.","required":false,"properties":{"name":{"description":"Host group type definition's name.","required":true,"type":"string"},"cidr":{"description":"Host group type defiintion's CIDRs.","required":true,"type":"string"}},"id":"HostGroupTypeDef","type":"object"},"required":false,"id":"HostGroupTypeDefs","type":"array"},"description":{"description":"New host group type's description.","required":true,"type":"string"},"name":{"description":"New host group type's name.","required":true,"type":"string"}},"id":"HostGroupTypeUp","type":"object","example":{"favorite":true,"name":"ByLocation","description":"Groups based on the location of their member hosts, such as NY, Dallas, DataCenter1, etc."}},"authorization":"required"},"Set host group type config":{"description":"Update host grouping type configuration.","request":{"description":"List of host group type definitions.","items":{"description":"Object representing host group type's definition.","required":false,"properties":{"name":{"description":"Host group type definition's name.","required":true,"type":"string"},"cidr":{"description":"Host group type defiintion's CIDRs.","required":true,"type":"string"}},"id":"HostGroupTypeDef","type":"object"},"id":"HostGroupTypeDefs","type":"array","example":[{"cidr":"10.99.11.0\/255.255.255.0","name":"Seattle"},{"cidr":"10.99.12.0\/255.255.255.0","name":"LosAngeles"}]},"httpmethod":"PUT","path":"host_group_types\/{host_group_type_id}\/config","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Update host group type":{"description":"Update one host grouping type.","request":{"description":"Object representing a new host group type.","properties":{"favorite":{"description":"If new host group type is favorite.","required":true,"type":"string"},"config":{"description":"Optional configuration of the grouptype.","items":{"description":"Object representing host group type's definition.","required":false,"properties":{"name":{"description":"Host group type definition's name.","required":true,"type":"string"},"cidr":{"description":"Host group type defiintion's CIDRs.","required":true,"type":"string"}},"id":"HostGroupTypeDef","type":"object"},"required":false,"id":"HostGroupTypeDefs","type":"array"},"description":{"description":"New host group type's description.","required":true,"type":"string"},"name":{"description":"New host group type's name.","required":true,"type":"string"}},"id":"HostGroupTypeUp","type":"object","example":{"favorite":true,"name":"ByLocation","description":"Groups based on the location of their member hosts, such as NY, Dallas, DataCenter1, etc."}},"httpmethod":"PUT","path":"host_group_types\/{host_group_type_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"}}},"Applications":{"methods":{"Get application":{"description":"Get configuration of a specific application.","formats":["xml","json"],"httpmethod":"GET","path":"applications\/{application_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing an application.","properties":{"enabled":{"description":"if the application enabled.","required":true,"type":"string"},"id":{"description":"Application's ID.","required":true,"type":"number"},"name":{"description":"Application's name.","required":true,"type":"string"},"type":{"description":"Application's type.","required":true,"type":"string","enum":["Layer_7","Layer_4"]},"priority":{"description":"Application's priority.","required":true,"type":"number"},"sources":{"description":"Application's sources.","items":{"description":"Object representing an application source ID.","required":false,"properties":{"id":{"description":"ID of application source's ID.","required":true,"type":"number"}},"id":"ApplicationSourceId","type":"object"},"required":true,"id":"ApplicationSourceIds","type":"array"}},"id":"Application","type":"object","example":{"name":"LDAP","enabled":true,"priority":4,"sources":[{"id":1},{"id":0},{"id":2},{"id":100}],"type":"Layer_7","id":4}},"authorization":"required"},"Get application sources":{"description":"List all application sources.","parameters":{"offset":{"required":false,"type":"number","description":"Starting element number."},"limit":{"required":false,"type":"number","description":"Number of rows to be returned."}},"formats":["xml","json"],"httpmethod":"GET","path":"applications\/sources","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of application sources.","items":{"description":"Object representing an application sources.","required":false,"properties":{"id":{"description":"Application source's ID.","required":true,"type":"number"},"name":{"description":"Application source's name.","required":true,"type":"string"}},"id":"ApplicationSource","type":"object"},"id":"ApplicationSources","type":"array","example":[{"name":"Sensor","id":100},{"name":"Shark","id":3},{"name":"Steelhead","id":2}]},"authorization":"required"},"List layer 4 applications":{"description":"Get a list of all supported Layer 4 applications.","parameters":{"enabled":{"required":false,"type":"string","description":"Show only enabled or disabled application (use 'true' or 'false')."},"offset":{"required":false,"type":"number","description":"Starting element number."},"sortby":{"required":false,"type":"string","description":"Sorting field name."},"sort":{"required":false,"type":"string","description":"Sorting direction: 'asc' or 'desc' (default: 'asc')."},"override":{"required":false,"type":"string","description":"Filter applications by the 'override' class."},"priority":{"required":false,"type":"number","description":"Filter applications by a priority."},"limit":{"required":false,"type":"number","description":"Number of rows to be returned."}},"formats":["xml","json"],"httpmethod":"GET","path":"applications\/layer_4","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of all mapped applications.","items":{"description":"Object representing a mapped application.","required":false,"properties":{"enabled":{"description":"If the mapped application is enabled.","required":true,"type":"string"},"config":{"description":"Object representing mapped application's configuration.","required":true,"properties":{"port_groups":{"description":"Object representing mapped application's port_groups.","items":{"description":"Object representing one mapped application's port group.","required":false,"properties":{"name":{"description":"Mapped application's port group name.","required":false,"type":"string"},"group_id":{"description":"Mapped application's port group ID.","required":true,"type":"number"}},"id":"ApplicationPortGroup","type":"object"},"required":false,"id":"ApplicationPortGroups","type":"array"},"proto_ports":{"description":"Object representing mapped application's proto_ports.","items":{"description":"Object representing one mapped application's proto port.","required":false,"properties":{"port":{"description":"Mapped application's port.","required":false,"type":"number"},"protocol":{"description":"Mapped application's protocol.","required":true,"type":"number"},"name":{"description":"Mapped application's proto port name.","required":false,"type":"string"}},"id":"ApplicationProtoPort","type":"object"},"required":false,"id":"ApplicationProtoPorts","type":"array"},"hosts":{"description":"Object representing mapped application's hosts.","items":{"description":"Mapped application's host.","required":false,"type":"string"},"required":false,"id":"ApplicationHosts","type":"array"},"cidrs":{"description":"Object representing mapped application's CIDRs.","items":{"description":"Mapped application's CIDR.","required":false,"type":"string"},"required":false,"id":"ApplicationCidrs","type":"array"},"host_groups":{"description":"Object representing mapped application's host_groups.","items":{"description":"Object representing one mapped application's host group.","required":false,"properties":{"host_group":{"description":"Mapped application's host group.","required":true,"type":"number"},"name":{"description":"Mapped application's host group's name.","required":false,"type":"string"},"host_group_type":{"description":"Mapped application's host group type.","required":true,"type":"number"}},"id":"ApplicationHostGroup","type":"object"},"required":false,"id":"ApplicationHostGroups","type":"array"}},"id":"ApplicationLayer4Config","type":"object"},"id":{"description":"Mapped application's ID.","required":false,"type":"number"},"name":{"description":"Mapped application's name.","required":true,"type":"string"},"override":{"description":"Mapped application's override.","required":true,"type":"string","enum":["Always","Unclassified","Unknown"]},"app_id":{"description":"Application ID.","required":false,"type":"number"},"priority":{"description":"Mapped application's priority.","required":false,"type":"number"}},"id":"ApplicationLayer4","type":"object"},"id":"ApplicationsLayer4","type":"array","example":[{"name":"CIFS","enabled":true,"app_id":144,"priority":1,"override":"Unknown","config":{"cidrs":["0.0.0.0\/0"],"proto_ports":[{"protocol":6,"name":"tcp\/139(netbios-ssn)","port":139},{"protocol":6,"name":"tcp\/445(microsoft-ds)","port":445}]},"id":1},{"name":"FTP","enabled":true,"app_id":2,"priority":2,"override":"Always","config":{"cidrs":["0.0.0.0\/0"],"proto_ports":[{"protocol":6,"name":"tcp\/20(ftp-data)","port":20},{"protocol":6,"name":"tcp\/21(ftp)","port":21}]},"id":2}]},"authorization":"required"},"List applications":{"description":"Get a list of all supported Layer 4 and Layer 7 applications.","parameters":{"enabled":{"required":false,"type":"string","description":"Show only enabled or disabled applications (use 'true' or 'false')."},"offset":{"required":false,"type":"number","description":"Starting element number."},"sortby":{"required":false,"type":"string","description":"Sorting field name (default: 'name')."},"sort":{"required":false,"type":"string","description":"Sorting direction: 'asc' or 'desc' (default: 'asc')."},"type":{"required":false,"type":"string","description":"Filter applications by application type ('Layer_4' or 'Layer_7')."},"sources":{"required":false,"type":"string","description":"Filter the applications by source ID."},"limit":{"required":false,"type":"number","description":"Number of rows to be returned."}},"formats":["xml","json"],"httpmethod":"GET","path":"applications","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of applications.","items":{"description":"Object representing an application.","required":false,"properties":{"enabled":{"description":"if the application enabled.","required":true,"type":"string"},"id":{"description":"Application's ID.","required":true,"type":"number"},"name":{"description":"Application's name.","required":true,"type":"string"},"type":{"description":"Application's type.","required":true,"type":"string","enum":["Layer_7","Layer_4"]},"priority":{"description":"Application's priority.","required":true,"type":"number"},"sources":{"description":"Application's sources.","items":{"description":"Object representing an application source ID.","required":false,"properties":{"id":{"description":"ID of application source's ID.","required":true,"type":"number"}},"id":"ApplicationSourceId","type":"object"},"required":true,"id":"ApplicationSourceIds","type":"array"}},"id":"Application","type":"object"},"id":"Applications","type":"array","example":[{"name":"PCMA","enabled":true,"priority":399,"sources":[{"id":100}],"type":"Layer_7","id":399},{"name":"LDAP","enabled":true,"priority":4,"sources":[{"id":1},{"id":0},{"id":2},{"id":100}],"type":"Layer_7","id":4}]},"authorization":"required"},"Get layer 4 application":{"description":"Get information for a Layer 4 application.","formats":["xml","json"],"httpmethod":"GET","path":"applications\/layer_4\/{layer4_app_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing a mapped application.","properties":{"enabled":{"description":"If the mapped application is enabled.","required":true,"type":"string"},"config":{"description":"Object representing mapped application's configuration.","required":true,"properties":{"port_groups":{"description":"Object representing mapped application's port_groups.","items":{"description":"Object representing one mapped application's port group.","required":false,"properties":{"name":{"description":"Mapped application's port group name.","required":false,"type":"string"},"group_id":{"description":"Mapped application's port group ID.","required":true,"type":"number"}},"id":"ApplicationPortGroup","type":"object"},"required":false,"id":"ApplicationPortGroups","type":"array"},"proto_ports":{"description":"Object representing mapped application's proto_ports.","items":{"description":"Object representing one mapped application's proto port.","required":false,"properties":{"port":{"description":"Mapped application's port.","required":false,"type":"number"},"protocol":{"description":"Mapped application's protocol.","required":true,"type":"number"},"name":{"description":"Mapped application's proto port name.","required":false,"type":"string"}},"id":"ApplicationProtoPort","type":"object"},"required":false,"id":"ApplicationProtoPorts","type":"array"},"hosts":{"description":"Object representing mapped application's hosts.","items":{"description":"Mapped application's host.","required":false,"type":"string"},"required":false,"id":"ApplicationHosts","type":"array"},"cidrs":{"description":"Object representing mapped application's CIDRs.","items":{"description":"Mapped application's CIDR.","required":false,"type":"string"},"required":false,"id":"ApplicationCidrs","type":"array"},"host_groups":{"description":"Object representing mapped application's host_groups.","items":{"description":"Object representing one mapped application's host group.","required":false,"properties":{"host_group":{"description":"Mapped application's host group.","required":true,"type":"number"},"name":{"description":"Mapped application's host group's name.","required":false,"type":"string"},"host_group_type":{"description":"Mapped application's host group type.","required":true,"type":"number"}},"id":"ApplicationHostGroup","type":"object"},"required":false,"id":"ApplicationHostGroups","type":"array"}},"id":"ApplicationLayer4Config","type":"object"},"id":{"description":"Mapped application's ID.","required":false,"type":"number"},"name":{"description":"Mapped application's name.","required":true,"type":"string"},"override":{"description":"Mapped application's override.","required":true,"type":"string","enum":["Always","Unclassified","Unknown"]},"app_id":{"description":"Application ID.","required":false,"type":"number"},"priority":{"description":"Mapped application's priority.","required":false,"type":"number"}},"id":"ApplicationLayer4","type":"object","example":{"name":"CIFS","enabled":true,"app_id":144,"priority":1,"override":"Unknown","config":{"cidrs":["0.0.0.0\/0"],"proto_ports":[{"protocol":6,"name":"tcp\/139(netbios-ssn)","port":139},{"protocol":6,"name":"tcp\/445(microsoft-ds)","port":445}]},"id":1}},"authorization":"required"},"Get layer 7 application":{"description":"Get Layer 7 application information.","formats":["xml","json"],"httpmethod":"GET","path":"applications\/layer_7\/{layer7_app_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing an unmapped application.","properties":{"enabled":{"description":"If the unmapped application is enabled.","required":true,"type":"string"},"signatures":{"description":"Unmapped application's hosts.","items":{"description":"Object represeting an application host.","required":false,"properties":{"type":{"description":"Unmapped application's type.","required":true,"type":"string","enum":["Builtin","URL","String","Hex_String"]},"signature":{"description":"Unmapped application's signature.","required":true,"type":"string"}},"id":"ApplicationSignature","type":"object"},"required":true,"id":"ApplicationSignatures","type":"array"},"id":{"description":"Unmapped application's ID.","required":false,"type":"number"},"name":{"description":"Unmapped application's name.","required":true,"type":"string"},"sources":{"description":"Unmapped application's override.","items":{"description":"Object representing an application source ID.","required":false,"properties":{"id":{"description":"ID of application source's ID.","required":true,"type":"number"}},"id":"ApplicationSourceId","type":"object"},"required":false,"id":"ApplicationSourceIds","type":"array"}},"id":"ApplicationLayer7","type":"object","example":{"sources":[{"id":0},{"id":3},{"id":2},{"id":100}],"signatures":[{"type":"Builtin","signature":"^\"GET daap:\/\"(.|\\x0a)\"iTunes\/\"[0-9]\".\"[0-9]\".\"[0-9]"},{"type":"Builtin","signature":"\"DAAP-Server: iTunes\/\"[0-9]\".\"[0-9]\".\"[0-9]"}],"enabled":true,"name":"iTunes","id":33}},"authorization":"required"},"Create layer 7 application":{"description":"Create a new Layer 7 application.","formats":["xml","json"],"request":{"description":"Object representing an unmapped application.","properties":{"enabled":{"description":"If the unmapped application is enabled.","required":true,"type":"string"},"signatures":{"description":"Unmapped application's hosts.","items":{"description":"Object represeting an application host.","required":false,"properties":{"type":{"description":"Unmapped application's type.","required":true,"type":"string","enum":["Builtin","URL","String","Hex_String"]},"signature":{"description":"Unmapped application's signature.","required":true,"type":"string"}},"id":"ApplicationSignature","type":"object"},"required":true,"id":"ApplicationSignatures","type":"array"},"id":{"description":"Unmapped application's ID.","required":false,"type":"number"},"name":{"description":"Unmapped application's name.","required":true,"type":"string"},"sources":{"description":"Unmapped application's override.","items":{"description":"Object representing an application source ID.","required":false,"properties":{"id":{"description":"ID of application source's ID.","required":true,"type":"number"}},"id":"ApplicationSourceId","type":"object"},"required":false,"id":"ApplicationSourceIds","type":"array"}},"id":"ApplicationLayer7","type":"object","example":{"sources":[{"id":0},{"id":3},{"id":2},{"id":100}],"signatures":[{"type":"Builtin","signature":"^\"GET daap:\/\"(.|\\x0a)\"iTunes\/\"[0-9]\".\"[0-9]\".\"[0-9]"},{"type":"Builtin","signature":"\"DAAP-Server: iTunes\/\"[0-9]\".\"[0-9]\".\"[0-9]"}],"enabled":true,"name":"iTunes","id":33}},"httpmethod":"POST","path":"applications\/layer_7","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing an unmapped application.","properties":{"enabled":{"description":"If the unmapped application is enabled.","required":true,"type":"string"},"signatures":{"description":"Unmapped application's hosts.","items":{"description":"Object represeting an application host.","required":false,"properties":{"type":{"description":"Unmapped application's type.","required":true,"type":"string","enum":["Builtin","URL","String","Hex_String"]},"signature":{"description":"Unmapped application's signature.","required":true,"type":"string"}},"id":"ApplicationSignature","type":"object"},"required":true,"id":"ApplicationSignatures","type":"array"},"id":{"description":"Unmapped application's ID.","required":false,"type":"number"},"name":{"description":"Unmapped application's name.","required":true,"type":"string"},"sources":{"description":"Unmapped application's override.","items":{"description":"Object representing an application source ID.","required":false,"properties":{"id":{"description":"ID of application source's ID.","required":true,"type":"number"}},"id":"ApplicationSourceId","type":"object"},"required":false,"id":"ApplicationSourceIds","type":"array"}},"id":"ApplicationLayer7","type":"object","example":{"sources":[{"id":0},{"id":3},{"id":2},{"id":100}],"signatures":[{"type":"Builtin","signature":"^\"GET daap:\/\"(.|\\x0a)\"iTunes\/\"[0-9]\".\"[0-9]\".\"[0-9]"},{"type":"Builtin","signature":"\"DAAP-Server: iTunes\/\"[0-9]\".\"[0-9]\".\"[0-9]"}],"enabled":true,"name":"iTunes","id":33}},"authorization":"required"},"List layer 7 applications":{"description":"Get a list of all supported Layer 7 applications.","parameters":{"enabled":{"required":false,"type":"string","description":"Show only enabled or disabled application (use 'true' or 'false')."},"offset":{"required":false,"type":"number","description":"Starting element number."},"sortby":{"required":false,"type":"string","description":"Sorting field name."},"sort":{"required":false,"type":"string","description":"Sorting direction: 'asc' or 'desc' (default: 'asc')."},"sources":{"required":false,"type":"string","description":"Filter Layer 7 applications to those from specific sources."},"limit":{"required":false,"type":"number","description":"Number of rows to be returned."}},"formats":["xml","json"],"httpmethod":"GET","path":"applications\/layer_7","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of all unmapped applications.","items":{"description":"Object representing an unmapped application.","required":false,"properties":{"enabled":{"description":"If the unmapped application is enabled.","required":true,"type":"string"},"signatures":{"description":"Unmapped application's hosts.","items":{"description":"Object represeting an application host.","required":false,"properties":{"type":{"description":"Unmapped application's type.","required":true,"type":"string","enum":["Builtin","URL","String","Hex_String"]},"signature":{"description":"Unmapped application's signature.","required":true,"type":"string"}},"id":"ApplicationSignature","type":"object"},"required":true,"id":"ApplicationSignatures","type":"array"},"id":{"description":"Unmapped application's ID.","required":false,"type":"number"},"name":{"description":"Unmapped application's name.","required":true,"type":"string"},"sources":{"description":"Unmapped application's override.","items":{"description":"Object representing an application source ID.","required":false,"properties":{"id":{"description":"ID of application source's ID.","required":true,"type":"number"}},"id":"ApplicationSourceId","type":"object"},"required":false,"id":"ApplicationSourceIds","type":"array"}},"id":"ApplicationLayer7","type":"object"},"id":"ApplicationsLayer7","type":"array","example":[{"sources":[{"id":0},{"id":3},{"id":2},{"id":100}],"signatures":[{"type":"Builtin","signature":"^\"GET daap:\/\"(.|\\x0a)\"iTunes\/\"[0-9]\".\"[0-9]\".\"[0-9]"},{"type":"Builtin","signature":"\"DAAP-Server: iTunes\/\"[0-9]\".\"[0-9]\".\"[0-9]"}],"enabled":true,"name":"iTunes","id":33},{"sources":[{"id":100}],"signatures":[],"enabled":true,"name":"PCMA","id":399}]},"authorization":"required"},"Create layer 4 application":{"description":"Create a new Layer 4 application.","formats":["xml","json"],"request":{"description":"Object representing a mapped application.","properties":{"enabled":{"description":"If the mapped application is enabled.","required":true,"type":"string"},"config":{"description":"Object representing mapped application's configuration.","required":true,"properties":{"port_groups":{"description":"Object representing mapped application's port_groups.","items":{"description":"Object representing one mapped application's port group.","required":false,"properties":{"name":{"description":"Mapped application's port group name.","required":false,"type":"string"},"group_id":{"description":"Mapped application's port group ID.","required":true,"type":"number"}},"id":"ApplicationPortGroup","type":"object"},"required":false,"id":"ApplicationPortGroups","type":"array"},"proto_ports":{"description":"Object representing mapped application's proto_ports.","items":{"description":"Object representing one mapped application's proto port.","required":false,"properties":{"port":{"description":"Mapped application's port.","required":false,"type":"number"},"protocol":{"description":"Mapped application's protocol.","required":true,"type":"number"},"name":{"description":"Mapped application's proto port name.","required":false,"type":"string"}},"id":"ApplicationProtoPort","type":"object"},"required":false,"id":"ApplicationProtoPorts","type":"array"},"hosts":{"description":"Object representing mapped application's hosts.","items":{"description":"Mapped application's host.","required":false,"type":"string"},"required":false,"id":"ApplicationHosts","type":"array"},"cidrs":{"description":"Object representing mapped application's CIDRs.","items":{"description":"Mapped application's CIDR.","required":false,"type":"string"},"required":false,"id":"ApplicationCidrs","type":"array"},"host_groups":{"description":"Object representing mapped application's host_groups.","items":{"description":"Object representing one mapped application's host group.","required":false,"properties":{"host_group":{"description":"Mapped application's host group.","required":true,"type":"number"},"name":{"description":"Mapped application's host group's name.","required":false,"type":"string"},"host_group_type":{"description":"Mapped application's host group type.","required":true,"type":"number"}},"id":"ApplicationHostGroup","type":"object"},"required":false,"id":"ApplicationHostGroups","type":"array"}},"id":"ApplicationLayer4Config","type":"object"},"id":{"description":"Mapped application's ID.","required":false,"type":"number"},"name":{"description":"Mapped application's name.","required":true,"type":"string"},"override":{"description":"Mapped application's override.","required":true,"type":"string","enum":["Always","Unclassified","Unknown"]},"app_id":{"description":"Application ID.","required":false,"type":"number"},"priority":{"description":"Mapped application's priority.","required":false,"type":"number"}},"id":"ApplicationLayer4","type":"object","example":{"name":"CIFS","enabled":true,"app_id":144,"priority":1,"override":"Unknown","config":{"cidrs":["0.0.0.0\/0"],"proto_ports":[{"protocol":6,"name":"tcp\/139(netbios-ssn)","port":139},{"protocol":6,"name":"tcp\/445(microsoft-ds)","port":445}]},"id":1}},"httpmethod":"POST","path":"applications\/layer_4","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"Object representing a mapped application.","properties":{"enabled":{"description":"If the mapped application is enabled.","required":true,"type":"string"},"config":{"description":"Object representing mapped application's configuration.","required":true,"properties":{"port_groups":{"description":"Object representing mapped application's port_groups.","items":{"description":"Object representing one mapped application's port group.","required":false,"properties":{"name":{"description":"Mapped application's port group name.","required":false,"type":"string"},"group_id":{"description":"Mapped application's port group ID.","required":true,"type":"number"}},"id":"ApplicationPortGroup","type":"object"},"required":false,"id":"ApplicationPortGroups","type":"array"},"proto_ports":{"description":"Object representing mapped application's proto_ports.","items":{"description":"Object representing one mapped application's proto port.","required":false,"properties":{"port":{"description":"Mapped application's port.","required":false,"type":"number"},"protocol":{"description":"Mapped application's protocol.","required":true,"type":"number"},"name":{"description":"Mapped application's proto port name.","required":false,"type":"string"}},"id":"ApplicationProtoPort","type":"object"},"required":false,"id":"ApplicationProtoPorts","type":"array"},"hosts":{"description":"Object representing mapped application's hosts.","items":{"description":"Mapped application's host.","required":false,"type":"string"},"required":false,"id":"ApplicationHosts","type":"array"},"cidrs":{"description":"Object representing mapped application's CIDRs.","items":{"description":"Mapped application's CIDR.","required":false,"type":"string"},"required":false,"id":"ApplicationCidrs","type":"array"},"host_groups":{"description":"Object representing mapped application's host_groups.","items":{"description":"Object representing one mapped application's host group.","required":false,"properties":{"host_group":{"description":"Mapped application's host group.","required":true,"type":"number"},"name":{"description":"Mapped application's host group's name.","required":false,"type":"string"},"host_group_type":{"description":"Mapped application's host group type.","required":true,"type":"number"}},"id":"ApplicationHostGroup","type":"object"},"required":false,"id":"ApplicationHostGroups","type":"array"}},"id":"ApplicationLayer4Config","type":"object"},"id":{"description":"Mapped application's ID.","required":false,"type":"number"},"name":{"description":"Mapped application's name.","required":true,"type":"string"},"override":{"description":"Mapped application's override.","required":true,"type":"string","enum":["Always","Unclassified","Unknown"]},"app_id":{"description":"Application ID.","required":false,"type":"number"},"priority":{"description":"Mapped application's priority.","required":false,"type":"number"}},"id":"ApplicationLayer4","type":"object","example":{"name":"CIFS","enabled":true,"app_id":144,"priority":1,"override":"Unknown","config":{"cidrs":["0.0.0.0\/0"],"proto_ports":[{"protocol":6,"name":"tcp\/139(netbios-ssn)","port":139},{"protocol":6,"name":"tcp\/445(microsoft-ds)","port":445}]},"id":1}},"authorization":"required"},"Delete Layer 4 application":{"description":"Delete Layer 4 application.","httpmethod":"DELETE","path":"applications\/layer_7\/{layer7_app_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Update Layer 4 application":{"description":"Update Layer 4 application.","request":{"description":"Object representing an unmapped application.","properties":{"enabled":{"description":"If the unmapped application is enabled.","required":true,"type":"string"},"signatures":{"description":"Unmapped application's hosts.","items":{"description":"Object represeting an application host.","required":false,"properties":{"type":{"description":"Unmapped application's type.","required":true,"type":"string","enum":["Builtin","URL","String","Hex_String"]},"signature":{"description":"Unmapped application's signature.","required":true,"type":"string"}},"id":"ApplicationSignature","type":"object"},"required":true,"id":"ApplicationSignatures","type":"array"},"id":{"description":"Unmapped application's ID.","required":false,"type":"number"},"name":{"description":"Unmapped application's name.","required":true,"type":"string"},"sources":{"description":"Unmapped application's override.","items":{"description":"Object representing an application source ID.","required":false,"properties":{"id":{"description":"ID of application source's ID.","required":true,"type":"number"}},"id":"ApplicationSourceId","type":"object"},"required":false,"id":"ApplicationSourceIds","type":"array"}},"id":"ApplicationLayer7","type":"object","example":{"sources":[{"id":0},{"id":3},{"id":2},{"id":100}],"signatures":[{"type":"Builtin","signature":"^\"GET daap:\/\"(.|\\x0a)\"iTunes\/\"[0-9]\".\"[0-9]\".\"[0-9]"},{"type":"Builtin","signature":"\"DAAP-Server: iTunes\/\"[0-9]\".\"[0-9]\".\"[0-9]"}],"enabled":true,"name":"iTunes","id":33}},"httpmethod":"PUT","path":"applications\/layer_7\/{layer7_app_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"}}},"Port_Names":{"methods":{"Update port names":{"description":"Update system port names.","request":{"description":"List of port name definitions.","items":{"description":"Object representing port name definitions.","required":false,"properties":{"port":{"description":"Port name's port.","required":true,"type":"number"},"protocol":{"description":"Port name's protocol.","required":true,"type":"number"},"name":{"description":"Port name's name.","required":true,"type":"string"}},"id":"CPortNameDef","type":"object"},"id":"CPortNameDefs","type":"array","example":[{"protocol":6,"name":"smtp","port":25},{"protocol":6,"name":"nsw-fe","port":27}]},"httpmethod":"PUT","path":"port_names","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"List port names":{"description":"Get the system port names.","parameters":{"offset":{"required":false,"type":"number","description":"Starting element number."},"name":{"required":false,"type":"string","description":"Filter port names by the name specified."},"limit":{"required":false,"type":"number","description":"Number of rows to be returned."}},"formats":["xml","json"],"httpmethod":"GET","path":"port_names","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of PortNames objects.","items":{"description":"Object representing port name information.","required":false,"properties":{"port":{"description":"Port name's port.","required":true,"type":"number"},"server_port":{"description":"Defined as server port.","required":true,"type":"string"},"protocol":{"description":"Port name's protocol.","required":true,"type":"number"},"avg_bytes_ps":{"description":"Speed information of port name.","required":true,"type":"number"},"name":{"description":"Port name's name.","required":true,"type":"string"},"grouped":{"description":"Used in port groups.","required":true,"type":"string"}},"id":"CPortName","type":"object"},"id":"CPortNames","type":"array","example":[{"protocol":6,"name":"smtp","grouped":false,"server_port":true,"avg_bytes_ps":32767,"port":25},{"protocol":6,"name":"nsw-fe","grouped":false,"server_port":false,"avg_bytes_ps":32767,"port":27}]},"authorization":"required"}}},"System":{"methods":{"Start all processes (one module)":{"description":"Start all system processes on one module on Enterprise systems. The operation is asynchronous. Use \"GET system\/{module}\/status\" to poll for status. The {module} can be either the IP Address or the module name.","httpmethod":"POST","path":"system\/{module}\/start","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Get status of all processes":{"description":"Get status of all system processes. On Enterprise systems, get system process statuses on all modules.","formats":["xml","json"],"httpmethod":"GET","path":"system\/status","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"SystemStatus object.","items":{"description":"SystemProcess object.","required":false,"properties":{"process_id":{"description":"Process ID.","required":false,"type":"string"},"process_name":{"description":"Process name.","required":true,"type":"string"},"module_name":{"description":"Module name. Available on Enterprise systems only.","required":false,"type":"string"},"status":{"description":"Process status.","required":true,"type":"string","enum":["Running","Stopped"]},"module_ipaddr":{"description":"Module IP address. Available on Enterprise systems only.","required":false,"type":"string"}},"id":"SystemProcess","type":"object"},"id":"SystemStatus","type":"array","example":[{"process_id":"25096","process_name":"memmonitor","status":"Running"},{"process_name":"healthd","status":"Stopped"},{"process_id":"25092","process_name":"diskmon","status":"Running"},{"process_id":"25123","process_name":"dispatcher","status":"Running"},{"process_name":"analyzer","status":"Stopped"}]},"authorization":"required"},"Kill all processes":{"description":"Kill all system processes. The operation is asynchronous. Use \"GET system\/status\" to poll for status. On Enterprise systems, kill system processes on all modules. Warning: this operation can result in data being corrupted.","httpmethod":"POST","path":"system\/kill","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Restart all processes":{"description":"Restart all system processes. The operation is asynchronous. Use \"GET system\/status\" to poll for status. On Enterprise systems, stop system processes on all modules.","httpmethod":"POST","path":"system\/restart","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Start all processes":{"description":"Start all system processes. The operation is asynchronous. Use \"GET system\/status\" to poll for status. On Enterprise systems, start system processes on all modules.","httpmethod":"POST","path":"system\/start","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Restart all processes (one module)":{"description":"Restart all system processes on one module on Enterprise systems. The operation is asynchronous. Use \"GET system\/{module}\/status\" to poll for status. The {module} can be either the IP Address or the module name.","httpmethod":"POST","path":"system\/{module}\/restart","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Stop all processes (one module)":{"description":"Stop all system processes on one module on Enterprise systems. The operation is asynchronous. Use \"GET system\/{module}\/status\" to poll for status. The {module} can be either the IP Address or the module name.","httpmethod":"POST","path":"system\/{module}\/stop","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Get status of all processes (one module)":{"description":"Get status of all system processes on one module on Enterprise systems. The {module} can be either the IP Address or the module name.","formats":["xml","json"],"httpmethod":"GET","path":"system\/{module}\/status","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"SystemStatus object.","items":{"description":"SystemProcess object.","required":false,"properties":{"process_id":{"description":"Process ID.","required":false,"type":"string"},"process_name":{"description":"Process name.","required":true,"type":"string"},"module_name":{"description":"Module name. Available on Enterprise systems only.","required":false,"type":"string"},"status":{"description":"Process status.","required":true,"type":"string","enum":["Running","Stopped"]},"module_ipaddr":{"description":"Module IP address. Available on Enterprise systems only.","required":false,"type":"string"}},"id":"SystemProcess","type":"object"},"id":"SystemStatus","type":"array","example":[{"process_id":"25096","process_name":"memmonitor","status":"Running"},{"process_name":"healthd","status":"Stopped"},{"process_id":"25092","process_name":"diskmon","status":"Running"},{"process_id":"25123","process_name":"dispatcher","status":"Running"},{"process_name":"analyzer","status":"Stopped"}]},"authorization":"required"},"Shutdown":{"description":"Shutdown the system. The operation is asynchronous.","httpmethod":"POST","path":"system\/shutdown","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Reboot":{"description":"Reboot the system. The operation is asynchronous.","httpmethod":"POST","path":"system\/reboot","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Stop all processes":{"description":"Stop all system processes. The operation is asynchronous. Use \"GET system\/status\" to poll for status. On Enterprise systems, stop system processes on all modules.","httpmethod":"POST","path":"system\/stop","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Kill all processes (one module)":{"description":"Kill all system processes on one module on Enterprise systems. The operation is asynchronous. Use \"GET system\/{module}\/status\" to poll for status. The {module} can be either the IP Address or the module name. Warning: this operation can result in data being corrupted.","httpmethod":"POST","path":"system\/{module}\/kill","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"}}},"Users":{"methods":{"List users":{"description":"Get a list of user accounts.","formats":["xml","json"],"httpmethod":"GET","path":"users","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"List of user accounts on the system.","items":{"description":"User account.","required":false,"properties":{"enabled":{"description":"Boolean flag indicating if the user account is enabled.","required":true,"type":"string"},"last_name":{"description":"Last name of the user.","required":true,"type":"string"},"id":{"description":"Numeric ID of the user that the system uses internally and in the API.","required":true,"type":"number"},"last_login":{"description":"Time of last login. Unix time (epoch).","required":true,"type":"number"},"authentication_type":{"description":"Type of authentication for the user, such as Local or RADIUS.","required":true,"type":"string","enum":["Local","Remote"]},"username":{"description":"User name (short name) that identifies the user to the system, such as 'admin'.","required":true,"type":"string"},"authorization_type":{"description":"Type of authorization for the user, such as Local or RADIUS.","required":true,"type":"string","enum":["Local","Remote"]},"role":{"description":"Role of the user. Defines permissions.","required":true,"type":"string","enum":["Developer","Administrator","Operator","Monitor","Event_Viewer","Dashboard_Viewer"]},"first_name":{"description":"First name of the user.","required":true,"type":"string"},"last_access":{"description":"Time of last access to the system. Unix time (epoch).","required":true,"type":"number"},"view_packet_details":{"description":"Boolean flag indicating if the user has access to packet data.","required":false,"type":"string"},"last_authentication":{"description":"Time of last authentication. Unix time (epoch).","required":true,"type":"number"},"view_user_information":{"description":"Boolean flag indicating if the user has access to identity information, such as Active Directory information.","required":false,"type":"string"},"login_timeout":{"description":"Timeout (in seconds) during which the user cannot log in to the system because of security policies.","required":true,"type":"number"}},"id":"User","type":"object"},"id":"Users","type":"array","example":[{"username":"admin","last_authentication":1352313328,"first_name":"Jonh","last_name":"Smith","authorization_type":"Local","enabled":true,"view_user_information":true,"authentication_type":"Local","role":"Administrator","login_timeout":900,"last_login":1352313328,"last_access":1352313328,"id":123},{"username":"admin2","last_authentication":1352313328,"first_name":"Mark","last_name":"Greg","authorization_type":"Local","enabled":true,"view_user_information":true,"authentication_type":"Local","role":"Administrator","login_timeout":900,"last_login":1352313328,"last_access":1352313328,"id":124}]},"authorization":"required"},"Re-authenticate user":{"description":"Re-authenticate user account. Requires basic authentication.","httpmethod":"GET","path":"users\/re_authenticate","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"authorization":"required"},"Get user":{"description":"User account by user ID.","formats":["xml","json"],"httpmethod":"GET","path":"users\/{user_id}","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"User account.","properties":{"enabled":{"description":"Boolean flag indicating if the user account is enabled.","required":true,"type":"string"},"last_name":{"description":"Last name of the user.","required":true,"type":"string"},"id":{"description":"Numeric ID of the user that the system uses internally and in the API.","required":true,"type":"number"},"last_login":{"description":"Time of last login. Unix time (epoch).","required":true,"type":"number"},"authentication_type":{"description":"Type of authentication for the user, such as Local or RADIUS.","required":true,"type":"string","enum":["Local","Remote"]},"username":{"description":"User name (short name) that identifies the user to the system, such as 'admin'.","required":true,"type":"string"},"authorization_type":{"description":"Type of authorization for the user, such as Local or RADIUS.","required":true,"type":"string","enum":["Local","Remote"]},"role":{"description":"Role of the user. Defines permissions.","required":true,"type":"string","enum":["Developer","Administrator","Operator","Monitor","Event_Viewer","Dashboard_Viewer"]},"first_name":{"description":"First name of the user.","required":true,"type":"string"},"last_access":{"description":"Time of last access to the system. Unix time (epoch).","required":true,"type":"number"},"view_packet_details":{"description":"Boolean flag indicating if the user has access to packet data.","required":false,"type":"string"},"last_authentication":{"description":"Time of last authentication. Unix time (epoch).","required":true,"type":"number"},"view_user_information":{"description":"Boolean flag indicating if the user has access to identity information, such as Active Directory information.","required":false,"type":"string"},"login_timeout":{"description":"Timeout (in seconds) during which the user cannot log in to the system because of security policies.","required":true,"type":"number"}},"id":"User","type":"object","example":{"username":"admin","last_authentication":1352313328,"first_name":"Jonh","last_name":"Smith","authorization_type":"Local","enabled":true,"view_user_information":true,"authentication_type":"Local","role":"Administrator","login_timeout":900,"last_login":1352313328,"last_access":1352313328,"id":123}},"authorization":"required"},"Test RADIUS user":{"description":"Test a RADIUS user.","parameters":{"password":{"required":true,"type":"string","description":"RADIUS password."},"username":{"required":true,"type":"string","description":"RADIUS username."}},"formats":["xml","json"],"httpmethod":"POST","path":"users\/radius\/test_user","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"RemoteTestUserResponse object.","properties":{"role_id":{"description":"Matched role ID.","required":true,"type":"number"},"error_message":{"description":"Error message.","required":true,"type":"string"},"permission":{"description":"Matched permission name.","required":true,"type":"string"},"server_type":{"description":"Indicates the type of the server being tested: RADIUS(2) or TACACS+(3).","required":true,"type":"number"},"role":{"description":"Matched role name.","required":true,"type":"string"},"details":{"description":"Remote user test details.","required":true,"type":"string"},"permission_id":{"description":"Matched permission ID.","required":true,"type":"string"},"server_ip":{"description":"Remote Server IP address.","required":true,"type":"string"},"authenticated":{"description":"Flag indicating if the remote user was authenticated.","required":true,"type":"string"},"attributes":{"description":"Attributes of Remote Test User Response.","items":{"description":"Remote attribute.","required":false,"additionalProperties":{"description":"Remote attribute value.","required":false,"xmlKeyName":"name","type":"string"},"id":"RemoteAttributes","type":"object"},"required":false,"id":"RemoteAttributesList","type":"array"},"authorized":{"description":"Flag indicating if the remote user was authorized (as Administrator, Monitor, etc).","required":true,"type":"string"}},"id":"RemoteTestUserResponse","type":"object","example":{"error_message":"","authenticated":true,"server_type":2,"permission_id":"","permission":"","role_id":0,"role":"","authorized":false,"server_ip":"10.38.8.112:1812","attributes":[{"25":"operatorClass"},{"25":"monitorClass"},{"25":"eventviewerClass"},{"17164":"unMappedRole"},{"17164":"monitorCascade"},{"17164":"eventviewerCascade"},{"17164":"dashboardCascade"},{"25":"DBAccess"},{"25":"dashboardClass"},{"17164":"AbC10~!@#$%^&*()_+{}|[]:;<>?\/.'z"},{"17164":"operatorCascade"},{"LOGIN_SERVER":"10.38.8.112:1812"},{"25":"adminClass1"},{"25":"unMappedClass"},{"25":"eventviewerClass"},{"17164":"adminCascade"}],"details":"Using 10.38.8.112:1812 - Unable to match a role."}},"authorization":"required"},"Test RADIUS server":{"description":"Test the connection to a RADIUS server.","parameters":{"server":{"required":true,"type":"string","description":"RADIUS server identifier, example server=IP:PORT."}},"formats":["xml","json"],"httpmethod":"GET","path":"users\/radius\/test_server","authorization_methods":["BASIC","COOKIE","OAUTH_2_0"],"response":{"description":"RemoteTestServerResponse object.","properties":{"success":{"description":"Flag indicating if the remote server test was successful.","required":true,"type":"string"},"message":{"description":"Response message.","required":true,"type":"string"}},"id":"RemoteTestServerResponse","type":"object","example":{"message":"Connection attempt succeeded","success":true}},"authorization":"required"}}}},"name":"profiler"}