GET /katello/api/host_collections/:id
Show a host collection

Params

Param Name Description
id
Required

Id of the host collection

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..


GET /katello/api/host_collections
List host collections

GET /katello/api/organizations/:organization_id/host_collections
List host collections within an organization

GET /katello/api/activation_keys/:activation_key_id/host_collections
List host collections in an activation key

Params

Param Name Description
search
Optional

Search string

Validations:

  • String

page
Optional

Page number, starting at 1

Validations:

  • number.

per_page
Optional

Number of results per page to return

Validations:

  • number.

order
Optional

Sort field and order, eg. 'name DESC'

Validations:

  • String

full_results
Optional

Whether or not to show all results

Validations:

  • boolean

sort
Optional

Hash version of 'order' param

Validations:

  • Hash

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

organization_id
Optional

organization identifier

Validations:

  • number.

name
Optional

host collection name to filter by

Validations:

  • String

activation_key_id
Optional

activation key identifier

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..

host_id
Optional

Filter products by host id

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..

available_for
Optional

Interpret specified object to return only Host Collections that can be associated with specified object. The value 'host' is supported.

Validations:

  • String


POST /katello/api/host_collections
Create a host collection

POST /katello/api/organizations/:organization_id/host_collections
Create a host collection

Params

Param Name Description
organization_id
Required

organization identifier

Validations:

  • number.

name
Required

Host Collection name

Validations:

  • String

description
Optional

Validations:

  • String

host_ids
Optional

List of host ids to replace the hosts in host collection

Validations:

  • Must be an array of any type

max_hosts
Optional

Maximum number of hosts in the host collection

Validations:

  • Integer

unlimited_hosts
Optional

Whether or not the host collection may have unlimited hosts

Validations:

  • boolean


PUT /katello/api/host_collections/:id
Update a host collection

Params

Param Name Description
id
Required

Id of the host collection

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..

name
Optional

Host Collection name

Validations:

  • String

description
Optional

Validations:

  • String

host_ids
Optional

List of host ids to replace the hosts in host collection

Validations:

  • Must be an array of any type

max_hosts
Optional

Maximum number of hosts in the host collection

Validations:

  • Integer

unlimited_hosts
Optional

Whether or not the host collection may have unlimited hosts

Validations:

  • boolean


PUT /katello/api/host_collections/:id/add_hosts
Add host to the host collection

Params

Param Name Description
id
Required

Id of the host collection

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..

host_ids
Optional

Array of host ids

Validations:

  • Must be an array of any type


PUT /katello/api/host_collections/:id/remove_hosts
Remove hosts from the host collection

Params

Param Name Description
id
Required

Id of the host collection

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..

host_ids
Optional

Array of host ids

Validations:

  • Must be an array of any type


DELETE /katello/api/host_collections/:id
Destroy a host collection

Params

Param Name Description
id
Required

Id of the host collection

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..


POST /katello/api/host_collections/:id/copy
Make copy of a host collection

Params

Param Name Description
id
Required

ID of the host collection

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..

name
Required

New host collection name

Validations:

  • String