Page History
Table of Contents |
---|
Cancel all started tasks
Description
By calling this endpoint, all the started tasks across all nodes will be reopen. Automatic tasks will also be executed.
Info | ||
---|---|---|
| ||
|
Setting the property blueriq.processengine.cancel-started-tasks to true when running in a multi-node environment might cause problems because while the cancellation of started tasks triggered on one node is running, a specific task could be still in progress on another node and it might be reopen.
Cancel all started tasks endpoint was created in order to avoid these types of situations.
Info |
---|
The endpoint overrules the blueriq.processengine.cancel-started-tasks property. |
Usage
The following steps should be followed for using this endpoint:
- Make sure that there exists a runtime user with a role that has the permission SCHEDULER_MANAGER.
- Check that blueriq.oauth2.client-id and blueriq.oauth2.secret are defined in application.properties file. If they are missing, please define them.
Access Runtime Swagger Interface:
Info icon false http://<server>:<port>/<runtime>/api/v1/docs/index.html - Fill the username and the password and press Generate Token in order to obtain a new token.
- Expand scheduler.
- Expand PUT /scheduler/maintenance/tasks/cancelStarted.
- Press Try it out!
Update Application Name And Version
Description
By calling one of these endpointsendpoint, the application id ids for some specific cases will be updated for the cases and jobs matching the specified criteriawith new values.
Info | ||
---|---|---|
| ||
|
Steps:
- Find all cases where by current application id contains the old application name. If old application version case id is specified in the url, find all cases the case where application id matches with the name and versionthe one sent in the request.
- Update application id for these cases with the new data sent in the request body.
- Get the jobs for the found cases and update them accordingly.
Request examples:
Update application name.
1.1 Update application name on every version of your old application
The application ids, for the cases with the current application id All cases where application name is "export-TestOldProject:0.0-Trunk", are updated to "export-TestNewProject:0.0-Trunk".Info icon false PUT http:
//<server>:<port>/<runtime_name>/api/v1/scheduler/maintenance/applications/export-TestOldProject:0.0-Trunk
{
"name" : "export-TestNewProject"
}
Note title Note If you do not specify the old application version in the url, this endpoint will update the application name for every version of the specified old application.
If you would like to update the application name only for a specific version, you should use the endpoints below.1.2. Update application name for a specific version
All cases where application name is "export-TestOldProject" and version is "Update application version
The application ids, for the cases with the current application id "export-TestOldProject:0.0-Trunk" are , are updated to "export-TestNewProject". Version remains the same-TestOldProject:0.1-Trunk".Info icon false PUT http:
//<server>:<port>/<runtime_name>/api/v1/scheduler/maintenance/applications/export-TestOldProject/:0.0-Trunk
{
"nameversion" : "export0.1-TestNewProjectTrunk"
}
Update application id (both name and version
All cases where application name is )
The application ids, for the cases with the current application id "export-TestOldProject" and version is ":0.0-Trunk", version is are updated to "export-TestNewProject:0.1-Trunk". Application name remains the same.Info icon false PUT http:
//<server>:<port>/<runtime_name>/api/v1/scheduler/maintenance/applications/export-TestOldProject/0.0-Trunk
{
"name" : "export-TestNewProject",
"version" : "0.1-Trunk"
}
- Update application id (both name and version)for a specific case
- Update application name
The application id, for the case with the current application id
All cases where application name is"export-TestOldProject
:0.0-Trunk"
and case id 1, is updated to "export-TestNewProject
:0.
0-Trunk".
Info icon false PUT http:
//<server>:<port>/<runtime_name>/api/v1/scheduler/maintenance/applications/export-TestOldProject
:0.0-Trunk?caseId=1
{
"name" : "export-TestNewProject"
}
"version" : "0.1-Trunk"
}
- Update application name
Usage
The following steps should be followed for using this endpoint:
- Update application version
The application id, for the case with the current application id "export-TestOldProject:0.0-Trunk" and case id 1, is updated to "export-TestOldProject:0.1-Trunk".
- Update application version
- Make sure that there exists a runtime user with a role that has the permission SCHEDULER_MANAGER.
- Check that blueriq.oauth2.client-id and blueriq.oauth2.secret are defined in application.properties file. If they are missing, please define them.
- Access Runtime Swagger Interface:
Info icon false PUT http:
//<server>:<port>/
<runtime_name>/api/v1
/
- Fill the username and the password and press Generate Token in order to obtain a new token.
- Expand scheduler.
- Expand PUT /
scheduler/maintenance/applications/
- Specify the old application name you would like to update. Optionally specify the application version.
- Specify the body of the request with the new application name, or new application version or both.
- Press Try it out!
Update Application Name and Version for a Case
Description
By calling this endpoint, only one case and it's jobs will be updated with the new information.export-TestOldProject:0.0-Trunk?caseId=1
{
"version" : "0.1-Trunk"
}
- Update application id
The application id, for the case with the current application id "export-TestOldProject:0.0-Trunk" and case id 1, is updated to "export-TestNewProject:0.1-Trunk".
Info icon false PUT http:
//<server>:<port>/<runtime_name>/api/v1/scheduler/maintenance/applications/
export-TestOldProject/0.0-Trunk?caseId=1
{
"name" :
"export-TestNewProject",
"version" :
}
Steps:
- Finds the case with the specified case id.
- Update the application id for the case found. Application id is updated with the new application name sent in the request body. Optionally, if specified in the body, application version will be updated as well.
- Calls the scheduler to find all jobs for the case from step 1.
- Updates all the jobs with the new application id.
"0.1-Trunk"
}
Usage
The following steps should be followed for using this endpoint:
- Make sure that there exists a runtime user with a role that has the permission SCHEDULER_MANAGER.
- Check that blueriq.oauth2.client-id and blueriq.oauth2.secret are defined in application.properties file. If they are missing, please define them.
Access Runtime Swagger Interface:
Info icon false http://<server>:<port>/<runtime>/api/v1/docs/index.html - Fill the username and the password and press Generate Token in order to obtain a new token.
- Expand scheduler.
- Expand PUT /scheduler/maintenance/applications/cases/{caseIdcurrentApplicationId}.
- Specify the case idrequest parameters.
- Press Try it out!