GET /api/v2/discovered_hosts
Elenca tutti gli host rilevati

Parametri

Nome parametro Descrizione
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


GET /api/v2/discovered_hosts/:id
Visualizza un host rilevato

Parametri

Nome parametro Descrizione
location_id
opzionale

Scopo per posizioni

Validations:

  • Must be a Integer

organization_id
opzionale

Scopo per organizzazioni

Validations:

  • Must be a Integer

id
richiesto

Validations:

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


POST /api/v2/discovered_hosts
Create a discovered host for testing (use /facts to create new hosts)

Parametri

Nome parametro Descrizione
location_id
opzionale

Scopo per posizioni

Validations:

  • Must be a Integer

organization_id
opzionale

Scopo per organizzazioni

Validations:

  • Must be a Integer

discovered_host
opzionale , consentito nil

Validations:

  • Must be a Hash

discovered_host[name]
richiesto

Validations:

  • Must be a String

discovered_host[ip]
richiesto

Validations:

  • Must be a String

discovered_host[mac]
richiesto

Validations:

  • Must be a String

discovered_host[pxe_loader]
opzionale , consentito nil

DHCP filename option (Grub2 or 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.


PUT /api/v2/discovered_hosts/:id
Esegui il provisioning di un host rilevato

Parametri

Nome parametro Descrizione
location_id
opzionale

Scopo per posizioni

Validations:

  • Must be a Integer

organization_id
opzionale

Scopo per organizzazioni

Validations:

  • Must be a Integer

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.

discovered_host
opzionale , consentito nil

Validations:

  • Must be a Hash

discovered_host[name]
opzionale , consentito nil

Validations:

  • Must be a String

discovered_host[environment_id]
opzionale , consentito nil

Validations:

  • Must be a String

discovered_host[ip]
opzionale , consentito nil

non necessario se si utilizza una sottorete con DHCP proxy

Validations:

  • Must be a String

discovered_host[mac]
opzionale , consentito nil

non necessario se è una macchina virtuale

Validations:

  • Must be a String

discovered_host[architecture_id]
opzionale , consentito nil

Validations:

  • Must be a number.

discovered_host[domain_id]
opzionale , consentito nil

Validations:

  • Must be a number.

discovered_host[puppet_proxy_id]
opzionale , consentito nil

Validations:

  • Must be a number.

discovered_host[puppet_class_ids]
opzionale , consentito nil

Validations:

  • Must be an array of any type

discovered_host[operatingsystem_id]
opzionale , consentito nil

Validations:

  • Must be a String

discovered_host[medium_id]
opzionale , consentito nil

Validations:

  • Must be a number.

discovered_host[ptable_id]
opzionale , consentito nil

Validations:

  • Must be a number.

discovered_host[subnet_id]
opzionale , consentito nil

Validations:

  • Must be a number.

discovered_host[sp_subnet_id]
opzionale , consentito nil

Validations:

  • Must be a number.

discovered_host[model_id]
opzionale , consentito nil

Validations:

  • Must be a number.

discovered_host[hostgroup_id]
opzionale , consentito nil

Validations:

  • Must be a number.

discovered_host[owner_id]
opzionale , consentito nil

Validations:

  • Must be a number.

discovered_host[puppet_ca_proxy_id]
opzionale , consentito nil

Validations:

  • Must be a number.

discovered_host[image_id]
opzionale , consentito nil

Validations:

  • Must be a number.

discovered_host[host_parameters_attributes]
opzionale , consentito nil

Validations:

  • Must be an array of any type

discovered_host[build]
opzionale , consentito nil

Validations:

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

discovered_host[enabled]
opzionale , consentito nil

Validations:

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

discovered_host[provision_method]
opzionale , consentito nil

Validations:

  • Must be a String

discovered_host[managed]
opzionale , consentito nil

Validations:

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

discovered_host[progress_report_id]
opzionale , consentito nil

UUID per controllare gli stati dei compiti d'orchestrazione, GET /api/orchestration/:UUID/tasks

Validations:

  • Must be a String

discovered_host[capabilities]
opzionale , consentito nil

Validations:

  • Must be a String

discovered_host[root_pass]
opzionale , consentito nil

necessario se il valore non è ereditato da un gruppo di host o password predefinita nelle impostazione

Validations:

  • Must be a String

discovered_host[pxe_loader]
opzionale , consentito nil

DHCP filename option (Grub2 or 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.


DELETE /api/v2/discovered_hosts/:id
Rimuovi un host rilevato

Parametri

Nome parametro Descrizione
location_id
opzionale

Scopo per posizioni

Validations:

  • Must be a Integer

organization_id
opzionale

Scopo per organizzazioni

Validations:

  • Must be a Integer

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/v2/discovered_hosts/facts
Carica gli eventi per un host creando, se necessario, un host

Parametri

Nome parametro Descrizione
location_id
opzionale

Scopo per posizioni

Validations:

  • Must be a Integer

organization_id
opzionale

Scopo per organizzazioni

Validations:

  • Must be a Integer

facts
richiesto

hash containing facts for the host with minimum set of facts: discovery_bootif, macaddress_eth0, ipaddress, ipaddress_eth0, interfaces: eth0 (example in case primary interface is named eth0)

Validations:

  • Must be a Hash


POST /api/v2/discovered_hosts/:id/auto_provision
Esegui le regole nei confronti di un host rilevato

Parametri

Nome parametro Descrizione
location_id
opzionale

Scopo per posizioni

Validations:

  • Must be a Integer

organization_id
opzionale

Scopo per organizzazioni

Validations:

  • Must be a Integer

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/v2/discovered_hosts/auto_provision_all
Esegui le regole nei confronti degli host attualemente rilevati

Parametri

Nome parametro Descrizione
location_id
opzionale

Scopo per posizioni

Validations:

  • Must be a Integer

organization_id
opzionale

Scopo per organizzazioni

Validations:

  • Must be a Integer


PUT /api/v2/discovered_hosts/:id/refresh_facts
Aggiornamento eventi di un host rilevato

Parametri

Nome parametro Descrizione
location_id
opzionale

Scopo per posizioni

Validations:

  • Must be a Integer

organization_id
opzionale

Scopo per organizzazioni

Validations:

  • Must be a Integer

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.


PUT /api/v2/discovered_hosts/:id/reboot
Riavvio di un host rilevato

Parametri

Nome parametro Descrizione
location_id
opzionale

Scopo per posizioni

Validations:

  • Must be a Integer

organization_id
opzionale

Scopo per organizzazioni

Validations:

  • Must be a Integer

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.


PUT /api/v2/discovered_hosts/reboot_all
Rebooting all discovered hosts

Parametri

Nome parametro Descrizione
location_id
opzionale

Scopo per posizioni

Validations:

  • Must be a Integer

organization_id
opzionale

Scopo per organizzazioni

Validations:

  • Must be a Integer