Retrieving Artifact Details

The /projects/{project_name}/repositories/{repository_name}/artifacts endpoint returns the details of artifacts that are included in a particular project. The name of the project and the repository containing the artifact must be passed in the {project_name} and {repository_name} parameters, respectively.

Important:If you are using a shared registry, the project names are automatically prefixed with your 4-character tenant ID. Omit this tenant ID when you specify the project name. For example, if your project name is 1234-1000-project1-April2020 (where 1234 is your tenant ID), use the URI /registry/api/v1/projects/1000-project1-April2020.

Item	Description
URI	/registry/api/v1/projects/{project_name}/repositories/{repository_name}/artifacts
Method	GET
Query parameters	page, pageSize, project_name, repository_name, withImmutableStatus, withLabel, withScanOverview, withSignature, withTag For details, see the Query Parameters table, below.
Request body	N/A
Response codes	200: Success 401: Unauthorized 403: Forbidden 404: Project not found 500: Internal server error

The following query parameters can be added:

Query parameters for the /projects/{project_name}/repositories/{repository_name}/artifacts endpoint
Parameter	Description
page	Retrieves a specific page. Must be a number.
pageSize	Specifies how many data sets per page should be returned. Must be a number.
project_name	The name of the project containing the artifact (path parameter). Required parameter.
repository_name	The name of the repository containing the artifact (path parameter). Required parameter.
withImmutableStatus	Specifies whether the immutable status is included inside the tags of the returning artifacts.
withLabel	Specifies whether the labels are included inside the returning artifacts.
withScanOverview	Specifies whether the scan overview is included inside the returning artifacts.
withSignature	Specifies whether the signature is included inside the tags of the returning artifacts.
withTag	Specifies whether the tags are included inside the returning artifacts.

Sample Response

The following shows a sample response for a successful GET call, which returns the project, repository, names of images included in the repository, and charts:

{

"id": 369,

"downloadPackageId": "hello-world-dp",

"sysDownloadPackageId": 8592822,

"downloadPackageName": "Hello World Download Package",

"version": "2021",

"effectiveDateTimestamp": "Aug 4, 2021, 7:00:00 AM",

"expirationDateTimestamp": "Aug 4, 2025, 7:00:00 AM",

"downloadPackageAvailability": false,

"downloadPackageProducer": "Revenera (Revenera)",

"productLine": "748232",

"owner": false,

"restrictedDownloadPackage": false,

"supportsDockerImagesAndHelmCharts": false,

"tenantId": "1107",

"artifacts": [

{

"size": 4524,

"pushTime": "Sep 24, 2021, 5:52:43 PM",

"scanOverview": {},

"tags": [],

"pullTime": "Sep 24, 2021, 5:55:28 PM",

"labels": [],

"references": [],

"manifestMediaType": "application/vnd.docker.distribution.manifest.v2+json",

"extraAttrs": {

"os": "linux",

"created": "2021-03-05T23:25:25.230064203Z",

"architecture": "amd64"

"id": 8,

"digest": "sha256:1b26826f602946860c279fce658f31050cff2c596583af237d971f4629b57792",

"icon": "sha256:0048162a053eef4d4ce3fe7518615bef084403614f8bca43b40ae2e762e11e06",

"repositoryId": 7,

"mediaType": "application/vnd.docker.container.image.v1+json",

"projectId": 11,

"type": "IMAGE",

"annotations": {}

}

]

}