Description: Returns the details of a selected Release Bundle v2 version, such as its creation time, the user who created it, the artifacts it includes, and so on. The details are stored in the form of a DSSE attestation, a signature envelope with a Base64-encoded payload, which contains a snapshot of the items in the Release Bundle.
Since: 7.63.2
Security: Requires Read permissions to the target Release Bundle path.
Usage:GET /lifecycle/api/v2/release_bundle/records/{name}/{version}
Query Parameters (optional):
Field | Type | Description |
---|---|---|
| integer | Sets the number of records to skip before returning the query response. Used for pagination purposes. The default is |
| integer | Sets the maximum number of artifacts to return at one time. Used for pagination purposes. |
Note
See Common Optional Query Parameters for additional query parameters that are available for all Release Lifecycle Management APIs.
Sample Response:
{ "service_id": "jfrt@01j800t90khnyz0mcy3py50r0d", "created_by": "admin", "created": "2024-09-17T13:25:55.013Z", "created_millis": 1726579555013, "total_artifacts_count": 16, "artifacts": [ { "path": "catalina/1.0.1/sha256__cd46d47a0b5cca1b85334f6775120e58b676cb24b6bdf2c6328788b6336d1e04", "checksum": "cd46d47a0b5cca1b85334f6775120e58b676cb24b6bdf2c6328788b6336d1e04", "source_repository_key": "catalina-dev-docker-local", "package_type": "docker", "package_name": "catalina", "package_version": "1.0.1", "size": 206, "properties": [ { "key": "build.name", "values": [ "Catalina-Build" ] }, { "key": "build.number", "values": [ "1.0.1" ] }, { "key": "build.timestamp", "values": [ "1726579000304" ] }, { "key": "sha256", "values": [ "cd46d47a0b5cca1b85334f6775120e58b676cb24b6bdf2c6328788b6336d1e04" ] } ] }, { "path": "catalina/1.0.1/sha256__fee54f469a2a999a89cf8659ae0eb33450d675f11109093382a7142152cfe4ff", "checksum": "fee54f469a2a999a89cf8659ae0eb33450d675f11109093382a7142152cfe4ff", "source_repository_key": "catalina-dev-docker-local", "package_type": "docker", "package_name": "catalina", "package_version": "1.0.1", "size": 657, "properties": [ { "key": "build.name", "values": [ "Catalina-Build" ] }, { "key": "build.number", "values": [ "1.0.1" ] }, { "key": "build.timestamp", "values": [ "1726579000304" ] }, { "key": "sha256", "values": [ "fee54f469a2a999a89cf8659ae0eb33450d675f11109093382a7142152cfe4ff" ] } ] }, { "path": "commons/1.0.1/manifest.json", "checksum": "09a6aa2c159946d264854baea15ebf0378a432157f2ffbd8737aff541cb9ed00", "source_repository_key": "commons-dev-docker-local", "package_type": "docker", "package_name": "commons", "package_version": "1.0.1", "size": 523, "properties": [ { "key": "artifactory.content-type", "values": [ "application/vnd.docker.distribution.manifest.v2+json" ] }, { "key": "build.name", "values": [ "Commons-Build" ] }, { "key": "build.number", "values": [ "1.0.1" ] }, { "key": "build.timestamp", "values": [ "1726579003176" ] }, { "key": "docker.manifest", "values": [ "1.0.1" ] }, { "key": "docker.manifest.digest", "values": [ "sha256:09a6aa2c159946d264854baea15ebf0378a432157f2ffbd8737aff541cb9ed00" ] }, { "key": "docker.manifest.type", "values": [ "application/vnd.docker.distribution.manifest.v2+json" ] }, { "key": "docker.repoName", "values": [ "commons" ] }, { "key": "oci.artifact.type", "values": [ "application/vnd.docker.container.image.v1+json" ] }, { "key": "sha256", "values": [ "09a6aa2c159946d264854baea15ebf0378a432157f2ffbd8737aff541cb9ed00" ] } ] } ] }
The response includes the following information:
Property | Description |
---|---|
| The unique identifier of the Artifactory instance where the Release Bundle version was created. |
| The user who created the Release Bundle version. |
| The timestamp when the Release Bundle version was created (ISO 8601 standard). |
| The timestamp when the Release Bundle version was created (in milliseconds). |
| The total number of artifacts included in the Release Bundle version. |
| The properties of the artifact, as described below. |
| The path of a Release Bundle item relative to its contents directory. |
| The SHA-256 checksum of the source artifact. |
| The source repository of the 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. |
| The size of the artifact (in bytes). |
| The source artifact properties that were present when the Release Bundle version was created (each property includes a |
Status Codes:
Code | Description |
---|---|
200 | Fetched |
401 | Bad Credentials |
403 | Permission Denied |
404 | Not Found (Release Bundle/version) |