跳至主要内容

Download an usage summary report

GET 
/api/v1/reports/usage-jobs/{usageJobId}/summaries

This API downloads a usage summary report for a specified task identified by usageJobId.

You can provide a startTime and endTime in yyyy-MM-dd format to define the reporting period. The format parameter specifies the download file format, currently only json is supported.

Upon success, the API returns the report file as a downloadable JSON file named summary-report-{usageJobId}.json.

If the task does not exist or an error occurs during report generation, a 500 status code is returned with an error message.

Parameters

  1. usageJobId: The unique identifier of the usage summary task to retrieve (required).
  2. startTime: Start date of the report in yyyy-MM-dd format (required).
  3. endTime: End date of the report in yyyy-MM-dd format (required).
  4. format: File format for download, default is json.

Notes

  • Ensure the usageJobId is correct and the task exists.
  • The report includes data points for the specified period only.
  • Downloading a report does not modify or delete the task.

Request​

Responses​

OK