Host errata

>>>

GET /api/hosts/:host_id/errata
List errata available for the content host

Params

Param name Description
host_id
required

UUID of the content host

Validations:

  • Must be a number.
content_view_id
optional

Calculate Applicable Errata based on a particular Content View

Validations:

  • Must be a number.
environment_id
optional

Calculate Applicable Errata based on a particular Environment

Validations:

  • Must be a number.
search
optional

Search string

Validations:

  • 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, eg. ‘id DESC’

Validations:

  • String
full_result
optional

Whether or not to show all results

Validations:

  • Must be one of: true, false, 1, 0.
sort_by
optional

Field to sort the results on

Validations:

  • String
sort_order
optional

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

Validations:

  • String
>>>

PUT /api/hosts/:host_id/errata/apply
Schedule errata for installation

Params

Param name Description
host_id
required

Host ID

Validations:

  • Must be a number.
errata_ids
optional

List of Errata ids to install

Validations:

  • Must be an array of any type
included
required

Errata to exclusively include in the action

Validations:

  • Hash
included[search]
optional , nil allowed

Search string for erratum to perform an action on

Validations:

  • String
included[ids]
optional , nil allowed

List of errata ids to perform an action on, (ex: RHSA-2019:1168)

Validations:

  • Must be an array of any type
excluded
required

Errata to explicitly exclude in the action. All other applicable errata will be included in the action, unless an included parameter is passed as well.

Validations:

  • Hash
excluded[ids]
optional , nil allowed

List of errata ids to exclude and not run an action on, (ex: RHSA-2019:1168)

Validations:

  • Must be an array of any type
>>>

GET /api/hosts/:host_id/errata/:id
Retrieve a single errata for a host

Params

Param name Description
host_id
required

Host ID

Validations:

  • Must be a number.
id
required

Errata id of the erratum (RHSA-2012:108)

Validations:

  • String
>>>

PUT /api/hosts/:host_id/errata/applicability
Force regenerate applicability.

Params

Param name Description
host_id
required

Host ID

Validations:

  • Must be a number.