Anchor

	Top
	Top

Attributes	Type	Description
taskId	Long	The task id of the scheduled task.
status	String	The status of the scheduled task.
scheduleDate	String	This is the scheduled date to run the scheduled task.
environmentId	Long	The environment Id of the scheduled task.
requestType	String	The request type of the scheduled task. The request type can be a step, gate, application, or project request.
flexFields	List<FlexField>	The list of flex fields for the scheduled task.
notes	String	Notes added when running or canceling the scheduled task.

Each scheduled task can be one of four different types: Step, Gate, Application, and Project.

...

Attributes	Type	Description
snapshotId	Long	The snapshot id of the step scheduled task.
pipelineName	String	The pipeline name of the step scheduled task.
environmentName	String	The environment name of the step scheduled task.
stepName	String	The step name of the step scheduled task.
releaseName	String	The release name of the step scheduled task.
releaseId	Long	The release Id of the step scheduled task.
snapshotName	String	The snapshot name of the step scheduled task.
pipelineStageStepExecId	Long	The pipeline stage step execution Id of the step scheduled task.
notes	String	Notes added when running or canceling the scheduled task.

Gate Scheduled Task

Attributes	Type	Description
snapshotId	Long	The snapshot id of the gate scheduled task.
pipelineName	String	The pipeline name of the gate scheduled task.
environmentName	String	The environment name of the gate scheduled task.
gateName	String	The gate name of the gate scheduled task.
releaseName	String	The release name of the gate scheduled task.
releaseId	Long	The release Id of the gate scheduled task.
snapshotName	String	The snapshot name of the gate scheduled task.
pipelineStageGateExecId	Long	The pipeline stage gate execution Id of the gate scheduled task.
notes	String	Notes added when running or canceling the scheduled task.

Application Scheduled Task

Attributes	Type	Description
applicationId	Long	The application Id of the application scheduled task.
applicationName	String	The application name of the application scheduled task.
folderVersionName	String	The folder version name of the application scheduled task.
folderRequestId	Long	The folder request Id of the application scheduled task.

...

Attributes	Type	Description
notes
String	Notes added when running or canceling the scheduled task.

Project Scheduled Task

Attributes	Type	Description
projectId	Long	The project Id of the project scheduled task.
projectName	String	The project name of the project scheduled task.
projectVersionName	String	The project version name of the project scheduled task.
workflowRequestId	Long	The workflow request Id of the project scheduled task.
notes	String	Notes added when running or canceling the scheduled task.

Back to Top

...

GET

GET by TaskId

...

Code Block

theme	Eclipse
title	Scheduled Task - 10000

{
   "projectVersionName": "1.0.11",
   "projectName": "Scheduled Tasks Project",
   "workflowRequestId": 656423,
   "projectId": 576267,
   "scheduledDate": "2099-03-16 22:17:52.0",
   "taskId": 14332,
   "requestType": "Project",
   "flexFields": [],
   "environmentId": 77954,
   "status": "PENDING",
   "notes": null
}

When we run a GET request at the following URL

...

Code Block

theme	Eclipse
title	Scheduled Task - 10000

{
   "projectVersionName": "1.0.11",
   "projectName": "Scheduled Tasks Project",
   "workflowRequestId": 656423,
   "projectId": 576267,
   "scheduledDate": "2099-03-16 22:17:52.0",
   "taskId": 14332,
   "requestType": "Project",
   "flexFields": [],
   "environmentId": 77954,
   "status": "PENDING",
   "notes": null
}

Back to Top

...

GET (Using Query Parameters)

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

Info

title	API URLs

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

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

workflowRequestId = {workflowRequestId}

folderRequestId = {folderRequestId}

pipelineStageGateExecId = {pipelineStageGateExecId}

pipelineStageStepExecId = {pipelineStageStepExecId}

projectId = {projectId}

applicationId = {applicationId}

environmentId = {environmentId}

Examples:

To return all of the scheduled tasks:

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

To search by project Id only:

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

...

