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"

}

]