Description: Specifies retention parameters for build info
Since: 5.2.1
Note: A promoted Build Info cannot be deleted using this API.
Security: Requires a privileged user. From version 6.6, requires delete permission for the build.
Usage: POST /api/build/retention/{buildName}?async=<true | false>
The async
flag controls how the endpoint responds to the client regarding build operations. It determines whether the client will receive an immediate response or wait until the operation is complete.
async=true
Returns a response immediately to the client.
The operation proceeds in the background.
async=false
Unless the configuration flag
build.retention.always.async
is set to true, the operation waits to complete before returning a response to the client.
Consumes: application/json
{ "deleteBuildArtifacts" : <true | false>, // When true, automatically removes build artifacts stored in Artifactory "count" : <count>, // The maximum number of builds to store in Artifactory. "minimumBuildDate" : <date>, // Earliest build date to store in Artifactory - ISO8601 (yyyy-MM-dd'T'HH:mm:ss.SSSZ) "buildNumbersNotToBeDiscarded" : [ ] // List of build numbers that should not be removed from Artifactory }
Sample Usage:
POST /api/build/retention/myBuild?async=true { "deleteBuildArtifacts" : true, "count" : 100, // "minimumBuildDate" : 1407345768020, "buildNumbersNotToBeDiscarded" : [ 5, 9] }