Get Release Bundle V2 Distribution Details

JFrog REST APIs

Content Type
REST API
ft:sourceType
Paligo

Description: Returns the details of a specific distribution of a Release Bundle v2 version.

Since: 7.63.2 (Artifactory), 2.20.1 (Distribution)

Security: Required Read permissions.

Usage:GET /lifecycle/api/v2/distribution/trackers/{release_bundle_name}/{release_bundle_version}/{distribution_id}

Query Parameters (optional): repository_key, project. See Common Optional Query Parameters.

Sample Response:

{
    "distribution_id": 748118725179052032,
    "distribution_friendly_id": 1,
    "type": "distribute",
    "release_bundle_name": "release-bundle",
    "release_bundle_version": "1.0.0",
    "status": "Completed",
    "distributed_by": "admin",
    "start_time": "2023-08-27T12:56:48.255+0300",
    "finish_time": "2023-08-27T12:56:49.792+0300",
    "duration": 1537,
    "distribution_rules": [
        {
            "site_name": "*",
            "city_name": "*",
            "country_codes": [],
            "groups": []
        }
    ],
    "sites": [
        {
            "status": "Completed",
            "target_artifactory": {
                "name": "edge1",
                "service_id": "jfrt@01h8v6akhjj66w1zbec3qy07wn",
                "type": "artifactory"
            },
            "total_files": 4,
            "total_bytes": 1672201,
            "distributed_files": 4,
            "distributed_bytes": 1672201,
            "distributed_by": "admin",
            "start_time": "2023-08-27T12:56:43.473+0300",
            "finish_time": "2023-08-27T12:56:49.785+0300",
            "file_errors": [],
            "files_in_progress": []
        }
    ]
}

The response includes the following information:

Property

Description

distribution_friendly_id

The sequential distribution number of this Release Bundle version.

type

Indicates whether this action was a distribution request or a remote delete request.

release_bundle_name

Name of the Release Bundle.

release_bundle_version

Release Bundle version.

status

The current status of the Release Bundle: IN_PROGRESS, COMPLETED, CREATED, FAILED, ABORTED, PARTIALLY_ABORTED, ABORT_IN_PROGRESS

distributed_by

The user who initiated distribution.

start_time

Timestamp when distribution of the Release Bundle version started.

finish_time

Timestamp when distribution of the Release Bundle version finished.

duration

The duration of the distribution from start to finish (in ms).

distribution_rules

Defines which distribution targets were included in this distribution.

sites

Provides the details of the distribution operation to each designated target.

Status Codes:

200 - Success