Description: This API is called to create a new release bundle cleanup policy. For information on how to create a new cleanup policy via the UI, see Create Cleanup Policy - Release Bundle V2.
Security: Requires a platform admin. A project admin with permission can create a policy on the project level.
Usage: POST /artifactory/api/cleanup/bundles/policies/{policyKey}
Produces: application/json
Sample Query
POST http://{host:port}/artifactory/api/cleanup/bundles/policies/key1 { "key": "key1", //required "description": "", "cronExp": "0 0 2 * * ?", "itemType": "releaseBundle", //required "durationInMinutes": 60, "enabled": false, "searchCriteria": { "includeAllProjects": true, "includedProjects": [], //required "releaseBundles": [ { "name": "**", "projectKey": "" } ], //required "excludePromotedEnvironments": [ "**" ], //required "createdBeforeInMonths": 24 //required } }
Parameters:
Parameter | Type | Required | Description |
---|---|---|---|
| String | Yes | A unique identifier for the cleanup policy (for example, "key1"). This is a required field and must be unique. NoteA minimum of three characters is required, including letters, numbers, underscore and hyphen. |
| String | No | A brief description of the cleanup policy (optional). |
| String | Yes | A cron expression specifying when the cleanup job will run (for example, NoteThis parameter is not mandatory, however if left empty the policy will not run automatically and can only be triggered manually. |
| String | Yes | The type of items to clean up ( |
| Integer | No | The maximum duration (in minutes) for policy execution, after which the policy will stop running even if not completed. While setting a maximum run duration for a policy is useful for adhering to a strict cleanup schedule, it can cause the policy to stop before completion (for example, 60). |
| Boolean | No | Indicates if the cleanup policy is active ( A cleanup policy must be created inactive. This parameter is optional, but if used it must be set to false. If set to true when calling this API, the API call will fail and an error message is received. NoteAfter a cleanup policy is created, it can be set to active by calling Enable/Disable Release Bundle Cleanup Policy API. |
| Object | Yes | An object containing search criteria for the cleanup job. |
| Boolean | Yes | Specifies whether to include all projects in the search ( |
| Array of Strings | Yes | A list of specific project keys to include in the search (). |
| Array of Objects | Yes | An array specifying the release bundles to consider during cleanup. |
| String | Yes | The name of the release bundle. Set "**" to include all bundles. |
| String | Yes | The project identifier associated with the release bundle. This key is obtained from the Project Settings screen. Leave the field blank to apply at a global level. |
| Array of Strings | Yes | A list of environments to exclude from the cleanup process. To exclude all, set to |
| Integer | Yes | Specifies the time frame for filtering based on item creation date (for example, 24 months). |
Sample Response:
The contents of the response are identical to the Request.
Response Error Codes
Code | Description |
---|---|
400 | Validation errors. |
409 | A policy with the specified key already exists. |
500 | Internal server error. |