Scheduled Tasks API
- Keith Ecker (Unlicensed)
- Chandresh Patel
- Karl Henselin
- Eugene Fedorenko (Unlicensed)
Owned by Keith Ecker (Unlicensed)
Scheduled Tasks can be accessed through this API using GET. This API can also run and cancel scheduled tasks based on task id and other parameters.
Authentication - Use Basic Authentication for this API.
GET
GET by TaskId
This GET service will find a scheduled task with the given task Id and return the JSON representation of the object.
Request
Parameter | Type | Required | Description |
|---|---|---|---|
Id | URL | Yes | This is a URL parameter for the Id which is used to find and return a scheduled task. |
Response
| 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.
Step Scheduled Task
| 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. |
| 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. |
Response Codes
| HTTP Code | Description |
|---|---|
| 200 | Task was found and returned |
| 400 | Bad request |
| 401 | Authentication failure |
| 403 | Authorization failure (no access to resource) |
| 404 | Task not found |
| 500 | Unexpected internal server error |
Example
If we had a scheduled task in our database with an Id of 10000 and the following attributes
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
http://host:port/flexdeploy/rest/v1/tasks/scheduled/10000
The GET request would return the following JSON scheduled task object
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
}
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.
API URLs
http://host:port/flexdeploy/rest/v1/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}
notes = {notes}
Examples:
To return all of the scheduled tasks:
http://host:port/flexdeploy/rest/v1/tasks/scheduled
To search by project Id only:
http://host:port/flexdeploy/rest/v1/tasks/scheduled?projectid=11001
The query parameters are not case sensitive. Searching by name=EXAMPLE is the same as searching by name=example.
Request
Parameter | Type | Required | Description |
|---|---|---|---|
| workflowRequestId | Query - Long | No | This is a URL query parameter for the workflow request Id which is used to search the scheduled tasks. |
| folderRequestId | Query - Long | No | This is a URL query parameter for the folder request Id which is used to search the scheduled tasks. |
| pipelineStageGateExecId | Query - Long | No | This is a URL query parameter for the pipeline stage gate execution Id which is used to search the scheduled tasks. |
| pipelineStageStepExecId | Query - Long | No | This is a URL query parameter for the pipeline stage step execution Id which is used to search the scheduled tasks. |
| projectId | Query - Long | No | This is a URL query parameter for the project Id which is used to search the scheduled tasks. |
| applicationId | Query - Long | No | This is a URL query parameter for the application Id which is used to search the scheduled tasks. |
| environmentId | Query - Long | No | This is a URL query parameter for the environment Id which is used to search the scheduled tasks. |
| notes | Query - String | No | This is a URL query parameter for notes added to the task when running or canceling it. Equals type search. |
Response
| 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.
Step Scheduled Task
| 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. |
| 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. |
Response Codes
| HTTP Code | Description |
|---|---|
| 200 | Search successful and results returned |
| 400 | Bad request |
| 401 | Authentication failure |
| 403 | Authorization failure (no access to resource) |
| 500 | Unexpected internal server error |
Example
If we had a scheduled task in our database with the following attributes
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
http://host:port/flexdeploy/rest/v1/tasks/scheduled?projectid=10002
The GET request would return the following JSON scheduled task object
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
}
Run Now By TaskId
This PUT service will run a scheduled task with the given Id.
Request
| 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. |
Response
| 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.
Step Scheduled Task
| 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. |
| 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. |
Response Codes
| HTTP Code | Description |
|---|---|
| 200 | Task was found and schedule set to run immediately |
| 400 | Bad request |
| 401 | Authentication failure |
| 403 | Authorization failure (no access to resource) |
| 404 | Task not found |
| 500 | Unexpected internal server error |
Example
If we had a scheduled task in our database with the following attributes
Approval Task
{
"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 PUT request at the following URL
http://host:port/flexdeploy/rest/v1/tasks/scheduled/runnow/14332?notes=Approved+by+George
The PUT request would run the scheduled task and return the following JSON scheduled task object
Approval Task
{
"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": "APPROVED",
"notes": "Approved by George"
}
Run Now using Query Parameters
This PUT service will run a scheduled task with the given attributes.
API URLs
http://host:port/flexdeploy/rest/v1/tasks/scheduled/runnow?
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}
notes = {notes}
Returned Tasks
Only one scheduled task can be run at a time. If more than one task matches the query parameters an exception will be thrown.
Request
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. |
Response
| 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.
Step Scheduled Task
| 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. |
| 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. |
Response Codes
| HTTP Code | Description |
|---|---|
| 200 | Task was found and schedule set to run immediately |
| 400 | Bad request |
| 401 | Authentication failure |
| 403 | Authorization failure (no access to resource) |
| 404 | Task not found |
| 500 | Unexpected internal server error |
Example
If we had a scheduled task in our database with the following attributes
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/v1/tasks/scheduled/runnow?projectid=10002¬es=Approved+by+George
The PUT request would run the scheduled task and return the following JSON scheduled task object
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"
}
Cancel By TaskId
This PUT service will reject a scheduled task with the given Id.
Request
| 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. |
Response
| 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.
Step Scheduled Task
| 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. |
| 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. |
Response Codes
| HTTP Code | Description |
|---|---|
| 200 | Task was found and cancelled |
| 400 | Bad request |
| 401 | Authentication failure |
| 403 | Authorization failure (no access to resource) |
| 404 | Task not found |
| 500 | Unexpected internal server error |
Example
If we had a scheduled task in our database with the following attributes
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/v1/tasks/scheduled/cancel/14332?notes=
The PUT request would cancel the scheduled task and return the following JSON scheduled task object
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
}
Cancel using Query Parameters
This PUT service will cancel a scheduled task with the given attributes.
API URLs
http://host:port/flexdeploy/rest/v1/tasks/scheduled/cancel?
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}
notes = {notes}
Returned Tasks
Only one scheduled task can be canceled at a time. If more than one task matches the query parameters an exception will be thrown.
Request
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. |
Response
| 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.
Step Scheduled Task
| 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. |
| 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. |
Response Codes
| HTTP Code | Description |
|---|---|
| 200 | Task was found and cancelled |
| 400 | Bad request |
| 401 | Authentication failure |
| 403 | Authorization failure (no access to resource) |
| 404 | Task not found |
| 500 | Unexpected internal server error |
Example
If we had a scheduled task in our database with the following attributes
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/v1/tasks/scheduled/cancel?projectid=10002¬es=Approved+by+George
The PUT request would cancel the scheduled task and return the following JSON scheduled task object
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": "Approved by George"
}
The following macros are not currently supported in the footer:
- style