GET /api/hostgroups
Vypsat všechny skupiny strojů

GET /api/puppetclasses/:puppetclass_id/hostgroups
Vypsat všechny skupiny strojů pro puppet třídu

GET /api/locations/:location_id/hostgroups
List all host groups per location

GET /api/organizations/:organization_id/hostgroups
List all host groups per organization

Params

Param name Description
puppetclass_id
optional

Identifikátor puppet třídy

Validations:

  • Must be a String

location_id
optional

Scope by locations

Validations:

  • Must be a Integer

organization_id
optional

Scope by organizations

Validations:

  • Must be a Integer

search
optional

výsledky filtru

Validations:

  • Must be a String

order
optional

Sort field and order, eg. ‘id DESC’

Validations:

  • Must be a String

page
optional

Číslo stránky, začíná od jedničky

Validations:

  • Must be a number.

per_page
optional

Počet výsledků na stránku

Validations:

  • Must be a number.

include
optional

Array of extra information types to include

Validations:

  • Must be an array of [“parameters”]

Search fields

Název kolonky Typ Možné hodnoty
architecture
class
config_group string
environment
host
id
label
location
location_id
medium
name
organization
organization_id
os
os_description
os_id
os_major
os_minor
os_title
params
template
title

GET /api/hostgroups/:id
Zobrazit skupinu strojů

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.

show_hidden_parameters
optional

Zobrazit hodnoty skrytého parametru

Validations:

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


POST /api/hostgroups
Vytvořit skupinu hostitelů

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

hostgroup
required

Validations:

  • Must be a Hash

hostgroup[name]
required

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

Identifikátor prostředí

Validations:

  • Must be a number.

hostgroup[compute_profile_id]
optional , nil allowed

Identifikátor profilu výpočetního

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

Identifikátor operačního systému

Validations:

  • Must be a number.

hostgroup[architecture_id]
optional , nil allowed

Identifikátor architektury

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

Identifikátor média

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

Identif. podsítě

Validations:

  • Must be a number.

hostgroup[subnet6_id]
optional , nil allowed

Identif. IPv6 podsítě

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

Pole parametrů

Validations:

  • Must be an Array of nested elements

hostgroup[group_parameters_attributes][name]
required

Název parametru

Validations:

  • Must be a String

hostgroup[group_parameters_attributes][value]
required

Hodnota parametru

Validations:

  • Must be a String

hostgroup[group_parameters_attributes][parameter_type]
optional , nil allowed

Typ hodnoty

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


PUT /api/hostgroups/:id
Aktualizovat skupinu strojů

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

Identifikátor prostředí

Validations:

  • Must be a number.

hostgroup[compute_profile_id]
optional , nil allowed

Identifikátor profilu výpočetního

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

Identifikátor operačního systému

Validations:

  • Must be a number.

hostgroup[architecture_id]
optional , nil allowed

Identifikátor architektury

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

Identifikátor média

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

Identif. podsítě

Validations:

  • Must be a number.

hostgroup[subnet6_id]
optional , nil allowed

Identif. IPv6 podsítě

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

Pole parametrů

Validations:

  • Must be an Array of nested elements

hostgroup[group_parameters_attributes][name]
optional

Název parametru

Validations:

  • Must be a String

hostgroup[group_parameters_attributes][value]
optional

Hodnota parametru

Validations:

  • Must be a String

hostgroup[group_parameters_attributes][parameter_type]
optional , nil allowed

Typ hodnoty

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


DELETE /api/hostgroups/:id
Smazat skupinu strojů

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.


POST /api/hostgroups/:id/clone
Clone a host group

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

name
required

Validations:

  • Must be a String


PUT /api/hostgroups/:id/rebuild_config
Rebuild orchestration config

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.

only
optional

Limit rebuild steps, valid steps are DHCP, DNS, TFTP

Validations:

  • Must be an array of any type

children_hosts
optional

Operate on child hostgroup hosts

Validations:

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