GET /api/hostgroups
列出所有主机组

GET /api/puppetclasses/:puppetclass_id/hostgroups
列出 Puppet 类别的所有主机组

GET /api/locations/:location_id/hostgroups
列出每个位置的所有主机组

GET /api/organizations/:organization_id/hostgroups
列出每个机构的所有主机组

参数

参数名字 描述
puppetclass_id
选填

Puppet 类别 ID

Validations:

  • String

location_id
选填

根据位置界定的范围

Validations:

  • Integer

organization_id
选填

根据机构界定的范围

Validations:

  • Integer

search
选填

过滤结果

Validations:

  • String

order
选填

结果排序

Validations:

  • String

page
选填

编页结果

Validations:

  • String

per_page
选填

每个请求中的条目数

Validations:

  • String


GET /api/hostgroups/:id
显示主机组

参数

参数名字 描述
id
必填

Validations:

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


POST /api/hostgroups
创建主机组

参数

参数名字 描述
hostgroup
必填

Validations:

  • Hash

hostgroup[name]
必填

Validations:

  • String

hostgroup[parent_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[environment_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[operatingsystem_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[architecture_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[medium_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[ptable_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[puppet_ca_proxy_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[subnet_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[domain_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[realm_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[puppet_proxy_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[content_source_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[content_view_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[lifecycle_environment_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[location_ids]
选填 , 允许空值

使用给定 id 替换位置

Validations:

  • Must be an array of any type

hostgroup[organization_ids]
选填 , 允许空值

使用给定 id 替换机构

Validations:

  • Must be an array of any type


PUT /api/hostgroups/:id
更新主机组

参数

参数名字 描述
id
必填

Validations:

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

hostgroup
必填

Validations:

  • Hash

hostgroup[name]
选填

Validations:

  • String

hostgroup[parent_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[environment_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[operatingsystem_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[architecture_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[medium_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[ptable_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[puppet_ca_proxy_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[subnet_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[domain_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[realm_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[puppet_proxy_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[content_source_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[content_view_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[lifecycle_environment_id]
选填 , 允许空值

Validations:

  • number.

hostgroup[location_ids]
选填 , 允许空值

使用给定 id 替换位置

Validations:

  • Must be an array of any type

hostgroup[organization_ids]
选填 , 允许空值

使用给定 id 替换机构

Validations:

  • Must be an array of any type


DELETE /api/hostgroups/:id
删除主机组

参数

参数名字 描述
id
必填

Validations:

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


POST /api/hostgroups/:id/clone
克隆主机组

参数

参数名字 描述
name
必填

Validations:

  • String