Parameter	Type	Required	Description
workflowRequestId	URL	No	This is a URL query parameter for the workflow request Id which is used to search the scheduled tasks.
folderRequestId	URL	No	This is a URL query parameter for the folder request Id which is used to search the scheduled tasks.
pipelineStageGateExecId	URL	No	This is a URL query parameter for the pipeline stage gate execution Id which is used to search the scheduled tasks.
pipelineStageStepExecId	URL	No	This is a URL query parameter for the pipeline stage step execution Id which is used to search the scheduled tasks.
projectId	URL	No	This is a URL query parameter for the project Id which is used to search the scheduled tasks.
applicationId	URL	No	This is a URL query parameter for the application Id which is used to search the scheduled tasks.
environmentId	URL	No	This is a URL query parameter for the environment Id which is used to search the scheduled tasks.
notes	URL

Example

...

No	This is a URL query parameter for notes added to the task when running or canceling it.

Example

If we had a scheduled task in our database with the following attributes

Code Block

theme	Eclipse
title	scheduled Task

{
   "projectVersionName": "1.0.11",
   "projectName": "Scheduled Tasks Project",
   "workflowRequestId": 656423,
   "projectId": 10002,
   "scheduledDate": "2099-03-16 22:17:52.0",
   "taskId": 14332,
   "requestType": "Project",
   "flexFields": [],
   "environmentId": 77954,
   "status": "PENDING",
   "notes": null
}

When we run a GET request at the following URL

...

Code Block

theme	Eclipse
title	Approval Task

{
   "projectVersionName": "1.0.11",
   "projectName": "Scheduled Tasks Project",
   "workflowRequestId": 656423,
   "projectId": 10002,
   "scheduledDate": "2099-03-16 22:17:52.0",
   "taskId": 14332,
   "requestType": "Project",
   "flexFields": [],
   "environmentId": 77954,
   "status": "PENDING",
   "notes": null
}

Back to Top

...

Run Now By TaskId

...

Attributes	Type	Required	Description
Id	Long	Yes	The Id of the scheduled task you wish to run
notes	String	No	This is a URL query parameter to add notes to the task when running it.

Example

If we had a scheduled task in our database with the following attributes

...

Parameter	Type	Required	Description
workflowRequestId	URL	No	This is a URL query parameter for the workflow request Id which is used to search the scheduled tasks.
folderRequestId	URL	No	This is a URL query parameter for the folder request Id which is used to search the scheduled tasks.
pipelineStageGateExecId	URL	No	This is a URL query parameter for the pipeline stage gate execution Id which is used to search the scheduled tasks.
pipelineStageStepExecId	URL	No	This is a URL query parameter for the pipeline stage step execution Id which is used to search the scheduled tasks.
projectId	URL	No	This is a URL query parameter for the project Id which is used to search the scheduled tasks.
applicationId	URL	No	This is a URL query parameter for the application Id which is used to search the scheduled tasks.
environmentId	URL	No	This is a URL query parameter for the environment Id which is used to search the scheduled tasks.
notes	URL	No	This is a URL query parameter to add notes to the task when running it.

...

Code Block

theme	Eclipse
title	Approval Task

{
   "projectVersionName": "1.0.11",
   "projectName": "Scheduled Tasks Project",
   "workflowRequestId": 656423,
   "projectId": 10002,
   "scheduledDate": "2099-03-16 22:17:52.0",
   "taskId": 14332,
   "requestType": "Project",
   "flexFields": [],
   "environmentId": 77954,
   "status": "PENDING",
   "notes": null
}

When we run a PUT request at the following URL

http://host:port/flexdeploy/rest/tasks/scheduled/runnow?projectid=10002&notes=Approved+by+George

The PUT request would run the scheduled task and return the following JSON scheduled task object

Code Block

theme	Eclipse
title	Approval Task

{
   "projectVersionName": "1.0.11",
   "projectName": "Scheduled Tasks Project",
   "workflowRequestId": 656423,
   "projectId": 10002,
   "scheduledDate": "2099-03-16 22:17:52.0",
   "taskId": 14332,
   "requestType": "Project",
   "flexFields": [],
   "environmentId": 77954,
   "status": "APPROVED",
   "notes": "Approved by George"
}

Back to Top

...

