Examples

POST /katello/api/organizations/114267492/host_collections
{
  "name": "Collection A",
  "description": "Collection A, World Cup 2014",
  "host_ids": [
    980190992
  ],
  "unlimited_hosts": true,
  "host_collection": {
    "name": "Collection A",
    "description": "Collection A, World Cup 2014",
    "unlimited_hosts": true,
    "host_ids": [
      980190992
    ]
  }
}
201
{
  "host_ids": [
    980190992
  ],
  "name": "Collection A",
  "organization_id": 114267492,
  "max_hosts": null,
  "description": "Collection A, World Cup 2014",
  "total_hosts": 1,
  "unlimited_hosts": true,
  "created_at": "2024-02-22 18:24:04 UTC",
  "updated_at": "2024-02-22 18:24:04 UTC",
  "id": 1031461453,
  "permissions": {
    "deletable": true,
    "editable": true
  }
}

Params

Param name Description
organization_id
required

organization identifier

Validations:

  • Must be a 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:

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