Foreman tasks

>>>

GET /foreman_tasks/api/tasks/summary
Show task summary

>>>

GET /foreman_tasks/api/tasks/:id
Show task details

Params

Param name Description
id
optional

UUID of the task

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.
>>>

POST /foreman_tasks/api/tasks/bulk_search
List dynflow tasks for uuids

For every search it returns the list of tasks that satisfty the condition. The reason for supporting multiple searches is the UI that might be ending needing periodic updates on task status for various searches at the same time. This way, it is possible to get all the task statuses with one request.

Params

Param name Description
searches
optional

List of uuids to fetch info about

Validations:

  • Must be an Array of nested elements
searches[search_id]
optional

Arbitraty value for client to identify the the request parts with results. It's passed in the results to be able to pair the requests and responses properly.

Validations:

  • Must be a String
searches[type]
optional

Validations:

  • Must be one of: user, resource, task.
searches[task_id]
optional

In case :type = 'task', find the task by the uuid

Validations:

  • Must be a String
searches[user_id]
optional

In case :type = 'user', find tasks for the user

Validations:

  • Must be a String
searches[resource_type]
optional

In case :type = 'resource', what resource type we're searching the tasks for

Validations:

  • Must be a String
searches[resource_type]
optional

In case :type = 'resource', what resource id we're searching the tasks for

Validations:

  • Must be a String
searches[action_types]
optional

Return just tasks of given action type, e.g. [“Actions::Katello::Repository::Synchronize”]

Validations:

  • Must be one of: String.
searches[active_only]
optional

Validations:

  • Must be one of: true, false, 1, 0
searches[page]
optional

Validations:

  • Must be a String
searches[per_page]
optional

Validations:

  • Must be a String
>>>

POST /foreman_tasks/api/tasks/bulk_resume
Resume all paused error tasks

Params

Param name Description
search
optional

Resume tasks matching search string

Validations:

  • Must be a String
task_ids
optional

Resume specific tasks by ID

Validations:

  • Must be an array of any type
>>>

GET /foreman_tasks/api/tasks
List tasks

Params

Param name Description
search
optional

Search string

Validations:

  • Must be a String
page
optional

Page number, starting at 1

Validations:

  • Must be a number.
per_page
optional

Number of results per page to return

Validations:

  • Must be a number.
order
optional

Sort field and order, e.g. 'name DESC'

Validations:

  • Must be a String
sort
optional

Hash version of 'order' param

Validations:

  • Must be a Hash
sort[by]
optional

Field to sort the results on

Validations:

  • Must be a String
sort[order]
optional

How to order the sorted results (e.g. ASC for ascending)

Validations:

  • Must be a String
>>>

POST /foreman_tasks/api/tasks/callback
Send data to the task from external executor (such as smart_proxy_dynflow)

Params

Param name Description
callback
optional

Validations:

  • Must be a Hash
callback[task_id]
optional

UUID of the task

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.
callback[step_id]
optional

The ID of the step inside the execution plan to send the event to

Validations:

  • Must be a String
data
optional

Data to be sent to the action

Validations:

  • Must be a Hash