Examples

PUT /api/hostgroups/636252244-Common
{
  "hostgroup": {
    "name": "TestHostgroup"
  }
}
200
{
  "subnet_id": null,
  "subnet_name": null,
  "operatingsystem_id": 309172073,
  "operatingsystem_name": "centos 5.3",
  "domain_id": 22495316,
  "domain_name": "mydomain.net",
  "environment_id": 334344675,
  "environment_name": "production",
  "compute_profile_id": 980190962,
  "compute_profile_name": "1-Small",
  "ancestry": null,
  "parent_id": null,
  "parent_name": null,
  "ptable_id": null,
  "ptable_name": null,
  "medium_id": 980190962,
  "medium_name": "CentOS 5.4",
  "pxe_loader": null,
  "subnet6_id": null,
  "subnet6_name": null,
  "compute_resource_id": null,
  "compute_resource_name": null,
  "architecture_id": 501905019,
  "architecture_name": "x86_64",
  "realm_id": null,
  "realm_name": null,
  "created_at": "2020-05-20 13:24:30 UTC",
  "updated_at": "2020-05-20 13:24:33 UTC",
  "id": 636252244,
  "name": "TestHostgroup",
  "title": "TestHostgroup",
  "description": null,
  "puppet_proxy_id": 182953976,
  "puppet_proxy_name": "Puppetmaster Proxy",
  "puppet_ca_proxy_id": 182953976,
  "puppet_ca_proxy_name": "Puppetmaster Proxy",
  "puppet_proxy": {
    "name": "Puppetmaster Proxy",
    "id": 182953976,
    "url": "http://else.where:4567"
  },
  "puppet_ca_proxy": {
    "name": "Puppetmaster Proxy",
    "id": 182953976,
    "url": "http://else.where:4567"
  },
  "inherited_compute_profile_id": null,
  "inherited_environment_id": null,
  "inherited_domain_id": null,
  "inherited_puppet_proxy_id": null,
  "inherited_puppet_ca_proxy_id": null,
  "inherited_compute_resource_id": null,
  "inherited_operatingsystem_id": null,
  "inherited_architecture_id": null,
  "inherited_medium_id": null,
  "inherited_ptable_id": null,
  "inherited_subnet_id": null,
  "inherited_subnet6_id": null,
  "inherited_realm_id": null,
  "inherited_pxe_loader": null,
  "parameters": [
    {
      "priority": null,
      "created_at": "2020-05-20 13:24:30 UTC",
      "updated_at": "2020-05-20 13:24:30 UTC",
      "id": 767575238,
      "name": "group1",
      "parameter_type": "string",
      "value": "group1"
    }
  ],
  "template_combinations": [
    {
      "id": 980190962,
      "provisioning_template_id": 943779058,
      "provisioning_template_name": "MyString",
      "hostgroup_id": 636252244,
      "hostgroup_name": "TestHostgroup",
      "environment_id": 334344675,
      "environment_name": "production"
    },
    {
      "id": 281110143,
      "provisioning_template_id": 269958254,
      "provisioning_template_name": "MyString2",
      "hostgroup_id": 636252244,
      "hostgroup_name": "TestHostgroup",
      "environment_id": 334344675,
      "environment_name": "production"
    },
    {
      "id": 1018350795,
      "provisioning_template_id": 981457253,
      "provisioning_template_name": "MyScript",
      "hostgroup_id": 636252244,
      "hostgroup_name": "TestHostgroup",
      "environment_id": 334344675,
      "environment_name": "production"
    }
  ],
  "puppetclasses": [
    {
      "id": 980190962,
      "name": "base",
      "module_name": "base"
    }
  ],
  "config_groups": [
    {
      "created_at": "2020-05-20 13:24:30 UTC",
      "updated_at": "2020-05-20 13:24:30 UTC",
      "id": 980190962,
      "name": "Monitoring",
      "puppetclasses": [
        {
          "id": 51848956,
          "name": "chkmk",
          "module_name": "chkmk"
        },
        {
          "id": 1018350795,
          "name": "nagios",
          "module_name": "nagios"
        }
      ]
    },
    {
      "created_at": "2020-05-20 13:24:30 UTC",
      "updated_at": "2020-05-20 13:24:30 UTC",
      "id": 113629430,
      "name": "Tools",
      "puppetclasses": [
        {
          "id": 113629430,
          "name": "git",
          "module_name": "git"
        },
        {
          "id": 281110143,
          "name": "vim",
          "module_name": "vim"
        }
      ]
    }
  ],
  "all_puppetclasses": [
    {
      "id": 980190962,
      "name": "base",
      "module_name": "base"
    },
    {
      "id": 51848956,
      "name": "chkmk",
      "module_name": "chkmk"
    },
    {
      "id": 1018350795,
      "name": "nagios",
      "module_name": "nagios"
    },
    {
      "id": 281110143,
      "name": "vim",
      "module_name": "vim"
    }
  ],
  "locations": [
    {
      "id": 255093256,
      "name": "Location 1",
      "title": "Location 1",
      "description": null
    }
  ],
  "organizations": [
    {
      "id": 447626438,
      "name": "Organization 1",
      "title": "Organization 1",
      "description": null
    }
  ]
}

