TaskBlockService

Manages tasks with blocks on the XL Deploy Server.

POST /tasks/v2//force-cancel Force-cancels stopped tasks - do a best-effort cleanup, continuing on when steps of an always-run phase fail
GET /tasks/v2/current Returns the active tasks of the logged in user.
GET /tasks/v2/current/all Returns all active tasks for all users.
GET /tasks/v2/current/all/satellite Returns all active satellite tasks for all users.
GET /tasks/v2/current/satellite Returns all active satellite tasks the logged in user.
GET /tasks/v2/export Searches for tasks with detailed step information.
GET /tasks/v2/query Searches for archived tasks without step information.
GET /tasks/v2/{taskId}/step-log/{stepPath} Returns task status by path.
GET /tasks/v2/{taskid} Returns a task by ID.
DELETE /tasks/v2/{taskid} Cancels a stopped task.
POST /tasks/v2/{taskid}/abort Aborts an active task.
POST /tasks/v2/{taskid}/add-pause/{stepPath} Add a pause step at the specified position.
POST /tasks/v2/{taskid}/archive Archive an executed task.
POST /tasks/v2/{taskid}/assign/{owner} Assigns a task to a different user.
GET /tasks/v2/{taskid}/block/{blockPath} Returns a block by ID.
GET /tasks/v2/{taskid}/block/{blockPath}/step Returns a block with steps by ID.
DELETE /tasks/v2/{taskid}/force Force-cancels a stopped task - do a best-effort cleanup, continuing on when steps of an always-run phase fail
POST /tasks/v2/{taskid}/schedule Schedules a task.
POST /tasks/v2/{taskid}/skip Indicates that one or more steps should be skipped.
POST /tasks/v2/{taskid}/start Starts a task.
GET /tasks/v2/{taskid}/status/{path} Returns task status by path.
GET /tasks/v2/{taskid}/step/{stepPath} Retrieves information about a step.
POST /tasks/v2/{taskid}/stop Gracefully stops an active task.
POST /tasks/v2/{taskid}/takeover/{owner} Takeover a task from the owner.
POST /tasks/v2/{taskid}/unskip Indicates that one or more steps should no longer be skipped, but executed.

POST /tasks/v2//force-cancel

Force-cancels stopped tasks - do a best-effort cleanup, continuing on when steps of an always-run phase fail
Permissions
Available - only to admin
Parameters
Request body application/xml List of String the IDs of the tasks
Response body
Empty

GET /tasks/v2/current

Returns the active tasks of the logged in user. By default returns full tasks, but summary mode should be preferred for performance.
Parameters
Query fetchMode FetchMode whether to strip block data for tasks or to do a full fetch
Response body
List of TaskWithBlock - a list of tasks with blocks.
Content type: application/xml

GET /tasks/v2/current/all

Returns all active tasks for all users. Only allowed for admin. By default returns full tasks, but summary mode should be preferred for performance.
Parameters
Query fetchMode FetchMode whether to strip block data for tasks or to do a full fetch
Response body
List of TaskWithBlock - a list of tasks with blocks.
Content type: application/xml

GET /tasks/v2/current/all/satellite

Returns all active satellite tasks for all users. Only allowed for admin. By default returns full tasks, but summary mode should be preferred for performance.
Parameters
Query satelliteId String the ID of the satellite where task will be executed
Query fetchMode FetchMode whether to strip block data for tasks or to do a full fetch
Response body
List of TaskWithBlock - a list of tasks with blocks.
Content type: application/xml

GET /tasks/v2/current/satellite

Returns all active satellite tasks the logged in user. By default returns full tasks, but summary mode should be preferred for performance.
Parameters
Query satelliteId String the ID of the satellite where task will be executed
Query fetchMode FetchMode whether to strip block data for tasks or to do a full fetch
Response body
List of TaskWithBlock - a list of tasks with blocks.
Content type: application/xml

GET /tasks/v2/export

Searches for tasks with detailed step information.
Permissions
report#view
Parameters
Query begindate LocalDate The first day we want to see tasks from, or null for no such limit.
Query enddate LocalDate The last day we want to see tasks from, or null for no such limit.
Request body application/xml Paging Paging paging parameters to fetch tasks page by page.
Response body
Stream of TaskWithBlock - a list of tasks limited to maximum of value of deploy.server.rest.api.maxPageSize per page. response header X-Total-Count determines the total number of tasks.
Content type: application/xml

