Report Manager API v1.0
Created Mar 27, 2024 at 07:04 PM

Resource: data_definition

A single data definition from a report instance

http://{device}/api/npm.probe.reports/1.0/instances/items/{report_id}/data_defs/items/{id}
  • JSON
  • {
      "act_as_source": boolean,
      "actual_centricity": string,
      "actual_filters": filter_criteria,
      "actual_source": data_def_source,
      "actual_time": {
        "granularities": [
          string
        ],
        "resolution": string,
        "time_ranges": time_pairs
      },
      "annotations": {
        <prop>: string
      },
      "available_columns": column_list,
      "centricity": string,
      "columns": column_list,
      "data": data_matrix,
      "datasource_id": string,
      "datasource_storage_key": string,
      "definition": data_definition,
      "filters": filter_criteria,
      "group_by": column_list,
      "id": integer,
      "limit": integer,
      "others": data_row,
      "reference_id": string,
      "report_id": integer,
      "source": data_def_source,
      "stats": {
        "completed": string,
        "created": string,
        "exec_time": string,
        "executing": string,
        "init_time": string,
        "initial_queue_pos": integer,
        "initialized": string,
        "initializing": string,
        "queue_time": string,
        "queued": string
      },
      "status": data_def_status,
      "subnet_by": {
        "mask_ipv4": integer,
        "mask_ipv6": integer
      },
      "summary_max_values": data_row,
      "summary_min_values": data_row,
      "synthetic": {
        "method": string,
        "sankey": {
          "levels": {
            <prop>: {
              "group_by": column_list,
              "limit": integer,
              "parent": string,
              <prop>: any
            }
          },
          <prop>: any
        }
      },
      "time": {
        "duration": string,
        "end": string,
        "fh_profile_id": integer,
        "granularity": string,
        "max_num_bins": integer,
        "offset": string,
        "optimal_num_bins": integer,
        "required_resolutions": [
          string
        ],
        "resolution": string,
        "retention_time": string,
        "start": string,
        "time_ranges": time_pairs,
        "timezone": string
      },
      "timeout": string,
      "top_by": [
        {
          "direction": string,
          "id": string,
          <prop>: any
        }
      ],
      "total_number_rows": integer,
      "totals": data_row,
      "ts_max_values": ts_statistical_results,
      "ts_min_values": ts_statistical_results,
      "ts_percentile_values": ts_statistical_results,
      "user_agent": string,
      "with_max_values": boolean,
      "with_min_values": boolean,
      "with_percentile_values": integer,
      "with_totals": boolean,
      <prop>: any
    }
    Property Name Type Description Notes
    data_definition <object> A single data definition from a report instance Required properties: [source];
    data_definition.act_as_source <boolean> Make this object available to other data requests (using source.reference_id) Optional;
    data_definition.actual_centricity <string> Actual centricity used by the back-end data source. Used by network flow sources. When AUTO is requested, the back-end sets this to HOST or INTERFACE. Optional; Values: HOST, INTERFACE;
    data_definition.actual_filters <filter_criteria> Array of filter criteria.
    data_definition.actual_source <data_def_source> Data source specificiation for a data definition.
    data_definition.actual_time <object> Actual time frame returned by the data source based on data availability. Optional;
    data_definition.actual_time.
    granularities
    <array of <string>> Array of actual granularities used in the query. Optional;
    data_definition.actual_time.
    granularities[items]
    <string> Actual granularity used in the query.
    data_definition.actual_time.resolution <string> Actual resolution used in the query. Optional;
    data_definition.actual_time.time_ranges <time_pairs> Array of time range pairs.
    data_definition.annotations <object> Key-value pairs for statistical purposes Optional;
    data_definition.annotations.<prop> <string> Optional;
    data_definition.available_columns <column_list> Collection of data column IDs.
    data_definition.centricity <string> For network flow sources, this parameter hints the back-end to calculate metrics from hosts point of view or from interfaces point of view. Optional; Values: AUTO, HOST, INTERFACE;
    data_definition.columns <column_list> Collection of data column IDs.
    data_definition.data <data_matrix> Array of results data rows within a data definition.
    data_definition.datasource_id <string> Data source to which the data definition belongs. Globally unique within the system. Read-only; Optional;
    data_definition.datasource_storage_key <string> Location within the datasource in which data is stored Read-only; Optional;
    data_definition.definition <data_definition> A single data definition from a report instance
    data_definition.filters <filter_criteria> Array of filter criteria.
    data_definition.group_by <column_list> Collection of data column IDs.
    data_definition.id <integer> ID for the data definition. Unique within a single report instance. Read-only; Optional;
    data_definition.limit <integer> Limit returned data rows to the specified number. Optional;
    data_definition.others <data_row> Row of results data within a data definition.
    data_definition.reference_id <string> Corresponding data definition ID in the client system Optional;
    data_definition.report_id <integer> Report instance ID to which the data definition belogs. Optional;
    data_definition.source <data_def_source> Data source specificiation for a data definition.
    data_definition.stats <object> Overall statistics for a data definition. Read-only; Optional;
    data_definition.stats.completed <string> Date and time when the data definition execution was ended (regardless of final status). High-precision timestamp in Unix Epoch format. Read-only; Optional;
    data_definition.stats.created <string> Date and time when the data definition was created. High-precision timestamp in Unix Epoch format. Read-only; Optional;
    data_definition.stats.exec_time <string> The time it took to execute. High-precision duration (seconds). Read-only; Optional;
    data_definition.stats.executing <string> Date and time when the data definition started executing. High-precision timestamp in Unix Epoch format. Read-only; Optional;
    data_definition.stats.init_time <string> The time it took initialize. High-precision duration (seconds). Read-only; Optional;
    data_definition.stats.initial_queue_pos <integer> The queue position at the time it was first placed in the queue. Read-only; Optional;
    data_definition.stats.initialized <string> Deprecated and unused anymore. Read-only; Optional;
    data_definition.stats.initializing <string> Date and time when the data definition started initializing. High-precision timestamp in Unix Epoch format. Read-only; Optional;
    data_definition.stats.queue_time <string> The time it took waiting in the queue. High-precision duration (seconds). Read-only; Optional;
    data_definition.stats.queued <string> Date and time when the data definition was placed on the queue. High-precision timestamp in Unix Epoch format. Read-only; Optional;
    data_definition.status <data_def_status> Status for a data definition.
    data_definition.subnet_by <object> How to group IPs by subnet Required properties: [mask_ipv4, mask_ipv6]; Optional;
    data_definition.subnet_by.mask_ipv4 <integer> Subnet CIDR mask for IPv4 Addresses Range: 0 to 32;
    data_definition.subnet_by.mask_ipv6 <integer> Subnet CIDR mask for IPv6 Addresses Range: 0 to 128;
    data_definition.summary_max_values <data_row> Row of results data within a data definition.
    data_definition.summary_min_values <data_row> Row of results data within a data definition.
    data_definition.synthetic <object> Structure of a sythnetic definition Optional;
    data_definition.synthetic.method <string> Optional;
    data_definition.synthetic.sankey <object> Optional;
    data_definition.synthetic.sankey.levels <object> Optional;
    data_definition.synthetic.sankey.levels.
    <prop>
    <object> Optional;
    data_definition.synthetic.sankey.levels.
    <prop>.group_by
    <column_list> Collection of data column IDs.
    data_definition.synthetic.sankey.levels.
    <prop>.limit
    <integer> Optional;
    data_definition.synthetic.sankey.levels.
    <prop>.parent
    <string> Optional;
    data_definition.synthetic.sankey.levels.
    <prop>.<prop>
    <any> Optional;
    data_definition.synthetic.sankey.<prop> <any> Optional;
    data_definition.time <object> The time frame that was requested for a reporting query. Optional;
    data_definition.time.duration <string> Time frame duration. When combined with either a start time or end time (but not both), determines the desired report time frame. If specified, and no start/end time is present, it is used with an end time of now. Optional;
    data_definition.time.end <string> The start time. This is a high-precision time value in Unix Epoch format. Optional;
    data_definition.time.fh_profile_id <integer> Business Hour Profile ID Optional; Minimum 1;
    data_definition.time.granularity <string> For sources that support multiple data granularity/rollup levels, the preferred granularity. If unspecified, the system will choose a granularity. Optional;
    data_definition.time.max_num_bins <integer> For auto-resolution, the maximum number of bins that the client supports. The system will not exceed this. Optional; Range: 1 to 20000;
    data_definition.time.offset <string> Offset the start/end time by the given amount (e.g., '5 min' to offset the start and end time back by 5 minutes). Optional;
    data_definition.time.optimal_num_bins <integer> For auto-resolution, the preferred number of bins for the client. The system will attempt to pick a resolution as close to this as possible. Optional; Range: 1 to 5000;
    data_definition.time.
    required_resolutions
    <array of <string>> Array of resolutions. When auto-resolution is requested, the back end will limit its choice to one of these. Optional;
    data_definition.time.
    required_resolutions[items]
    <string> A required resolution.
    data_definition.time.resolution <string> The requested resolution bin time-range for returned data (e.g., show in 1-hour bins). System will automatically pick if not specified. Optional;
    data_definition.time.retention_time <string> Specifies the time to retain data before rollint it off the query. Required for live data definitions. Optional;
    data_definition.time.start <string> The start time. This is a high-precision time value in Unix Epoch format. Optional;
    data_definition.time.time_ranges <time_pairs> Array of time range pairs.
    data_definition.time.timezone <string> Timezone name. Used for calculations when fh_profile_id is provided. Optional;
    data_definition.timeout <string> Maximum time within which to return data. Optional;
    data_definition.top_by <array of <object>> Array of sort criteria. Optional;
    data_definition.top_by[items] <object> A single sorting criterion, with direction.
    data_definition.top_by[items].direction <string> Direction in which to sort. Optional; Values: asc, desc;
    data_definition.top_by[items].id <string> ID to sort by Optional;
    data_definition.top_by[items].<prop> <any> Optional;
    data_definition.total_number_rows <integer> Total number of available data rows. Optional;
    data_definition.totals <data_row> Row of results data within a data definition.
    data_definition.ts_max_values <ts_statistical_results> Array of statistical result rows.
    data_definition.ts_min_values <ts_statistical_results> Array of statistical result rows.
    data_definition.ts_percentile_values <ts_statistical_results> Array of statistical result rows.
    data_definition.user_agent <string> User agent string for the client that generated the report. Read-only; Optional;
    data_definition.with_max_values <boolean> Whether to return column max value with the data results when querying. Optional;
    data_definition.with_min_values <boolean> Whether to return column min value with the data results when querying. Optional;
    data_definition.with_percentile_values <integer> Whether to return column percentile value with the data results when querying. Optional; Range: 80 to 95; Values: 80, 85, 90, 95;
    data_definition.with_totals <boolean> Whether to return column totals with the data results when querying. Optional;
    data_definition.<prop> <any> Optional;

    Resource: data_definitions

    Data definitions for a report instance

    http://{device}/api/npm.probe.reports/1.0/instances/items/{report_id}/data_defs
  • JSON
  • {
      "items": data_defs_list,
      "report_id": integer
    }
    Property Name Type Description Notes
    data_definitions <object> Data definitions for a report instance Required properties: [items];
    data_definitions.items <data_defs_list> Array of data definitions.
    data_definitions.report_id <integer> Report instance to which the data definitions belong. Optional;

    Resource: instance

    A single report instance

    http://{device}/api/npm.probe.reports/1.0/instances/items/{id}
  • JSON
  • {
      "access_rights": access_rights_obj,
      "created": string,
      "data_defs": data_defs_list,
      "id": integer,
      "idle_timeout": string,
      "info": report_instance_info,
      "last_modified": string,
      "live": boolean,
      "presentation": report_instance_presentation,
      "priority": string,
      "schedule_id": integer,
      "schedule_name": string,
      "template_id": integer,
      "template_name": string,
      "user_agent": string,
      "views": {
        "pdf": boolean,
        "raw_data": boolean
      },
      <prop>: any
    }
    Property Name Type Description Notes
    instance <object> A single report instance Required properties: [data_defs];
    instance.access_rights <access_rights_obj> Specifies roles that have read/write access to an object. Users with read_write roles can read, update and delete the object. They can also share the object with other roles.
    instance.created <string> Date and time at which the report was created. High precision timestamp in Unix Epoch format. Optional;
    instance.data_defs <data_defs_list> Array of data definitions.
    instance.id <integer> ID of the report instance Read-only; Optional;
    instance.idle_timeout <string> Specifies the time to keep processing live data requests after last access (get info or get data). Optional;
    instance.info <report_instance_info> General information for a report instance
    instance.last_modified <string> Date and time at which the report was last modified. High precision timestamp in Unix Epoch format. Optional;
    instance.live <boolean> Whether the instance is a live (continuously updating) instance, rather than a static instance. Optional;
    instance.presentation <report_instance_presentation> Client presentation information for a report instance
    instance.priority <string> FUTURE - Report instance priority. Not yet used. Optional; Values: low, medium, high;
    instance.schedule_id <integer> Schedule ID which generated the report instance. Optional; Minimum 0;
    instance.schedule_name <string> Schedule name which generated the report instance. Optional;
    instance.template_id <integer> Template ID on which the report instance was based. Optional; Minimum 0;
    instance.template_name <string> Template name on which the report instance was based. Optional;
    instance.user_agent <string> User agent string for the client that generated the report. Read-only; Optional;
    instance.views <object> Indicates which views, PDF or JSON (raw), are available for an instance Required properties: [pdf, raw_data]; Optional;
    instance.views.pdf <boolean> Whether rendered PDF is available. Read-only;
    instance.views.raw_data <boolean> Whether raw JSON data is available. Read-only;
    instance.<prop> <any> Optional;

    Resource: instances

    Collection of report instances. When limiting results via query, all parameters must match a report instance for it to show.

    http://{device}/api/npm.probe.reports/1.0/instances{?sort,name,state,template_name,schedule_name,access_rights,access,schedule_id,tag,limit,sortby,offset,owner,template_id,description}
  • JSON
  • {
      "items": [ instance ],
      "meta": {
        "access": string,
        "access_rights": string,
        "count": integer,
        "description": string,
        "limit": integer,
        "name": string,
        "offset": integer,
        "owner": string,
        "schedule_id": string,
        "schedule_name": string,
        "sort": string,
        "sortby": string,
        "state": string,
        "tag": string,
        "template_id": string,
        "template_name": string,
        "total": integer
      }
    }
    Property Name Type Description Notes
    instances <object> Collection of report instances. When limiting results via query, all parameters must match a report instance for it to show. Required properties: [items];
    instances.items <array of <instance>> Array of report instances
    instances.items[items] <instance> A single report instance
    instances.meta <object> Meta data of the data set returned when a list of reports are fetched. Optional;
    instances.meta.access <string> Filters instances based on access. "all", returns all instances that the current authenticated user has access to. "private", returns all instances not shared with any roles that the current authenticated user has access to. "shared", returns all instances shared with one or more roles. "public" returns all objects marked public. Optional; Values: all, private, shared, public;
    instances.meta.access_rights <string> Filters instances based on access_rights. "all", returns all instances with read_only or read_write rights that the authenticated user has access to. "read_only", returns all instances with read_only rights that the authenticated user has access to. "read_write", Returns all instances with read_write rights that the authenticated user has access to. Optional; Values: all, read_only, read_write;
    instances.meta.count <integer> The actual number of reports returned for this request. Optional;
    instances.meta.description <string> Filters report instances based on the description param passed. Does a case-insensitive substring match. Optional;
    instances.meta.limit <integer> Maximum number report instances to be returned. Optional;
    instances.meta.name <string> Filters report instances based on the name param passed. Does a case-insensitive substring match. Optional;
    instances.meta.offset <integer> Start returning report instances from offset specified. Optional;
    instances.meta.owner <string> Filters report instances based on the owner param passed. Does a case sensitive exact match of each owner, not a substring comparison of each owner. Owners can be passed as comma-separated values. Report instances with at least one of the owners passed in the query string will be matched. Optional;
    instances.meta.schedule_id <string> Filters report instances based on the schedule_id param passed. schedule_id can be passed as comma-separated values. Report instances with one of the schedule_ids passed in the query string param will be matched. Optional;
    instances.meta.schedule_name <string> Filters report instances based on the schedule_name param passed. Does a case-insensitive substring match. Optional;
    instances.meta.sort <string> Sort direction. Optional; Values: asc, desc;
    instances.meta.sortby <string> Sort by specified field. Optional; Values: name, description, owner, created, last_modified;
    instances.meta.state <string> Filter by specified state. Optional; Values: temporary, saved;
    instances.meta.tag <string> Filters report instances based on the tag param passed. Does a case-insensitive exact match of each tag, not a substring comparison of each tag. Tags can be passed as comma-separated values. Report instances with at least one of the passed tags will be matched. Optional;
    instances.meta.template_id <string> Filters report instances based on the template_id param passed. template_id can be passed as comma-separated values. Report instances with one of the template_ids passed in the query string param will be matched. Optional;
    instances.meta.template_name <string> Filters report instances based on the template_name param passed. Does a case-insensitive substring match. Optional;
    instances.meta.total <integer> Total number of reports in the system that match the filter criteria. Optional;

    Resource: report_instance_info

    General information for a report instance

    http://{device}/api/npm.probe.reports/1.0/instances/items/{report_id}/info
  • JSON
  • {
      "description": string,
      "name": string,
      "report_id": integer,
      "state": string,
      "tags": tags_obj,
      <prop>: any
    }
    Property Name Type Description Notes
    report_instance_info <object> General information for a report instance
    report_instance_info.description <string> Description of the report instance Optional;
    report_instance_info.name <string> Name of the report instance Optional;
    report_instance_info.report_id <integer> ID of the report instance Read-only; Optional;
    report_instance_info.state <string> Persistence state of the report instance Optional; Values: temporary, saved, transient;
    report_instance_info.tags <tags_obj> Container for a set of report tags.
    report_instance_info.<prop> <any> Optional;

    Resource: report_instance_presentation

    Client presentation information for a report instance

    http://{device}/api/npm.probe.reports/1.0/instances/items/{report_id}/presentation
  • JSON
  • {
      "report_id": integer,
      <prop>: any
    }
    Property Name Type Description Notes
    report_instance_presentation <object> Client presentation information for a report instance
    report_instance_presentation.report_id <integer> Instance ID to which the presentation belongs. Read-only; Optional;
    report_instance_presentation.<prop> <any> Optional;

    Resource: schedule

    A single report schedule.

    http://{device}/api/npm.probe.reports/1.0/schedules/items/{id}
  • JSON
  • {
      "access_rights": access_rights_obj,
      "created": string,
      "enabled": boolean,
      "err_message": run_message,
      "execute_on": execution_timestamps,
      "executing": boolean,
      "executing_job_id": integer,
      "id": integer,
      "info": schedule_info,
      "last_executed": string,
      "last_modified": string,
      "notification_attachment_name": string,
      "notification_enabled": boolean,
      "notification_message": string,
      "num_instances": integer,
      "rrule": recurrence_rule,
      "subscription": {
        "recipient_ids": [
          integer
        ],
        "subscription_id": integer,
        "to": [
          string
        ],
        <prop>: any
      },
      "template_id": integer,
      "template_name": string,
      "time": {
        "duration": string,
        "fh_profile_id": integer,
        "snap_to_previous": string
      },
      <prop>: any
    }
    Property Name Type Description Notes
    schedule <object> A single report schedule. Required properties: [enabled, info, template_id, rrule, time];
    schedule.access_rights <access_rights_obj> Specifies roles that have read/write access to an object. Users with read_write roles can read, update and delete the object. They can also share the object with other roles.
    schedule.created <string> Optional;
    schedule.enabled <boolean>
    schedule.err_message <run_message> Runtime status message for a data definition.
    schedule.execute_on <execution_timestamps> Report Schedule's next execution times in relative to the Unix Epoch format.
    schedule.executing <boolean> Flag indicating if the schedule is executing at the moment Read-only; Optional;
    schedule.executing_job_id <integer> Optional;
    schedule.id <integer> Read-only; Optional;
    schedule.info <schedule_info> Information on a scheduled report
    schedule.last_executed <string> Optional;
    schedule.last_modified <string> Optional;
    schedule.num_instances <integer> Number of snapshots already generated by this schedule Read-only; Optional;
    schedule.rrule <recurrence_rule> Recurrence rule specification for report schedule. Implements(incompletely) the Recurrence Rule Specification from iCalendar RFC - http://www.ietf.org/rfc/rfc2445.txt
    schedule.subscription <object> Optional;
    schedule.subscription.recipient_ids <array of <integer>> List of pre-defined recipient IDs. Optional;
    schedule.subscription.recipient_ids
    [items]
    <integer>
    schedule.subscription.subscription_id <integer> Read-only; Optional;
    schedule.subscription.to <array of <string>> List of emails. Optional;
    schedule.subscription.to[items] <string>
    schedule.subscription.<prop> <any> Optional;
    schedule.template_id <integer>
    schedule.template_name <string> Name of the report template used for this schedule Read-only; Optional;
    schedule.time <object> Snapshot execution time range Required properties: [duration, snap_to_previous];
    schedule.time.duration <string> Lenght of time duration. Example: 1 hour.
    schedule.time.fh_profile_id <integer> Business Hour Profile ID Optional; Minimum 1;
    schedule.time.snap_to_previous <string> Calendar unit to snap the end of time range to. Values: NONE, MINUTE, HOUR, DAY, WEEK, MONTH, QUARTER, YEAR;
    schedule.<prop> <any> Optional;
    schedule.notification_attachment_name <string>
    schedule.notification_enabled <boolean>
    schedule.notification_message <string>

    Resource: schedule_info

    Information on a scheduled report

    http://{device}/api/npm.probe.reports/1.0/schedules/items/{schedule_id}/info
  • JSON
  • {
      "description": string,
      "name": string,
      "schedule_id": integer,
      "tags": tags_obj,
      <prop>: any
    }
    Property Name Type Description Notes
    schedule_info <object> Information on a scheduled report Required properties: [name];
    schedule_info.description <string> Optional;
    schedule_info.name <string>
    schedule_info.schedule_id <integer> Read-only; Optional;
    schedule_info.tags <tags_obj> Container for a set of report tags.
    schedule_info.<prop> <any> Optional;

    Resource: schedules

    List of scheduled reports

    http://{device}/api/npm.probe.reports/1.0/schedules{?sort,name,template_name,access_rights,access,tag,limit,sortby,offset,owner,template_id,description}
  • JSON
  • {
      "items": [ schedule ],
      "meta": {
        "access": string,
        "access_rights": string,
        "count": integer,
        "description": string,
        "limit": integer,
        "name": string,
        "offset": integer,
        "owner": string,
        "sort": string,
        "sortby": string,
        "tag": string,
        "template_id": string,
        "template_name": string,
        "total": integer
      }
    }
    Property Name Type Description Notes
    schedules <object> List of scheduled reports Required properties: [items];
    schedules.items <array of <schedule>>
    schedules.items[items] <schedule> A single report schedule.
    schedules.meta <object> Meta data of the data set returned when a list of schedules are fetched. Optional;
    schedules.meta.access <string> Schedules filtered by this access param in the query string Optional;
    schedules.meta.access_rights <string> Schedules filtered by this access_rights param in the query string Optional;
    schedules.meta.count <integer> The actual number of rows returned as for this request. Optional;
    schedules.meta.description <string> Schedules filtered by this description param in the query string Optional;
    schedules.meta.limit <integer> The maximum number rows to return. 0 means no limit. Optional;
    schedules.meta.name <string> Schedules filtered by this name param in the query string Optional;
    schedules.meta.offset <integer> Number of schedules to be skipped as specified by offset. Offset value of 0 will be ignored. Optional;
    schedules.meta.owner <string> Schedules filtered by this owner param in the query string Optional;
    schedules.meta.sort <string> Schedules sorted on param in the query string Optional;
    schedules.meta.sortby <string> Schedules sorted by ascending or descending Optional;
    schedules.meta.tag <string> Schedules filtered by this tag/tags param in the query string Optional;
    schedules.meta.template_id <string> Optional;
    schedules.meta.template_name <string> Schedules filtered by this template name param in the query string Optional;
    schedules.meta.total <integer> Total number of rows that exists for the requested resource Optional;

    Resource: template

    A single report template

    http://{device}/api/npm.probe.reports/1.0/templates/items/{id}
  • JSON
  • {
      "access_rights": access_rights_obj,
      "created": string,
      "id": integer,
      "info": template_info,
      "last_modified": string,
      "num_schedules": integer,
      "override": integer,
      <prop>: any
    }
    Property Name Type Description Notes
    template <object> A single report template Required properties: [info];
    template.access_rights <access_rights_obj> Specifies roles that have read/write access to an object. Users with read_write roles can read, update and delete the object. They can also share the object with other roles.
    template.created <string> Optional;
    template.id <integer> Read-only; Optional;
    template.info <template_info> Information about a report template
    template.last_modified <string> Optional;
    template.num_schedules <integer> Number of schedules already generated by this template Optional;
    template.override <integer> Read-only; Optional;
    template.<prop> <any> Optional;

    Resource: template_info

    Information about a report template

    http://{device}/api/npm.probe.reports/1.0/templates/items/{template_id}/info
  • JSON
  • {
      "built_in": boolean,
      "client_source": string,
      "description": string,
      "name": string,
      "navigator": boolean,
      "overridden": boolean,
      "schedulable": boolean,
      "tags": tags_obj,
      "template_id": integer,
      "type": string,
      <prop>: any
    }
    Property Name Type Description Notes
    template_info <object> Information about a report template Required properties: [name, client_source];
    template_info.built_in <boolean> Read-only; Optional;
    template_info.client_source <string> Values: ALLOY_CLIENT, WEB_UI;
    template_info.description <string> Optional;
    template_info.name <string>
    template_info.navigator <boolean> Optional;
    template_info.overridden <boolean> Read-only; Optional;
    template_info.schedulable <boolean> Optional;
    template_info.tags <tags_obj> Container for a set of report tags.
    template_info.template_id <integer> Read-only; Optional;
    template_info.type <string> Optional; Values: INTERACTIVE, DASHBOARD, REPORT, FAVORITES, HIDDEN;
    template_info.<prop> <any> Optional;

    Resource: templates

    List of system report templates

    http://{device}/api/npm.probe.reports/1.0/templates{?sort,schedulable,description,access_rights,client_source,access,tag,limit,sortby,offset,owner,built_in,type,navigator,name}
  • JSON
  • {
      "items": [ template ],
      "meta": {
        "access": string,
        "access_rights": string,
        "built_in": boolean,
        "client_source": string,
        "count": integer,
        "description": string,
        "limit": integer,
        "name": string,
        "navigator": boolean,
        "offset": integer,
        "owner": string,
        "schedulable": boolean,
        "sort": string,
        "sortby": string,
        "tag": string,
        "total": integer,
        "type": string
      }
    }
    Property Name Type Description Notes
    templates <object> List of system report templates Required properties: [items];
    templates.items <array of <template>>
    templates.items[items] <template> A single report template
    templates.meta <object> Meta data of the data set returned when a list of templates are fetched. Optional;
    templates.meta.access <string> Templates filtered by this access param in the query string Optional;
    templates.meta.access_rights <string> Templates filtered by this access_rights param in the query string Optional;
    templates.meta.built_in <boolean> Templates filtered by this built_in param in the query string Optional;
    templates.meta.client_source <string> Templates filtered by this client_source param in the query string Optional;
    templates.meta.count <integer> The actual number of rows returned as for this request. Optional;
    templates.meta.description <string> Templates filtered by this description param in the query string Optional;
    templates.meta.limit <integer> The maximum number rows to return. 0 means no limit. Optional;
    templates.meta.name <string> Templates filtered by this name param in the query string Optional;
    templates.meta.navigator <boolean> Templates filtered by this navigator param in the query string Optional;
    templates.meta.offset <integer> Number of templates to be skipped as specified by offset. Offset value of 0 will be ignored. Optional;
    templates.meta.owner <string> Templates filtered by this owner param in the query string Optional;
    templates.meta.schedulable <boolean> Templates filtered by this schedulable param in the query string Optional;
    templates.meta.sort <string> Templates sorted on param in the query string Optional;
    templates.meta.sortby <string> Templates sorted by ascending or descending Optional;
    templates.meta.tag <string> Templates filtered by this tag/tags param in the query string Optional;
    templates.meta.total <integer> Total number of rows that exists for the requested resource Optional;
    templates.meta.type <string> Templates filtered by this type param in the query string Optional;

    Type: access_rights_obj

    Specifies roles that have read/write access to an object. Users with read_write roles can read, update and delete the object. They can also share the object with other roles.

  • JSON
  • {
      "effective": {
        "access_right": string,
        <prop>: any
      },
      "id": integer,
      "owner": string,
      "public": {
        "access_right": string,
        <prop>: any
      },
      "shared": {
        "read_only": roles_obj,
        "read_write": roles_obj,
        <prop>: any
      }
    }
    Property Name Type Description Notes
    access_rights_obj <object> Specifies roles that have read/write access to an object. Users with read_write roles can read, update and delete the object. They can also share the object with other roles.
    access_rights_obj.effective <object> Provides a summary of user's access to the object. This is a read-only type. Required properties: [access_right]; Optional;
    access_rights_obj.effective.access_right <string> Value READ_WRITE implies that the user has read_write access on the object. READ_ONLY implies the user has read only access. NONE implies the user has no access to the object being requested. Read-only; Values: NONE, READ_ONLY, READ_WRITE;
    access_rights_obj.effective.<prop> <any> Optional;
    access_rights_obj.id <integer> Read-only; Optional;
    access_rights_obj.owner <string> Read-only; Optional;
    access_rights_obj.public <object> Indicates if an object/resource is public. All public objects/resouce are read_only. Required properties: [access_right]; Optional;
    access_rights_obj.public.access_right <string> Values: READ_ONLY;
    access_rights_obj.public.<prop> <any> Optional;
    access_rights_obj.shared <object> Property read_only - Specifies a list of roles that have read_only access to the resource/object. Property read_write - Specifies a list of roles that have read_write access to the resource/object. Optional;
    access_rights_obj.shared.read_only <roles_obj>
    access_rights_obj.shared.read_write <roles_obj>
    access_rights_obj.shared.<prop> <any> Optional;

    Type: column_list

    Collection of data column IDs.

  • JSON
  • [
      string
    ]
    Property Name Type Description Notes
    column_list <array of <string>> Collection of data column IDs.
    column_list[items] <string> Data column ID.

    Type: data_def_results

    Data results for one data definition

  • JSON
  • {
      "columns": column_list,
      "data": data_matrix,
      "datasource_id": string,
      "datasource_storage_key": string,
      "errors": run_messages,
      "id": integer,
      "meta": {
        "count": integer,
        "end_time": string,
        "filter": string,
        "filtered": integer,
        "limit": integer,
        "offset": integer,
        "resolution": string,
        "sort_by": string,
        "start_time": string,
        "total": integer
      },
      "others": data_row,
      "reference_id": string,
      "summary_max_values": data_row,
      "summary_min_values": data_row,
      "totals": data_row,
      "ts_max_values": ts_statistical_results,
      "ts_min_values": ts_statistical_results,
      "ts_percentile_values": ts_statistical_results
    }
    Property Name Type Description Notes
    data_def_results <object> Data results for one data definition
    data_def_results.columns <column_list> Collection of data column IDs.
    data_def_results.data <data_matrix> Array of results data rows within a data definition.
    data_def_results.datasource_id <string> Data source to which the results belong. Read-only; Optional;
    data_def_results.datasource_storage_key <string> Location within the datasource in which data is stored Read-only; Optional;
    data_def_results.errors <run_messages> Array of runtime status messages for a data definition.
    data_def_results.id <integer> Data definition ID to which the results belong. Read-only; Optional;
    data_def_results.meta <object> Information about a data definition's data results. Optional;
    data_def_results.meta.count <integer> The number of data rows returned in the current results after filtering Optional;
    data_def_results.meta.end_time <string> The end time of a live data request. A high-precision time value, based on Unix Epoch time. Optional;
    data_def_results.meta.filter <string> A Steelfilter expression to filter results. Optional;
    data_def_results.meta.filtered <integer> Total number of data rows matching the filter. Optional;
    data_def_results.meta.limit <integer> The maximum number of data rows to return. 0 means no limit. Optional;
    data_def_results.meta.offset <integer> Skip the specified number of rows before starting to return data. Optional;
    data_def_results.meta.resolution <string> The resolution to use for a live data request. Optional;
    data_def_results.meta.sort_by <string> Sort by specified column. Format is a comma separated list, with a column id and direction for each entry (column_id1 desc,column_id2 asc) Optional;
    data_def_results.meta.start_time <string> The start time of a live data request. A high-precision time value, based on Unix Epoch time. Optional;
    data_def_results.meta.total <integer> Total number of available data rows. Optional;
    data_def_results.others <data_row> Row of results data within a data definition.
    data_def_results.reference_id <string> Corresponding data definition ID in the client system Read-only; Optional;
    data_def_results.summary_max_values <data_row> Row of results data within a data definition.
    data_def_results.summary_min_values <data_row> Row of results data within a data definition.
    data_def_results.totals <data_row> Row of results data within a data definition.
    data_def_results.ts_max_values <ts_statistical_results> Array of statistical result rows.
    data_def_results.ts_min_values <ts_statistical_results> Array of statistical result rows.
    data_def_results.ts_percentile_values <ts_statistical_results> Array of statistical result rows.

    Type: data_def_source

    Data source specificiation for a data definition.

  • JSON
  • {
      "name": string,
      "origin": string,
      "path": string,
      "reference_id": string,
      "tags": [
        string
      ],
      "type": string,
      <prop>: any
    }
    Property Name Type Description Notes
    data_def_source <object> Data source specificiation for a data definition. Required properties: [name];
    data_def_source.name <string> Name of the data source for the data definition.
    data_def_source.origin <string> The origin data source for a query that is performing a sub-query into another data source (e.g., alerting requesting into system_metrics). Required in these cases for data column validation. Optional;
    data_def_source.path <string> Reference path to the requested data from within the data source. Optional;
    data_def_source.reference_id <string> Reference to another data_def which will be used as a source to this one. Optional;
    data_def_source.tags <array of <string>> Custom labels for this data source Optional;
    data_def_source.tags[items] <string>
    data_def_source.type <string> Data type requested Optional;
    data_def_source.<prop> <any> Optional;

    Type: data_def_status

    Status for a data definition.

  • JSON
  • {
      "datasource_id": string,
      "datasource_storage_key": string,
      "id": integer,
      "messages": run_messages,
      "progress": {
        "percent": integer,
        "processed_records": integer,
        "remaining_sec": integer,
        "total_records": integer
      },
      "reference_id": string,
      "state": string
    }
    Property Name Type Description Notes
    data_def_status <object> Status for a data definition.
    data_def_status.datasource_id <string> Data source to which the data definition belongs. Read-only; Optional;
    data_def_status.datasource_storage_key <string> Location within the datasource in which data is stored Read-only; Optional;
    data_def_status.id <integer> Data definition ID to which the status belongs. Read-only; Optional;
    data_def_status.messages <run_messages> Array of runtime status messages for a data definition.
    data_def_status.progress <object> Details about the current progress of a running query. Optional;
    data_def_status.progress.percent <integer> Percentage of the total query that has been executed so far. Optional; Range: 0 to 100;
    data_def_status.progress.
    processed_records
    <integer> Optional; Minimum 0;
    data_def_status.progress.remaining_sec <integer> Estimated number of seconds remaining in the query. Optional; Minimum 0;
    data_def_status.progress.total_records <integer> Optional; Minimum 0;
    data_def_status.reference_id <string> Corresponding data definition ID in the client system Read-only; Optional;
    data_def_status.state <string> Current execution state of the data definition. Optional; Values: pending, initializing, executing, completed, error, collecting;

    Type: data_defs_list

    Array of data definitions.

    Property Name Type Description Notes
    data_defs_list <array of <data_definition>> Array of data definitions.
    data_defs_list[items] <data_definition> A single data definition from a report instance

    Type: data_matrix

    Array of results data rows within a data definition.

  • JSON
  • [ data_row ]
    Property Name Type Description Notes
    data_matrix <array of <data_row>> Array of results data rows within a data definition.
    data_matrix[items] <data_row> Row of results data within a data definition.

    Type: data_row

    Row of results data within a data definition.

  • JSON
  • [
      string
    ]
    Property Name Type Description Notes
    data_row <array of <string>> Row of results data within a data definition.
    data_row[items] <string>

    Type: execution_timestamps

    Report Schedule's next execution times in relative to the Unix Epoch format.

  • JSON
  • [
      string
    ]
    Property Name Type Description Notes
    execution_timestamps <array of <string>> Report Schedule's next execution times in relative to the Unix Epoch format.
    execution_timestamps[items] <string>

    Type: filter_criteria

    Array of filter criteria.

  • JSON
  • [
      {
        "context": string,
        "id": string,
        "type": string,
        "value": string,
        <prop>: any
      }
    ]
    Property Name Type Description Notes
    filter_criteria <array of <object>> Array of filter criteria.
    filter_criteria[items] <object> A single filter criterion to use on the query data.
    filter_criteria[items].context <string> Context from which the filter was applied (e.g., user request, data drill-down, etc). Optional; Values: NONE, INTERNAL, USER, DRILL_DOWN;
    filter_criteria[items].id <string> Filter criterion ID. Optional;
    filter_criteria[items].type <string> The type of filter used on the data. Optional; Values: STEELFILTER, WIRESHARK, BPF;
    filter_criteria[items].value <string> Query filter text to use. Optional;
    filter_criteria[items].<prop> <any> Optional;

    Type: multiple_ids

    Array of IDs.

  • JSON
  • [
      integer
    ]
    Property Name Type Description Notes
    multiple_ids <array of <integer>> Array of IDs.
    multiple_ids[items] <integer> ID.

    Type: recurrence_rule

    Recurrence rule specification for report schedule. Implements(incompletely) the Recurrence Rule Specification from iCalendar RFC - http://www.ietf.org/rfc/rfc2445.txt

  • JSON
  • {
      "allow_past_times": boolean,
      "byday": [
        string
      ],
      "byhour": [
        integer
      ],
      "byminute": [
        integer
      ],
      "bymonth": [
        integer
      ],
      "bymonthday": [
        integer
      ],
      "bysecond": [
        integer
      ],
      "bysetpos": [
        integer
      ],
      "count": integer,
      "dtstart": string,
      "freq": string,
      "interval": integer,
      "timezone": string,
      "until": string
    }
    Property Name Type Description Notes
    recurrence_rule <object> Recurrence rule specification for report schedule. Implements(incompletely) the Recurrence Rule Specification from iCalendar RFC - http://www.ietf.org/rfc/rfc2445.txt Required properties: [freq];
    recurrence_rule.allow_past_times <boolean> Allow calculating rules for times in the past. If not set, or set to false, the result rules will always be in the future regardless of what dtstart is passed. Optional;
    recurrence_rule.byday <array of <string>> Specifies days of the week. Optional;
    recurrence_rule.byday[items] <string> Values: SU, MO, TU, WE, TH, FR, SA;
    recurrence_rule.byhour <array of <integer>> Specifies hours of the day. Optional;
    recurrence_rule.byhour[items] <integer> Range: 0 to 23;
    recurrence_rule.byminute <array of <integer>> Specifies minutes within an hour. Optional;
    recurrence_rule.byminute[items] <integer> Range: 0 to 59;
    recurrence_rule.bymonth <array of <integer>> Specifies array of the months of the year. Optional;
    recurrence_rule.bymonth[items] <integer> Range: 1 to 12;
    recurrence_rule.bymonthday <array of <integer>> Specifies array of days of the month. 0 is invalid value. Optional;
    recurrence_rule.bymonthday[items] <integer> Range: -31 to 31;
    recurrence_rule.bysecond <array of <integer>> Specifies seconds within a minute. Optional;
    recurrence_rule.bysecond[items] <integer> Range: 0 to 59;
    recurrence_rule.bysetpos <array of <integer>> Specifies the nth occurrence within the set of events specified by the rule. 0 is invalid value. It MUST only be used in conjunction with another BYxxx rule part. Optional;
    recurrence_rule.bysetpos[items] <integer> Range: -366 to 366;
    recurrence_rule.count <integer> Specifies the number of occurrences, either until or count must be specified, but not both. Optional;
    recurrence_rule.dtstart <string> Specifies when the recurrence begins. High precision timestamp relative to the Unix Epoch. Optional;
    recurrence_rule.freq <string> Type of recurrence rule, to specify repeating events based on an interval of freq. Values: YEARLY, QUARTERLY, MONTHLY, WEEKLY, DAILY, HOURLY, ONETIME;
    recurrence_rule.interval <integer> Specifies how often the recurrence rule repeats. Optional;
    recurrence_rule.timezone <string> Specifies when the time zone. Example: Europe/Budapest. If not specified Etc/Universal is used. Optional;
    recurrence_rule.until <string> Specifies when the recurrence ends, either until or count must be specified, but not both. High precision timestamp relative to the Unix Epoch. Optional;

    Type: roles_obj

  • JSON
  • {
      "roles": [
        integer
      ],
      <prop>: any
    }
    Property Name Type Description Notes
    roles_obj <object> Required properties: [roles];
    roles_obj.roles <array of <integer>>
    roles_obj.roles[items] <integer>
    roles_obj.<prop> <any> Optional;

    Type: rpt_tag_obj

    A single set of report tags.

  • JSON
  • {
      "owner": string,
      "tags": tags_obj,
      <prop>: any
    }
    Property Name Type Description Notes
    rpt_tag_obj <object> A single set of report tags. Required properties: [owner, tags];
    rpt_tag_obj.owner <string> Owner of the tag set.
    rpt_tag_obj.tags <tags_obj> Container for a set of report tags.
    rpt_tag_obj.<prop> <any> Optional;

    Type: rpt_tags

    Container for all tag sets on a report instance.

  • JSON
  • {
      "items": [ rpt_tag_obj ]
    }
    Property Name Type Description Notes
    rpt_tags <object> Container for all tag sets on a report instance. Required properties: [items];
    rpt_tags.items <array of <rpt_tag_obj>> Array of report instance tag sets.
    rpt_tags.items[items] <rpt_tag_obj> A single set of report tags.

    Type: run_message

    Runtime status message for a data definition.

  • JSON
  • {
      "details": {
        <prop>: string
      },
      "id": string,
      "module_id": string,
      "nested": run_message,
      "text": string,
      <prop>: any
    }
    Property Name Type Description Notes
    run_message <object> Runtime status message for a data definition.
    run_message.details <object> Additional message details. Optional;
    run_message.details.<prop> <string> Optional;
    run_message.id <string> Machine-parsable message or error code. Optional;
    run_message.module_id <string> The system module that generated the message. Optional;
    run_message.nested <run_message> Runtime status message for a data definition.
    run_message.text <string> Message text. Optional;
    run_message.<prop> <any> Optional;

    Type: run_messages

    Array of runtime status messages for a data definition.

  • JSON
  • Property Name Type Description Notes
    run_messages <array of <run_message>> Array of runtime status messages for a data definition.
    run_messages[items] <run_message> Runtime status message for a data definition.

    Type: schd_fhp_obj

    A single pair of report schedule and business hour profile.

  • JSON
  • {
      "fh_profile_id": integer,
      "schedule_id": integer,
      "schedule_name": string,
      <prop>: any
    }
    Property Name Type Description Notes
    schd_fhp_obj <object> A single pair of report schedule and business hour profile. Required properties: [schedule_id, fh_profile_id];
    schd_fhp_obj.fh_profile_id <integer> Business Hour Profile ID Minimum 1;
    schd_fhp_obj.schedule_id <integer> Read-only;
    schd_fhp_obj.schedule_name <string> Optional;
    schd_fhp_obj.<prop> <any> Optional;

    Type: schedule_ids

    Array of report schedule IDs.

  • JSON
  • [
      integer
    ]
    Property Name Type Description Notes
    schedule_ids <array of <integer>> Array of report schedule IDs.
    schedule_ids[items] <integer> Report schedule ID.

    Type: tags_obj

    Container for a set of report tags.

  • JSON
  • {
      "items": [
        string
      ],
      <prop>: any
    }
    Property Name Type Description Notes
    tags_obj <object> Container for a set of report tags.
    tags_obj.items <array of <string>> Array of report tags. Optional;
    tags_obj.items[items] <string> Report tag.
    tags_obj.<prop> <any> Optional;

    Type: template_ids

    Array of report template IDs

  • JSON
  • [
      integer
    ]
    Property Name Type Description Notes
    template_ids <array of <integer>> Array of report template IDs
    template_ids[items] <integer> Report template ID

    Type: time_pairs

    Array of time range pairs.

  • JSON
  • [
      {
        "end": string,
        "start": string
      }
    ]
    Property Name Type Description Notes
    time_pairs <array of <object>> Array of time range pairs.
    time_pairs[items] <object> A time range pair, consisting of a start and end time. Required properties: [start, end];
    time_pairs[items].end <string> The ending time. This is a high-precision time value in Unix Epoch format.
    time_pairs[items].start <string> The start time. This is a high-precision time value in Unix Epoch format.

    Type: ts_statistical_results

    Array of statistical result rows.

  • JSON
  • [
      {
        "group_by": data_row,
        "metric": string,
        "value": string
      }
    ]
    Property Name Type Description Notes
    ts_statistical_results <array of <object>> Array of statistical result rows.
    ts_statistical_results[items] <object> One result from a statistical or compatibility function Required properties: [value, metric, group_by];
    ts_statistical_results[items].group_by <data_row> Row of results data within a data definition.
    ts_statistical_results[items].metric <string> The metric column ID
    ts_statistical_results[items].value <string> The result value