示例

POST /api/hostgroups
{
  "hostgroup": {
    "name": "TestHostgroup"
  }
}
201
{
  "subnet_id": null,
  "subnet_name": null,
  "operatingsystem_id": null,
  "operatingsystem_name": null,
  "domain_id": null,
  "domain_name": null,
  "environment_id": null,
  "environment_name": null,
  "compute_profile_id": null,
  "compute_profile_name": null,
  "ancestry": null,
  "parent_id": null,
  "parent_name": null,
  "ptable_id": null,
  "ptable_name": null,
  "medium_id": null,
  "medium_name": null,
  "pxe_loader": null,
  "subnet6_id": null,
  "subnet6_name": null,
  "compute_resource_id": null,
  "compute_resource_name": null,
  "architecture_id": null,
  "architecture_name": null,
  "realm_id": null,
  "realm_name": null,
  "created_at": "2019-09-11 14:32:24 UTC",
  "updated_at": "2019-09-11 14:32:24 UTC",
  "id": 928644288,
  "name": "TestHostgroup",
  "title": "TestHostgroup",
  "description": null,
  "puppet_proxy_id": null,
  "puppet_proxy_name": null,
  "puppet_ca_proxy_id": null,
  "puppet_ca_proxy_name": null,
  "puppet_proxy": null,
  "puppet_ca_proxy": null,
  "parameters": [],
  "template_combinations": [],
  "puppetclasses": [],
  "config_groups": [],
  "all_puppetclasses": [],
  "locations": [],
  "organizations": []
}

参数

参数名字 描述
location_id
选填

根据位置界定的范围

Validations:

  • Must be a Integer

organization_id
选填

根据机构界定的范围

Validations:

  • Must be a Integer

hostgroup
必填

Validations:

  • Must be a Hash

hostgroup[name]
必填

主机组名称

Validations:

  • Must be a String

hostgroup[description]
选填 , 允许空值

主机组描述

Validations:

  • Must be a String

hostgroup[parent_id]
选填 , 允许空值

主机组父 ID

Validations:

  • Must be a number.

hostgroup[environment_id]
选填 , 允许空值

环境 ID

Validations:

  • Must be a number.

hostgroup[compute_profile_id]
选填 , 允许空值

计算配置文件 ID

Validations:

  • Must be a number.

hostgroup[compute_resource_id]
选填 , 允许空值

计算资源 ID

Validations:

  • Must be a number.

hostgroup[operatingsystem_id]
选填 , 允许空值

操作系统 ID

Validations:

  • Must be a number.

hostgroup[architecture_id]
选填 , 允许空值

架构 ID

Validations:

  • Must be a number.

hostgroup[pxe_loader]
选填 , 允许空值

DHCP 文件名选项(默认为 Grub2/PXELinux)

Validations:

  • Must be one of: None, PXELinux BIOS, PXELinux UEFI, Grub UEFI, Grub2 BIOS, Grub2 ELF, Grub2 UEFI, Grub2 UEFI SecureBoot, Grub2 UEFI HTTP, Grub2 UEFI HTTPS, Grub2 UEFI HTTPS SecureBoot, iPXE Embedded, iPXE UEFI HTTP, iPXE Chain BIOS, iPXE Chain UEFI.

hostgroup[medium_id]
选填 , 允许空值

介质 ID

Validations:

  • Must be a number.

hostgroup[ptable_id]
选填 , 允许空值

分区表 ID

Validations:

  • Must be a number.

hostgroup[subnet_id]
选填 , 允许空值

子网 ID

Validations:

  • Must be a number.

hostgroup[subnet6_id]
选填 , 允许空值

Subnet IPv6 ID

Validations:

  • Must be a number.

hostgroup[domain_id]
选填 , 允许空值

域 ID

Validations:

  • Must be a number.

hostgroup[realm_id]
选填 , 允许空值

范围 ID

Validations:

  • Must be a number.

hostgroup[config_group_ids]
选填 , 允许空值

关联配置组的 ID

Validations:

  • Must be an array of any type

hostgroup[group_parameters_attributes]
选填 , 允许空值

参数阵列

Validations:

  • Must be an Array of nested elements

hostgroup[group_parameters_attributes][name]
必填

参数名称

Validations:

  • Must be a String

hostgroup[group_parameters_attributes][value]
必填

参数值

Validations:

  • Must be a String

hostgroup[puppet_proxy_id]
选填 , 允许空值

Puppet 代理服务器 ID

Validations:

  • Must be a number.

hostgroup[puppet_ca_proxy_id]
选填 , 允许空值

Puppet CA 代理服务器 ID

Validations:

  • Must be a number.

hostgroup[root_pass]
选填 , 允许空值

预配主机中的 root 密码

Validations:

  • Must be a String

hostgroup[location_ids]
选填 , 允许空值

使用给定 id 替换位置

Validations:

  • Must be an array of any type

hostgroup[organization_ids]
选填 , 允许空值

使用给定 id 替换机构

Validations:

  • Must be an array of any type