Search for Package Archives

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 /artifactory/api/retention/searchPackages

Consumes: application/json

Produces: application/json

Sample Request:

POST https://[JFrogPlatformURL]/artifactory/api/retention/searchPackages

{
    "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