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.