GET /tasks/v2/query

Searches for archived tasks without step information.
Permissions
report#view
Parameters
Query begindate LocalDate The first day we want to see tasks from, or null for no such limit.
Query enddate LocalDate The last day we want to see tasks from, or null for no such limit.
Request body application/xml Paging Paging paging parameters to fetch tasks page by page.
Response body
Stream of TaskWithBlock - a list of tasks limited to maximum of value of deploy.server.rest.api.maxPageSize per page. response header X-Total-Count determines the total number of tasks.
Content type: application/xml

GET /tasks/v2/{taskId}/step-log/{stepPath}

Returns task status by path.
Parameters
Path taskId String the ID of the task
Path stepPath String the path of the step
Response body
TaskStepLog - the block.
Content type: application/xml

GET /tasks/v2/{taskid}

Returns a task by ID.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Response body
TaskWithBlock - the task with blocks.
Content type: application/xml

DELETE /tasks/v2/{taskid}

Cancels a stopped task.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Response body
Empty

POST /tasks/v2/{taskid}/abort

Aborts an active task.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Response body
Empty

POST /tasks/v2/{taskid}/add-pause/{stepPath}

Add a pause step at the specified position.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Path stepPath String the path of the step
Response body
StepBlockState - a task with full step information.
Content type: application/xml

POST /tasks/v2/{taskid}/archive

Archive an executed task.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Response body
Empty

POST /tasks/v2/{taskid}/assign/{owner}

Assigns a task to a different user.
Permissions
task#assign
Parameters
Path taskid String the ID of the task
Path owner String the name of the user that will be the new owner of the task.
Response body
TaskWithBlock - the task.
Content type: application/xml

GET /tasks/v2/{taskid}/block/{blockPath}

Returns a block by ID.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Path blockPath String the ID of the block
Response body
BlockState - the block.
Content type: application/xml

GET /tasks/v2/{taskid}/block/{blockPath}/step

Returns a block with steps by ID.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Path blockPath String the ID of the block
Response body
StepBlockState - the block with steps.
Content type: application/xml

DELETE /tasks/v2/{taskid}/force

Force-cancels a stopped task - do a best-effort cleanup, continuing on when steps of an always-run phase fail
Permissions
Available - only to admin
Parameters
Path taskid String the ID of the task
Response body
Empty

POST /tasks/v2/{taskid}/schedule

Schedules a task.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Query time DateTime the local time (including the local timezone) when the task should be started by the server.
Response body
Empty

POST /tasks/v2/{taskid}/skip

Indicates that one or more steps should be skipped.
Permissions
task#skip_step
Parameters
Path taskid String the ID of the task
Request body application/xml List of String the paths of the steps to skip
Response body
TaskWithBlock - a task
Content type: application/xml

POST /tasks/v2/{taskid}/start

Starts a task.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Response body
Empty

GET /tasks/v2/{taskid}/status/{path}

Returns task status by path.
Parameters
Path taskid String the ID of the task
Path path String path
Response body
TaskPathStatus - the block.
Content type: application/xml

GET /tasks/v2/{taskid}/step/{stepPath}

Retrieves information about a step. The call returns a response with status code of 304 (Not Modified) if the step has not been modified since ifModifiedSince , otherwise returns a status code of 200 (OK) and the XML containing a StepState.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Path stepPath String the path of the step in the block tree.
Header If-Modified-Since DateTime the if-modified-since date in RFC 1123 (RFC 822 with 4-digit years) date format.
Response body
StepState - XML containing a StepState if the step has not been modified since ifModifiedSince
Content type: application/xml

POST /tasks/v2/{taskid}/stop

Gracefully stops an active task.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Response body
Empty

POST /tasks/v2/{taskid}/takeover/{owner}

Takeover a task from the owner. This will re-assign the task to your logged in user. This is the reverse of the #assign(String, String) method, which allows you to re-assign a task.
Permissions
task#takeover
Parameters
Path taskid String the ID of the task to take over
Path owner String the current owner of the task
Response body
TaskWithBlock - the task you took over.
Content type: application/xml

POST /tasks/v2/{taskid}/unskip

Indicates that one or more steps should no longer be skipped, but executed.
Permissions
task#skip_step
Parameters
Path taskid String the ID of the task
Request body application/xml List of String the paths of the steps to unskip
Response body
TaskWithBlock - a task
Content type: application/xml