Get Release Bundle v2 Version Specification

JFrog REST APIs

ft:sourceType
Paligo

Description: Returns the contents of a Release Bundle v2 version specification. The specification is 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): repository_key, project. See Common Optional Query Parameters.

Sample Response:

{
    "schema_version": "1.0.0",
    "service_id": "jfrt@01h0nvs1pwjtzs15x7kbtv1sve",
    "created_by": "admin",
    "created": "2023-05-18T11:26:02.912Z",
    "created_millis": 1684409162912,
    "artifacts": [
        {
            "path": "catalina/release-notes-1.0.0.txt",
            "checksum": "e06f59f5a976c7f4a5406907790bb8cad6148406282f07cd143fd1de64ca169d",
            "source_repository_key": "catalina-dev-generic-local",
            "package_type": "generic",
            "size": 470,
            "properties": [
                {
                    "key": "build.name",
                    "values": [
                        "Catalina-Build"
                    ]
                }
            ]
        }
    ],
    "checked_webhooks": [],
    "source": {
        "aql": "{source-AQL}",      // Non-empty when created from AQL
        "builds": [                 // Non-empty when created from Builds.
            {
                "build_repository": "artifactory-build-info",
                "build_name": "Commons-Build",
                "build_number": "1.0.1",
                "build_started": "2023-04-05T07:00:00.000+0200",
                "include_dependencies": false
            }
        ],
        "release_bundles": [        // Non-empty when created from Release Bundles.
            {
                "project_key": "default",
                "repository_key": "release-bundles-v2",
                "release_bundle_name": "Commons-Bundle",
                "release_bundle_version": "1.0.0"
            }
        ]
    }
}

The response includes the following information:

Property

Description

schema_version

The schema version number, which is used to track specification versions.

service_id

The unique identifier of the Artifactory instance where the Release Bundle was created.

created_by

The user who created the Release Bundle.

created

The timestamp when the Release Bundle was created (ISO 8601 standard).

created_millis

The timestamp when the Release Bundle was created (in milliseconds).

path

The path of a Release Bundle item relative to its contents directory.

checksum

The SHA-256 checksum of the source artifact.

source_repository_key

The source repository of the artifact.

package_type

The package type of the source repository associated with the artifact.

size

The size of the artifact (in bytes).

properties

Original source artifact properties that were present when the Release Bundle version was created:

Status Codes:

Code

Description

200

Fetched

401

Bad Credentials

403

Permission Denied

404

Not Found (Release Bundle/version)