Cancel By TaskId

...

Attributes	Type	Required	Description
Id	Long	Yes	The Id of the scheduled task you wish to cancel
notes	String	No	This is a URL query parameter to add notes to the task when canceling it.

Example

If we had a scheduled task in our database with the following attributes

Code Block

theme	Eclipse
title	Approval Task

{
   "projectVersionName": "1.0.11",
   "projectName": "Scheduled Tasks Project",
   "workflowRequestId": 656423,
   "projectId": 10002,
   "scheduledDate": "2099-03-16 22:17:52.0",
   "taskId": 14332,
   "requestType": "Project",
   "flexFields": [],
   "environmentId": 77954,
   "status": 77954"PENDING",
   "statusnotes": "PENDING"null
}

When we run a PUT request at the following URL

http://host:port/flexdeploy/rest/tasks/scheduled/cancel/14332?notes=

The PUT request would cancel the scheduled task and return the following JSON scheduled task object

Code Block

theme	Eclipse
title	Approval Task

{
   "projectVersionName": "1.0.11",
   "projectName": "Scheduled Tasks Project",
   "workflowRequestId": 656423,
   "projectId": 10002,
   "scheduledDate": "2099-03-16 22:17:52.0",
   "taskId": 14332,
   "requestType": "Project",
   "flexFields": [],
   "environmentId": 77954,
   "status": "REJECTED",
   "notes": null
}

Back to Top

...

Cancel using Query Parameters

...

Parameter	Type	Required	Description
workflowRequestId	URL	No	This is a URL query parameter for the workflow request Id which is used to search the scheduled tasks.
folderRequestId	URL	No	This is a URL query parameter for the folder request Id which is used to search the scheduled tasks.
pipelineStageGateExecId	URL	No	This is a URL query parameter for the pipeline stage gate execution Id which is used to search the scheduled tasks.
pipelineStageStepExecId	URL	No	This is a URL query parameter for the pipeline stage step execution Id which is used to search the scheduled tasks.
projectId	URL	No	This is a URL query parameter for the project Id which is used to search the scheduled tasks.
applicationId	URL	No	This is a URL query parameter for the application Id which is used to search the scheduled tasks.
environmentId	URL	No	This is a URL query parameter for the environment Id which is used to search the scheduled tasks.
notes	URL	No	This is a URL query parameter to add notes to the task when canceling it.

Example

If we had a scheduled task in our database with the following attributes

Code Block

theme	Eclipse
title	Approval Task

{
   "projectVersionName": "1.0.11",
   "projectName": "Scheduled Tasks Project",
   "workflowRequestId": 656423,
   "projectId": 10002,
   "scheduledDate": "2099-03-16 22:17:52.0",
   "taskId": 14332,
   "requestType": "Project",
   "flexFields": [],
   "environmentId": 77954,
   "status": "PENDING",
   "notes": null
}

When we run a PUT request at the following URL

...

Code Block

theme	Eclipse
title	Approval Task

{
   "projectVersionName": "1.0.11",
   "projectName": "Scheduled Tasks Project",
   "workflowRequestId": 656423,
   "projectId": 10002,
   "scheduledDate": "2099-03-16 22:17:52.0",
   "taskId": 14332,
   "requestType": "Project",
   "flexFields": [],
   "environmentId": 77954,
   "status": "REJECTED",
   "notes": null
}

Back to Top

...

Versions Compared

Old Version 9

New Version 10

Key

Gate Scheduled Task

Application Scheduled Task

Project Scheduled Task

GET

GET by TaskId

GET (Using Query Parameters)

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

Examples:

To return all of the scheduled tasks:

To search by project Id only:

Example

Example

Run Now By TaskId

Cancel By TaskId

Cancel using Query Parameters

Page Comparison

Versions Compared

Old Version 9

New Version 10

Key

Gate Scheduled Task

Application Scheduled Task

Project Scheduled Task

GET

GET by TaskId

GET (Using Query Parameters)

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

Examples:

To return all of the scheduled tasks:

To search by project Id only:

Example

Example

Run Now By TaskId

Cancel By TaskId

Cancel using Query Parameters