Roll Back Release Bundle v2 Version Promotion

Description: Removes the latest promotion of a Release Bundle v2 version and restores the version to its previous environment, including the properties and evidence that were present when the version was first created. The contents of the removed promotion, including its artifacts, properties, and evidence, are deleted. For more information, see Promotion Rollback.Promotion Rollback

Since: 7.117.1

Security: Requires Read and Delete permissions to the target Release Bundle path; requires Delete permissions to the promoted repository paths.

Usage: POST /lifecycle/api/v2/promotion/rollback/{{release-bundle-name}}/{{release-bundle-version}}?from_environment={{current-env}}

Query Parameters:

Parameter	Required/Optional	Type	Description
`from_environment`	required	string	The name of the current environment in which the Release Bundle version is located. The rollback is executed from this environment. Warning Rollback will fail if the specified value does not match the current environment.
`async`	optional	boolean	Determines whether the operation should be asynchronous (`true`) or synchronous (`false`): The default value is `true`. When running in asynchronous mode, the timeline shows the rollback as being "in progress" until the operation completes successfully, fails, or times out. In the meantime, you are free to continue working in Artifactory.Use the Release Bundle Version Timeline When running in synchronous mode, you must wait until the rollback operation completes successfully, fails, or times out.
`project`	optional	string	Optional project key associated with the promotion.

Parameter

Required/Optional

Type

Description

from_environment

required

string

The name of the current environment in which the Release Bundle version is located. The rollback is executed from this environment.

Warning

Rollback will fail if the specified value does not match the current environment.

async

optional

boolean

Determines whether the operation should be asynchronous (true) or synchronous (false): The default value is true.

When running in asynchronous mode, the timeline shows the rollback as being "in progress" until the operation completes successfully, fails, or times out. In the meantime, you are free to continue working in Artifactory.Use the Release Bundle Version Timeline

When running in synchronous mode, you must wait until the rollback operation completes successfully, fails, or times out.

project

optional

string

Optional project key associated with the promotion.

Sample Response:

{
    "repository_key": "release-bundles-v2",
    "release_bundle_name": "rb1",
    "release_bundle_version": "1",
    "rollback_from_environment": "PROD",
    "rollback_to_environment": "QA"
}

The response includes the following information:

Property	Type	Description
`repository_key`	string	Release Bundles repository identifier that identifies where a Release Bundle version resides.The default value is `release-bundles-v2`.
`release_bundle_name`	string	Release Bundle name
`release_bundle_version`	string	Release Bundle version
`rollback_from_environment`	string	The source environment of the promotion to be rolled back.
`rollback_to_environment`	string	The target environment of the rollback.

Status Codes:

Code	Description
200	Submitted (Async)
204	Deleted (Sync)
401	Bad Credentials
403	Permission Denied