Managing Reports

This describes the web services that manage requesting and retrieving reports from Aculab Cloud.

Reports can take time to be generated as they usually involve substantial database access. As a result, separate web services for starting, monitoring and downloading reports are provided. Note that reports can be downloaded or deleted only once they have completed.

Reports can also be accessed via the Reports menu.

The reports contain a list of comma-separate values.

 This is a low level API. For information on higher level APIs see the Web Services Language Wrappers
  • Report Start

    This starts generation of a new report containing comma-separated values.

    Authorisation

    This API uses basic authentication, using your cloud account username and API Access Key.

    Username : cloudID/username (e.g. 1-2-0/bob@example.com)
    Password : API Access key

    Request:

    Url:https://ws.aculabcloud.net/report_start
    Methods:GET, POST

    ParameterValueDescription
    reportstringthe required content of the report. One of the following:
    • adr application data record
    • cdr call data record
    • fdr feature data record
    • msg message record
    • err error record
    fromstringthe point at which at the report should start in the format YYYY-MM-DD_hh:mm:ss.
    tostringthe point at which the report should end in the format YYYY-MM-DD_hh:mm:ss.

    Returns:

    A JSON object containing the following properties:

    ParameterValueDescription
    filenamestringthe filename of the report.

    Example:

    https://ws.aculabcloud.net/report_start?report=adr&from=2013-05-01_13:00:00&to=2013-05-03_13:00:00

    Response:

      {
        filename: "1-2-0_bill.blogs@acompany.com_adr_2013-05-01_13:00:00_2013-05-03_13:00:00.csv"
      }
  • Report Progress

    This queries the status of any reports currently in progress.

    Authorisation

    This API uses basic authentication, using your cloud account username and API Access Key.

    Username : cloudID/username (e.g. 1-2-0/bob@example.com)
    Password : API Access key

    Request:

    Url:https://ws.aculabcloud.net/report_progress
    Methods:GET, POST

    Returns:

    A json object containing the names of any reports that are currently in progress. For each report the following parameters are returned:

    ParameterValueDescription
    recordintegerthe number of records written to the report.
    progressstringa progress percentage (based on the start and end time).

    Example:

    https://ws.aculabcloud.net/report_progress

    Response:

      {
        "1-2-0_bill.blogs@acompany.com_adr_2013-05-06_13:00:00_2013-05-08_13:00:00.csv":
        {
          "record": 183,
          "progress": "63.15%"
        }
      }
  • Report Cancel

    This cancels generation of a report.

    Authorisation

    This API uses basic authentication, using your cloud account username and API Access Key.

    Username : cloudID/username (e.g. 1-2-0/bob@example.com)
    Password : API Access key

    Request:

    Url:https://ws.aculabcloud.net/report_cancel
    Methods:GET, POST

    ParameterValueDescription
    filenamestringthe filename of the report to cancel.

    Returns:

    Nothing.

    Example:

    https://ws.aculabcloud.net/report_cancel?filename=1-2-0_bill.blogs@acompany.com_adr_2013-05-06_13:00:00_2013-05-08_13:00:00.csv

  • Report List

    This lists all completed reports.

    Authorisation

    This API uses basic authentication, using your cloud account username and API Access Key.

    Username : cloudID/username (e.g. 1-2-0/bob@example.com)
    Password : API Access key

    Request:

    Url:https://ws.aculabcloud.net/report_list
    Methods:GET, POST

    Returns:

    A json object containing the names of any reports that have completed. For each report the following parameters are returned:

    ParameterValueDescription
    modifiedstringthe last modification time of the report.
    sizeintegerthe size of the report in bytes.

    Example:

    https://ws.aculabcloud.net/report_list

    Response:

      {
        "1-2-0_bill.blogs@acompany.com_adr_2013-05-01_13:00:00_2013-05-03_13:00:00.csv":
        {
          "modified": "2013-05-03_14:17:09",
          "size": 260
        }
      } 
  • Report Get

    This downloads a completed report from Aculab Cloud.

    Authorisation

    This API uses basic authentication, using your cloud account username and API Access Key.

    Username : cloudID/username (e.g. 1-2-0/bob@example.com)
    Password : API Access key

    Request:

    Url:https://ws.aculabcloud.net/report_get
    Methods:GET, HEAD, POST

    ParameterValueDescription
    filenamestringthe filename of the report to download.

    Returns:

    The report file data.

    Example:

    https://ws.aculabcloud.net/report_get?filename=1-2-0_bill.blogs@acompany.com_adr_2013-05-06_13:00:00_2013-05-08_13:00:00.csv

  • Report Delete

    This deletes a completed report from Aculab Cloud.

    Authorisation

    This API uses basic authentication, using your cloud account username and API Access Key.

    Username : cloudID/username (e.g. 1-2-0/bob@example.com)
    Password : API Access key

    Request:

    Url:https://ws.aculabcloud.net/report_delete
    Methods:DELETE, GET, POST

    ParameterValueDescription
    filenamestringthe filename of the report to delete.

    Returns:

    Nothing.

    Example:

    https://ws.aculabcloud.net/report_delete?filename=1-2-0_bill.blogs@acompany.com_adr_2013-05-06_13:00:00_2013-05-08_13:00:00.csv