Description: Returns a list of versions for a specified Release Bundle v2. Records are provided regardless of status, including failed attempts at creation.
Note
To get a list of versions for a specified Release Bundle v1, see Get Release Bundle v1 Versions.
Since: 7.63.2
Security: Requires Read permissions to the target Release Bundle path.
Usage:GET /lifecycle/api/v2/release_bundle/records/{name}
Query Parameters (optional):
Field | Type | Description |
---|---|---|
| string |
|
| integer | Sets the number of records to skip before returning the query response. Used for pagination purposes. |
| integer | Sets the maximum number of versions to return at one time. Used for pagination purposes. |
| string | Defines a filter for the list of Release Bundle versions. You can filter according to |
| string | Defines the criterion by which to order the list of Release Bundle versions: |
| boolean | Defines whether to list the Release Bundle versions in ascending (true) or descending (false) order. The default value is |
Note
See Common Optional Query Parameters for additional query parameters that are available for all Release Lifecycle Management APIs.
Sample Response:
{ "release_bundles": [ { "status": "FAILED", "repository_key": "release-bundles-v2", "release_bundle_name": "Commons-Bundle", "release_bundle_version": "1.0.1", "service_id": "jfrt@01h0nvs1pwjtzs15x7kbtv1sve", "created_by": "admin", "created": "2023-05-18T11:40:51.848Z", "messages": [ { "text": "Invalid AQL query for Release Bundle creation" } ], "permissions": { "promote": true, "distribute": true, "delete": false } }, { "status": "COMPLETED", "repository_key": "release-bundles-v2", "release_bundle_name": "Commons-Bundle", "release_bundle_version": "1.0.0", "service_id": "jfrt@01h0nvs1pwjtzs15x7kbtv1sve", "created_by": "admin", "created": "2023-05-18T11:25:35.936Z", "permissions": { "promote": true, "distribute": true, "delete": false } } ], "total": 2, "limit": 1000, "offset": 0 }
The response includes the following information:
Property | Description |
---|---|
| Status of the Release Bundle: STARTED, FAILED, COMPLETED, DELETING |
| Timestamp when the new version was created (ISO 8601 standard). |
| (Optional) Error messages related to the processing of the operation. |
| (Optional) Whether the user has permission to promote, distribute, and delete these Release Bundle versions. |
Status Codes:
Code | Description |
---|---|
200 | Submitted (asynchronous) |
401 | Bad Credentials |
403 | Permission Denied |
404 | Not Found (repository/build) |