Start PUD Process

post

https://{jfrog_url}/artifactory/api/system/storage/prune/start

This REST API is called to start a new PUD process, or resume a PUD process that was stopped before completion. The Pruning Unreferenced Data (PUD) APIs are used to delete randomly existing binaries in the filestore that are not referenced in Artifactory.

Since: 7.72

Security: Requires an admin user.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

PUD process parameters

dryRun

boolean

Defaults to false

If false then unreferenced binaries will be actually removed from the filestore. If true then unreferenced binaries will not be removed from the filestore. This mode may be useful to estimate the number of unreferenced binaries in each directory without actually removing them.

startFromDirectory

string

If present, the PUD process will continue from the directory identified here. If this parameter is omitted, the PUD process starts to prune from the beginning of the directories list.

startFromBinary

int32

Defaults to 0

If present, the PUD process continues from this position in the last directory that the previous PUD process stopped at. This parameter can be found in the response of the Get Status API at lastHandledDirectory>binariesProcessed. If omitted, the PUD process starts to prune from the first binary in the directory.

binaryOlderThanDays

int32

Defaults to 1

If present, unreferenced binaries that are newer than binaryOlderThanDays are ignored by the PUD process. If binaryOlderThanDays = 0, the PUD process does not relate to the binary creation date.

Responses

202Accepted - PUD process has been submitted

401Bad Credentials - Authentication failed. A valid token is required.

403Permission Denied - The user does not have admin permissions.

412Precondition Failed - PUD process is already running or cannot be started