Params

Param name Description
location_id
optional

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
optional

Set the current organization context for the request

Validations:

  • Must be a Integer

id
required

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.

hostgroup
required

Validations:

  • Must be a Hash

hostgroup[name]
optional

Name of the host group

Validations:

  • Must be a String

hostgroup[description]
optional , nil allowed

Host group description

Validations:

  • Must be a String

hostgroup[parent_id]
optional , nil allowed

Parent ID of the host group

Validations:

  • Must be a number.

hostgroup[environment_id]
optional , nil allowed

Environment ID

Validations:

  • Must be a number.

hostgroup[compute_profile_id]
optional , nil allowed

Compute profile ID

Validations:

  • Must be a number.

hostgroup[compute_resource_id]
optional , nil allowed

Compute resource ID

Validations:

  • Must be a number.

hostgroup[operatingsystem_id]
optional , nil allowed

Operating system ID

Validations:

  • Must be a number.

hostgroup[architecture_id]
optional , nil allowed

Architecture ID

Validations:

  • Must be a number.

hostgroup[pxe_loader]
optional , nil allowed

DHCP filename option (Grub2/PXELinux by default)

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]
optional , nil allowed

Media ID

Validations:

  • Must be a number.

hostgroup[ptable_id]
optional , nil allowed

Partition table ID

Validations:

  • Must be a number.

hostgroup[subnet_id]
optional , nil allowed

Subnet ID

Validations:

  • Must be a number.

hostgroup[subnet6_id]
optional , nil allowed

Subnet IPv6 ID

Validations:

  • Must be a number.

hostgroup[domain_id]
optional , nil allowed

Domain ID

Validations:

  • Must be a number.

hostgroup[realm_id]
optional , nil allowed

Realm ID

Validations:

  • Must be a number.

hostgroup[puppetclass_ids]
optional , nil allowed

Validations:

  • Must be an array of any type

hostgroup[config_group_ids]
optional , nil allowed

IDs of associated config groups

Validations:

  • Must be an array of any type

hostgroup[group_parameters_attributes]
optional , nil allowed

Array of parameters

Validations:

  • Must be an Array of nested elements

hostgroup[group_parameters_attributes][name]
optional

Name of the parameter

Validations:

  • Must be a String

hostgroup[group_parameters_attributes][value]
optional

Parameter value

Validations:

  • Must be a String

hostgroup[group_parameters_attributes][parameter_type]
optional , nil allowed

Type of value

Validations:

  • Must be one of: string, boolean, integer, real, array, hash, yaml, json.

hostgroup[group_parameters_attributes][hidden_value]
optional , nil allowed

Validations:

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

hostgroup[puppet_proxy_id]
optional , nil allowed

Puppet proxy ID

Validations:

  • Must be a number.

hostgroup[puppet_ca_proxy_id]
optional , nil allowed

Puppet CA proxy ID

Validations:

  • Must be a number.

hostgroup[root_pass]
optional , nil allowed

Root password on provisioned hosts

Validations:

  • Must be a String

hostgroup[location_ids]
optional , nil allowed

REPLACE locations with given ids

Validations:

  • Must be an array of any type

hostgroup[organization_ids]
optional , nil allowed

REPLACE organizations with given ids.

Validations:

  • Must be an array of any type