Search for Package Archives

JFrog REST APIs

Products
JFrog Xray
Content Type
REST API
ft:sourceType
Paligo

Description: Search for archived artifacts based on AQL query.

Note

This Cold Storage feature is available only for Artifactory Enterprise and Enterprise+ users.

Since: Artifactory 7.63.2

Security: Requires an admin user

Usage: POST /api/retention/searchPackages

Sample Request:

{
    "packageType": "docker",
    "repositories": [
        "docker-local"
    ],
    "name": "*"
}

The request includes the following information:

Parameter

Description

Required/Optional

packageType

The package type to search for (for example, Docker).

Required

repositories

The repositories to include in the search results.

Required

name

The package name pattern to include in the search results.

Required

version

The package version to include in the search results.

Optional

archiveTimeFrom

The earliest archive time to include in the search results.

Optional

archiveTimeTo

The latest archive time to include in the search results.

Optional

Sample Response:

{
	"results" : [ {
	  "manifestName" : "base-java11-2022.10.6-1684150761917.json",
	  "packageType" : "docker",
	  "packageName" : "bases/base-java11",
	  "version" : "2022.10.6",
	  "originalRepository" : "package-local-to-local-repo-5594",
	  "archivingTime" : 1684150761917
	} ],
	"range" : {
	  "start_pos" : 0,
	  "end_pos" : 1,
	  "total" : 1
	}
}

Status Codes:

Code

Description

200

Completed

400

Bad Request