Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

Info

Please note that this REST service was added on 10/5/2017. If you have an earlier build, you will need to upgrade to gain access to this feature.

This POST service will perform the same action found on the Release Dashboard Screen. This is used to complete an approval gate without having to log into the FlexDeploy serverThis POST service will approve or reject an Approval Gate for a pipeline stage execution. 

The pipeline execution for the release is located by using the given snapshotName, or the most recent snapshot if not provided.  The pipeline stage execution from within the pipeline execution is determined by finding the latest execution for the given environmentCode and gateName.  An error will be returned if the stage executing in not currently in the gates or if the gateName provided is not pending an approval.

Info
titleAPI URL
http://host:port/flexdeploy/rest/release/completeApprovalGate


Note

The authenticated user must be a member of the pipeline role assigned to gate in order to approve or reject it.


Complete Approval Gate Sample JSON Request
Anchor
Full
Full


{

"authentication": { "userId":"fdadmin", "password":"password1" },

Opening bracket

Authentication section, used on all types of requests.

Required parameters for creating or editing a release.

"releaseName": "Demo Release",

"gateName": "MyApprovalGate",

"environmentCode": "DEV",

"status": "APPROVED",

Complete the gate on the release named Demo Release

The Gate we want to complete is named "MyApprovalGate".

The gate we're approving is in the DEV Environment.

The Status to give to the gate. Options are [APPROVED, REJECTED]

Optionally, include any of this information.

Verify that your JSON is valid; check for trailing commas if you don't include this section.

"snapshotName": "09-24-2017 14:26:47"The name of the Snapshot we want to approve is "09-24-2017 14:26:47". If this is not specified, FlexDeploy will use the latest running snapshot.
}Closing bracket

Parameters

Parameter

Required

Type

Description

authentication

Y

Object

The login information for the user connecting to FlexDeploy.

releaseName

Y

String

The name of the release containing the gate we want to complete.

gateName

Y

String

The name of the gate to update the status on.

snapshotName

N

String

The name of the executing snapshot that is waiting on the gate. If not provided, latest Stage Execution will be used.

environmentCode

Y

String

The code for the environment the gate is executing in.

status

Y

String

The updated status to apply to the gate. Options are [APPROVED, REJECTED]

Example Request

Code Block
languagejs
themeRDark
{
   "authentication": 
    {
       "userId": "fdadmin",
       "password": "welcome1"
    },
   "releaseName": "Release 3",
   "environmentCode": "TEST",
   "gateName": "Manager Approval",
   "status" : "APPROVED"
}