GET /katello/api/host_collections/:id
显示主机集合

参数

参数名字 描述
id
必填

主机集合 Id

Validations:

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


GET /katello/api/host_collections
列出主机集合

GET /katello/api/organizations/:organization_id/host_collections
列出机构中的主机集合

GET /katello/api/activation_keys/:activation_key_id/host_collections
列出激活码中的主机集合

参数

参数名字 描述
search
选填

搜索字符串

Validations:

  • String

page
选填

页号,从 1 开始

Validations:

  • number.

per_page
选填

每页中显示的返回结果数

Validations:

  • number.

order
选填

排序字段及顺序,例如:'name DESC'

Validations:

  • String

full_results
选填

无论如何显示所有结果

Validations:

  • boolean

sort
选填

'order' 参数的哈希版本

Validations:

  • Hash

sort[by]
选填

结果排序字段

Validations:

  • String

sort[order]
选填

如何对分类结果进行排序(例如:ASC 代表升序)

Validations:

  • String

organization_id
选填

机构识别符

Validations:

  • number.

name
选填

根据其进行过滤的主机集合名称

Validations:

  • String

activation_key_id
选填

激活码识别符

Validations:

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

host_id
选填

根据主机 id 过滤产品

Validations:

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

available_for
选填

解析指定对象,以便只返回包含与指定对象关联的主机集合。支持值 'host'。

Validations:

  • String


POST /katello/api/host_collections
创建主机集合

POST /katello/api/organizations/:organization_id/host_collections
创建主机集合

参数

参数名字 描述
organization_id
必填

机构识别符

Validations:

  • number.

name
必填

主机集合名称

Validations:

  • String

description
选填

Validations:

  • String

host_ids
选填

用来替换主机集合中主机的主机 id 列表

Validations:

  • Must be an array of any type

max_hosts
选填

该主机集合中的主机集合数上限

Validations:

  • Integer

unlimited_hosts
选填

该主机集合是否包含无限台主机

Validations:

  • boolean


PUT /katello/api/host_collections/:id
更新主机集合

参数

参数名字 描述
id
必填

主机集合 Id

Validations:

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

name
选填

主机集合名称

Validations:

  • String

description
选填

Validations:

  • String

host_ids
选填

用来替换主机集合中主机的主机 id 列表

Validations:

  • Must be an array of any type

max_hosts
选填

该主机集合中的主机集合数上限

Validations:

  • Integer

unlimited_hosts
选填

该主机集合是否包含无限台主机

Validations:

  • boolean


PUT /katello/api/host_collections/:id/add_hosts
在主机集合中添加主机

参数

参数名字 描述
id
必填

主机集合 Id

Validations:

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

host_ids
选填

主机 id 阵列

Validations:

  • Must be an array of any type


PUT /katello/api/host_collections/:id/remove_hosts
从主机集合中删除主机

参数

参数名字 描述
id
必填

主机集合 Id

Validations:

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

host_ids
选填

主机 id 阵列

Validations:

  • Must be an array of any type


DELETE /katello/api/host_collections/:id
消除主机集合

参数

参数名字 描述
id
必填

主机集合 Id

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
复制主机集合

参数

参数名字 描述
id
必填

主机集合 ID

Validations:

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

name
必填

新主机集合名称

Validations:

  • String