Versions Compared

Key

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

Anchor
Top
Top

...

Each approval task can be one of three different types: Release, Application, and Project.

Release Approval Task

AttributesTypeDescription
snapshotIdLongThe snapshot id of the release approval task.
pipelineNameStringThe pipeline name of the release approval task.
environmentNameStringThe environment name of the release approval task.
gateNameStringThe gate name of the release approval task.
releaseNameStringThe release name of the release approval task.
releaseDefinitionIdLongThe release definition Id of the release approval task. 
releaseSnapshotStringThe release snapshot of the release approval task.
externalIdStringThe external Id of the release approval task. If the release approval task is not an external approval this will be null.
externalSystemIdStringThe external System Id of the release approval task. If the release approval task is not an external approval this will be null.
externalSystemTypeStringThe external System type of the release approval task. If the release approval task is not an external approval this will be null.
pipelineStageGateExecIdLongThe pipeline stage execution Id of the release approval task.

Application Approval Task

AttributesTypeDescription
snapshotIdLongThe snapshot id of the release approval task.
pipelineNameStringThe pipeline name of the release approval task.
environmentNameStringThe environment name of the release approval task.
gateNameStringThe gate name of the release approval task.
releaseNameStringThe release name of the release approval task.
releaseDefinitionIdLongThe release definition Id of the release approval task. 
releaseSnapshotStringThe release snapshot of the release approval task.
externalIdStringThe external Id of the release approval task. If the release approval task is not an external approval this will be null.
externalSystemIdStringThe external System Id of the release approval task. If the release approval task is not an external approval this will be null.
externalSystemTypeStringThe external System type of the release approval task. If the release approval task is not an external approval this will be null.
pipelineStageGateExecIdLong

The pipeline stage execution Id of the release approval task.

Project Approval Task

AttributesTypeDescription
snapshotIdLongThe snapshot id of the release approval task.
pipelineNameStringThe pipeline name of the release approval task.
environmentNameStringThe environment name of the release approval task.
gateNameStringThe gate name of the release approval task.
releaseNameStringThe release name of the release approval task.
releaseDefinitionIdLongThe release definition Id of the release approval task. 
releaseSnapshotStringThe release snapshot of the release approval task.
externalIdStringThe external Id of the release approval task. If the release approval task is not an external approval this will be null.
externalSystemIdStringThe external System Id of the release approval task. If the release approval task is not an external approval this will be null.
externalSystemTypeStringThe external System type of the release approval task. If the release approval task is not an external approval this will be null.
pipelineStageGateExecIdLongThe pipeline stage execution Id of the release approval task.

...

GET (Using Query Parameters)

This GET service will return a list of approval tasks in the form of JSON objects based on a query parameter for the display name. Approval tasks are only returned if they contain the specified parameter. If no query parameters are given this request will return the entire list of approval tasks.

Info
titleAPI URLs

http://host:port/flexdeploy/rest/tasks/approval?

Append the following character sequences to the above URL to specify Query parameters.

workflowrequestid = {workflowRequestId}

foldererquestid = {folderRequestId}

pipelinestageexecid = {pipelineStageExecId}

projectid = {projectId}

applicationid = {applicationId}

environmentid = {environmentId}

Examples:
To return all of the approval tasks:

http://host:port/flexdeploy/rest/tasks/approval

To search by project Id only:

http://host:port/flexdeploy/rest/tasks/approval?projectid=11001

...

Code Block
themeEclipse
titleApproval Task
[
{
   "projectName": "Project 1",
   "projectVersionName": "1.0.21",
   "workflowRequestId": 11701,
   "projectId": 10002,
   "taskId": 11702,
   "status": "PENDING",
   "environmentId": 16109,
   "flexFields": [],
   "requestType": "Project",
   "requestorPath": "FlexDeploy / Application 1"
}
]

Back to Top

...

ApproveByTaskIdApprove By TaskId

This PUT service will approve an approval task with the given Id.

...

Code Block
themeEclipse
titleApproval Task
{
   "projectName": "Project 1",
   "projectVersionName": "1.0.21",
   "workflowRequestId": 11701,
   "projectId": 10002,
   "taskId": 11702,
   "status": "APPROVED",
   "environmentId": 16109,
   "flexFields": [],
   "requestType": "Project",
   "requestorPath": "FlexDeploy / Application 1"
}

Back to Top

...

Approve using Query Parameters

This PUT service will approve an approval task with the given attributes.

...

Code Block
themeEclipse
titleApproval Task
{
   "projectName": "Project 1",
   "projectVersionName": "1.0.21",
   "workflowRequestId": 11701,
   "projectId": 10002,
   "taskId": 11702,
   "status": "APPROVED",
   "environmentId": 16109,
   "flexFields": [],
   "requestType": "Project",
   "requestorPath": "FlexDeploy / Application 1"
}

Back to Top

...

RejectByTaskIdReject By TaskId

This PUT service will reject an approval task with the given Id.

...

Code Block
themeEclipse
titleApproval Task
{
   "projectName": "Project 1",
   "projectVersionName": "1.0.21",
   "workflowRequestId": 11701,
   "projectId": 10002,
   "taskId": 11702,
   "status": "REJECTED",
   "environmentId": 16109,
   "flexFields": [],
   "requestType": "Project",
   "requestorPath": "FlexDeploy / Application 1"
}

Back to Top

...

Reject using Query Parameters

This PUT service will approve an approval task with the given attributes.

...