POST /api/hosts/bulk/available_incremental_updates
Given a set of hosts and errata, lists the content view versions and environments that need updating.

Examples

POST /api/hosts/bulk/available_incremental_updates
{
  "included": {
    "ids": [
      980191233
    ]
  },
  "organization_id": 114267492,
  "errata_ids": [
    "RHSA-1999-1231"
  ],
  "hosts_bulk_action": {
    "included": {
      "ids": [
        980191233
      ]
    },
    "organization_id": 114267492,
    "errata_ids": [
      "RHSA-1999-1231"
    ]
  }
}
200
[
  {
    "next_version": "2.1",
    "content_host_count": 1,
    "content_view_version": {
      "name": "Published LIbrary view 2.0",
      "id": 111397700,
      "version": "2.0",
      "content_view": {
        "id": 405955044,
        "name": "Published LIbrary view",
        "label": "published_library_view"
      }
    },
    "environments": [
      {
        "name": "Library",
        "id": 562075838
      }
    ],
    "components": null
  }
]

Params

Param name Description
organization_id
required

ID of the organization

Validations:

  • Must be a number.
included
required

Validations:

  • Hash
included[search]
optional , nil allowed

Search string for hosts to perform an action on

Validations:

  • String
included[ids]
optional , nil allowed

List of host ids to perform an action on

Validations:

  • Must be an array of any type
excluded
required

Validations:

  • Hash
excluded[ids]
optional , nil allowed

List of host ids to exclude and not run an action on

Validations:

  • Must be an array of any type
errata_ids
required

List of Errata ids

Validations:

  • Must be an array of any type