List generated reports
Returns a list of unexpired, generated reports.
Query Parameters
- limit int64
Limits the size of the response on each page to the specified number of items.
- start string
Sets the page number used to browse the collection. Pages are indexed starting from 1 (i.e.,
?start=1
). - filter string
Field Filter Condition Description start_timestamp $gte, $lt Start timestamp denotes the time filter for listing CSV report downloads. $gte and $lt accept RFC-3339 timestamps. For example, "filter":"{"start_timestamp":{"$gt":"2019-10-12T07:20:50.52Z"}}"
report_type $in Filter report downloaded records whose type is one of the given values. The possible values are: "activity", "compliance_v2", "audit", and "consumption". ?filter={"report_type":{"$in":["compliance"]}}
For more information about filtering, refer to the Filtering section of this guide.
- 200
- default
Success
- application/api.clumio.report-downloads=v1+json
- Schema
- Example (from schema)
Schema
_embedded object
_embedded contains the list of items of a list report CSV download query
items object[]
items denotes the list of CSV downloads in the current scope.
download_link stringThe link to the actual CSV report.
end_timestamp stringThe time when the request was completed.
expiration_timestamp stringThe time when this report CSV will expire and not be available for download.
file_name stringThe name of CSV file.
filters stringThe filters applied to the report when download was initiated.
id stringThe id of the report that uniquely identifies the report.
start_timestamp stringThe time when the request was made.
task_id stringThe Clumio-assigned ID of the task which generated the restored file.
type stringThe type of report this CSV Download is associated with. The possible values include "activity" and "compliance".
_links object
_links provides URLs to related navigable pages of a list report CSV download query
_first object
The HATEOAS link to the first page of results.
href stringThe URI for the referenced operation.
templated booleanDetermines whether the "href" link is a URI template. If set to
true
, the "href" link is a URI template.type stringThe HTTP method to be used with the "href" link for the referenced operation.
_last object
The HATEOAS link to the last page of results.
href stringThe URI for the referenced operation.
templated booleanDetermines whether the "href" link is a URI template. If set to
true
, the "href" link is a URI template.type stringThe HTTP method to be used with the "href" link for the referenced operation.
_next object
The HATEOAS link to the next page of results.
href stringThe URI for the referenced operation.
templated booleanDetermines whether the "href" link is a URI template. If set to
true
, the "href" link is a URI template.type stringThe HTTP method to be used with the "href" link for the referenced operation.
_prev object
The HATEOAS link to the previous page of results.
href stringThe URI for the referenced operation.
templated booleanDetermines whether the "href" link is a URI template. If set to
true
, the "href" link is a URI template.type stringThe HTTP method to be used with the "href" link for the referenced operation.
_self object
The HATEOAS link to this resource.
href stringThe URI for the referenced operation.
templated booleanDetermines whether the "href" link is a URI template. If set to
true
, the "href" link is a URI template.type stringThe HTTP method to be used with the "href" link for the referenced operation.
- current_count int64
The number of items listed on the current page.
- filter_applied string
The filter used in the request. The filter includes both manually-specified and system-generated filters.
- limit int64
The maximum number of items displayed per page in the response.
- start string
The page number used to get this response. Pages are indexed starting from 1 (i.e.,
"start": "1"
). - total_count int64
The total number of items, summed across all pages.
- total_pages_count int64
The total number of pages of results.
{
"_embedded": {
"items": [
{
"download_link": "string",
"end_timestamp": "string",
"expiration_timestamp": "string",
"file_name": "string",
"filters": "string",
"id": "string",
"start_timestamp": "string",
"task_id": "string",
"type": "string"
}
]
},
"_links": {
"_first": {
"href": "string",
"templated": true,
"type": "string"
},
"_last": {
"href": "string",
"templated": true,
"type": "string"
},
"_next": {
"href": "string",
"templated": true,
"type": "string"
},
"_prev": {
"href": "string",
"templated": true,
"type": "string"
},
"_self": {
"href": "string",
"templated": true,
"type": "string"
}
},
"current_count": 0,
"filter_applied": "string",
"limit": 0,
"start": "string",
"total_count": 0,
"total_pages_count": 0
}
Error
- application/json
- Schema
- Example (from schema)
Schema
errors object[]
A list of errors encountered during runtime.
error_code uint32error_message stringThe reason for the error.
{
"errors": [
{
"error_code": 0,
"error_message": "string"
}
]
}