Downloading Logs

The /downloads endpoint enables producers to download a log showing a summary of their end-customers’ download activity from all registry service instances.

Calling the /downloads endpoint using GET retrieves the following data:

The ID of the artifact that was downloaded
The name of the user who downloaded the artifact
The account to which user belongs
The timestamp when an artifact was accessed

Item

Description

URI

/registry/api/v1/downloads 

Method

GET 

Query parameters

month, page, pageSize, year

For details, see the Query Parameters table, below.

Request body

N/A

Response codes

200: Success

400: Bad request format.

401: Unauthorized

403: Authentication failed

500: Internal server error

The following query parameters must be specified:

Mandatory query parameters for the /downloads endpoint

Parameter

Description

month

The calendar month for which data is requested. Format=mm, where mm is the two-digit month (01 - 12).

If the month is the current month, then all data for that month up to the current time is returned.

page

Retrieves a specific page. Must be a number.

pageSize

Specifies how many data sets per page should be returned. Must be a number.

year

The year of the calendar month for which data is requested. Format=yyyy.

Sample Response

The following shows a data set from a sample response:

[

{

"id": 1234,

"artifact": "test1_id/abcd-123:blue",

"username": "registryserviceuser@revenera.com"

"account": "[test_acc1]",

"timestamp": "Fri Mar 11 09:50:06 UTC 2022"

}

]