Description: Returns the specification of the specified Release Bundle v2 version promotion. The specification file contains a snapshot of the items in the promotion.
Since: 7.63.2
Security: Requires Read permissions to the target Release Bundle path.
Usage:GET /lifecycle/api/v2/promotion/records/{name}/{version}/{created_mills}
Query Parameters (optional):
Note
See Common Optional Query Parameters for the query parameters that are available for all Release Lifecycle Management APIs.
Sample Response:
{
"environment": "QA",
"created_by": "admin",
"created": "2023-05-19T06:21:44.916Z",
"created_millis": 1684477304916,
"artifacts": [
{
"path": "commons-qa-maven-local/org/apache/tomcat/commons/1.0.0/commons-1.0.0.jar",
"checksum": "0d2053f76605e0734f5251a78c5dade5ee81b0f3730b3f603aedb90bc58033fb",
"package_type": "maven",
"package_name": "commons",
"package_version": "1.0.0"
},
{
"path": "commons-qa-generic-local/commons/release-notes-1.0.0.txt",
"checksum": "f87e4c72e60300b451739d545afc0251a6e2f4bd1beaa1902ba739455897ecb8",
"package_type": "generic"
}
]
}The response includes the following information:
Property | Description |
|---|---|
| Name of the target environment for the promotion. |
| The user who created the Release Bundle. |
| The timestamp when the Release Bundle was created (ISO 8601 standard). |
| The timestamp when the Release Bundle was created (in milliseconds). |
| The path of a Release Bundle item relative to its contents directory. |
| The SHA-256 checksum of the source artifact. |
| The package type of the source repository associated with the artifact. |
| The name of the package associated with the artifact. |
| The version of the package associated with the artifact. |
Status Codes:
Code | Description |
|---|---|
200 | Fetched |
401 | Bad Credentials |
403 | Permission Denied |
404 | Not Found (Release Bundle version/promotion) |