GET /api/hostgroups
Elenca tutti i gruppi di host

GET /api/puppetclasses/:puppetclass_id/hostgroups
Elenca tutti i gruppi di host per una classe del puppet

GET /api/locations/:location_id/hostgroups
Elenca tutti i gruppi di host per posizione

GET /api/organizations/:organization_id/hostgroups
Elenca tutti i gruppi di host per organizzazione

Parametri

Nome parametro Descrizione
puppetclass_id
opzionale

ID della classe del puppet

Validations:

  • Must be a String

location_id
opzionale

Scopo per posizioni

Validations:

  • Must be a Integer

organization_id
opzionale

Scopo per organizzazioni

Validations:

  • Must be a Integer

search
opzionale

filtra i risultati

Validations:

  • Must be a String

order
opzionale

ordina risultati

Validations:

  • Must be a String

page
opzionale

paginazione risultati

Validations:

  • Must be a String

per_page
opzionale

numero di voci per richiesta

Validations:

  • Must be a String

include
opzionale

Array of extra information types to include

Validations:

  • Must be an array of [“parameters”]


GET /api/hostgroups/:id
Mostra un gruppo di host

Parametri

Nome parametro Descrizione
id
richiesto

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
opzionale

Display hidden parameter values

Validations:

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


POST /api/hostgroups
Crea un gruppo di host

Parametri

Nome parametro Descrizione
hostgroup
richiesto

Validations:

  • Must be a Hash

hostgroup[name]
richiesto

Name of the host group

Validations:

  • Must be a String

hostgroup[description]
opzionale , consentito nil

Host group description

Validations:

  • Must be a String

hostgroup[parent_id]
opzionale , consentito nil

Parent ID of the host group

Validations:

  • Must be a number.

hostgroup[environment_id]
opzionale , consentito nil

Environment ID

Validations:

  • Must be a number.

hostgroup[compute_profile_id]
opzionale , consentito nil

Compute profile ID

Validations:

  • Must be a number.

hostgroup[operatingsystem_id]
opzionale , consentito nil

Operating system ID

Validations:

  • Must be a number.

hostgroup[architecture_id]
opzionale , consentito nil

Architecture ID

Validations:

  • Must be a number.

hostgroup[pxe_loader]
opzionale , consentito nil

DHCP filename option (Grub2/PXELinux by default)

Validations:

  • Must be one of: None, PXELinux BIOS, PXELinux UEFI, Grub UEFI, Grub2 UEFI, Grub2 UEFI SecureBoot.

hostgroup[medium_id]
opzionale , consentito nil

Media ID

Validations:

  • Must be a number.

hostgroup[ptable_id]
opzionale , consentito nil

Partition table ID

Validations:

  • Must be a number.

hostgroup[subnet_id]
opzionale , consentito nil

Subnet ID

Validations:

  • Must be a number.

hostgroup[domain_id]
opzionale , consentito nil

Domain ID

Validations:

  • Must be a number.

hostgroup[realm_id]
opzionale , consentito nil

Realm ID

Validations:

  • Must be a number.

hostgroup[config_group_ids]
opzionale , consentito nil

IDs of associated config groups

Validations:

  • Must be an array of any type

hostgroup[group_parameters_attributes]
opzionale , consentito nil

Array of parameters

Validations:

  • Must be an Array of nested elements

hostgroup[group_parameters_attributes][name]
richiesto

Name of the parameter

Validations:

  • Must be a String

hostgroup[group_parameters_attributes][value]
richiesto

Parameter value

Validations:

  • Must be a String

hostgroup[puppet_proxy_id]
opzionale , consentito nil

Puppet proxy ID

Validations:

  • Must be a number.

hostgroup[puppet_ca_proxy_id]
opzionale , consentito nil

Puppet CA proxy ID

Validations:

  • Must be a number.

hostgroup[root_pass]
opzionale , consentito nil

Root password on provisioned hosts

Validations:

  • Must be a String

hostgroup[location_ids]
opzionale , consentito nil

SOSTITUIRE le posizioni con gli id dati

Validations:

  • Must be an array of any type

hostgroup[organization_ids]
opzionale , consentito nil

SOSTITUIRE le organizzazioni con gli id dati

Validations:

  • Must be an array of any type


PUT /api/hostgroups/:id
Aggiorna un gruppo di host

Parametri

Nome parametro Descrizione
id
richiesto

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
richiesto

Validations:

  • Must be a Hash

hostgroup[name]
opzionale

Name of the host group

Validations:

  • Must be a String

hostgroup[description]
opzionale , consentito nil

Host group description

Validations:

  • Must be a String

hostgroup[parent_id]
opzionale , consentito nil

Parent ID of the host group

Validations:

  • Must be a number.

hostgroup[environment_id]
opzionale , consentito nil

Environment ID

Validations:

  • Must be a number.

hostgroup[compute_profile_id]
opzionale , consentito nil

Compute profile ID

Validations:

  • Must be a number.

hostgroup[operatingsystem_id]
opzionale , consentito nil

Operating system ID

Validations:

  • Must be a number.

hostgroup[architecture_id]
opzionale , consentito nil

Architecture ID

Validations:

  • Must be a number.

hostgroup[pxe_loader]
opzionale , consentito nil

DHCP filename option (Grub2/PXELinux by default)

Validations:

  • Must be one of: None, PXELinux BIOS, PXELinux UEFI, Grub UEFI, Grub2 UEFI, Grub2 UEFI SecureBoot.

hostgroup[medium_id]
opzionale , consentito nil

Media ID

Validations:

  • Must be a number.

hostgroup[ptable_id]
opzionale , consentito nil

Partition table ID

Validations:

  • Must be a number.

hostgroup[subnet_id]
opzionale , consentito nil

Subnet ID

Validations:

  • Must be a number.

hostgroup[domain_id]
opzionale , consentito nil

Domain ID

Validations:

  • Must be a number.

hostgroup[realm_id]
opzionale , consentito nil

Realm ID

Validations:

  • Must be a number.

hostgroup[config_group_ids]
opzionale , consentito nil

IDs of associated config groups

Validations:

  • Must be an array of any type

hostgroup[group_parameters_attributes]
opzionale , consentito nil

Array of parameters

Validations:

  • Must be an Array of nested elements

hostgroup[group_parameters_attributes][name]
opzionale

Name of the parameter

Validations:

  • Must be a String

hostgroup[group_parameters_attributes][value]
opzionale

Parameter value

Validations:

  • Must be a String

hostgroup[puppet_proxy_id]
opzionale , consentito nil

Puppet proxy ID

Validations:

  • Must be a number.

hostgroup[puppet_ca_proxy_id]
opzionale , consentito nil

Puppet CA proxy ID

Validations:

  • Must be a number.

hostgroup[root_pass]
opzionale , consentito nil

Root password on provisioned hosts

Validations:

  • Must be a String

hostgroup[location_ids]
opzionale , consentito nil

SOSTITUIRE le posizioni con gli id dati

Validations:

  • Must be an array of any type

hostgroup[organization_ids]
opzionale , consentito nil

SOSTITUIRE le organizzazioni con gli id dati

Validations:

  • Must be an array of any type


DELETE /api/hostgroups/:id
Cancella un gruppo di host

Parametri

Nome parametro Descrizione
id
richiesto

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
Clona un gruppo di host

Parametri

Nome parametro Descrizione
name
richiesto

Validations:

  • Must be a String


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

Parametri

Nome parametro Descrizione
id
richiesto

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
opzionale

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

Validations:

  • Must be an array of any type

children_hosts
opzionale

Operate on child hostgroup hosts

Validations:

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