GET /api/v2/discovered_hosts
Alle entdeckten Hosts auflisten

Parameter

Parametername Beschreibung
location_id
optional

Scope nach Standorten

Validations:

  • Must be a Integer

organization_id
optional

Scope nach Organisationen

Validations:

  • Must be a Integer

search
optional

Ergebnisse filtern

Validations:

  • Must be a String

order
optional

Ergebnisse sortieren

Validations:

  • Must be a String

page
optional

Ergebnisse nummerieren

Validations:

  • Must be a String

per_page
optional

Anzahl der Einträge pro Anfrage

Validations:

  • Must be a String


GET /api/v2/discovered_hosts/:id
Entdeckten Host anzeigen

Parameter

Parametername Beschreibung
location_id
optional

Scope nach Standorten

Validations:

  • Must be a Integer

organization_id
optional

Scope nach Organisationen

Validations:

  • Must be a Integer

id
verpflichtend

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
Entdeckten Host zum Testen erstellen (verwenden Sie /Fakten zur Erstellung neuer Hosts)

Parameter

Parametername Beschreibung
location_id
optional

Scope nach Standorten

Validations:

  • Must be a Integer

organization_id
optional

Scope nach Organisationen

Validations:

  • Must be a Integer

discovered_host
optional , nil erlaubt

Validations:

  • Must be a Hash

discovered_host[name]
verpflichtend

Validations:

  • Must be a String

discovered_host[ip]
verpflichtend

Validations:

  • Must be a String

discovered_host[mac]
verpflichtend

Validations:

  • Must be a String

discovered_host[pxe_loader]
optional , nil erlaubt

DHCP-Dateinamensoption (Standardmäßig 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.


PUT /api/v2/discovered_hosts/:id
Entdeckten Host bereitstellen

Parameter

Parametername Beschreibung
location_id
optional

Scope nach Standorten

Validations:

  • Must be a Integer

organization_id
optional

Scope nach Organisationen

Validations:

  • Must be a Integer

id
verpflichtend

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
optional , nil erlaubt

Validations:

  • Must be a Hash

discovered_host[name]
optional , nil erlaubt

Validations:

  • Must be a String

discovered_host[environment_id]
optional , nil erlaubt

Validations:

  • Must be a String

discovered_host[ip]
optional , nil erlaubt

nicht erforderlich, wenn ein Subnetz mit DHCP-Proxy verwendet wird

Validations:

  • Must be a String

discovered_host[mac]
optional , nil erlaubt

nicht erforderlich für eine virtuelle Maschine

Validations:

  • Must be a String

discovered_host[architecture_id]
optional , nil erlaubt

Validations:

  • Must be a number.

discovered_host[domain_id]
optional , nil erlaubt

Validations:

  • Must be a number.

discovered_host[puppet_proxy_id]
optional , nil erlaubt

Validations:

  • Must be a number.

discovered_host[puppet_class_ids]
optional , nil erlaubt

Validations:

  • Must be an array of any type

discovered_host[operatingsystem_id]
optional , nil erlaubt

Validations:

  • Must be a String

discovered_host[medium_id]
optional , nil erlaubt

Validations:

  • Must be a number.

discovered_host[ptable_id]
optional , nil erlaubt

Validations:

  • Must be a number.

discovered_host[subnet_id]
optional , nil erlaubt

Validations:

  • Must be a number.

discovered_host[sp_subnet_id]
optional , nil erlaubt

Validations:

  • Must be a number.

discovered_host[model_id]
optional , nil erlaubt

Validations:

  • Must be a number.

discovered_host[hostgroup_id]
optional , nil erlaubt

Validations:

  • Must be a number.

discovered_host[owner_id]
optional , nil erlaubt

Validations:

  • Must be a number.

discovered_host[puppet_ca_proxy_id]
optional , nil erlaubt

Validations:

  • Must be a number.

discovered_host[image_id]
optional , nil erlaubt

Validations:

  • Must be a number.

discovered_host[host_parameters_attributes]
optional , nil erlaubt

Validations:

  • Must be an array of any type

discovered_host[build]
optional , nil erlaubt

Validations:

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

discovered_host[enabled]
optional , nil erlaubt

Validations:

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

discovered_host[provision_method]
optional , nil erlaubt

Validations:

  • Must be a String

discovered_host[managed]
optional , nil erlaubt

Validations:

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

discovered_host[progress_report_id]
optional , nil erlaubt

UUID zum Tracken des Status der Orchestrierungsaufgaben, GET /api/orchestration/:UUID/tasks

Validations:

  • Must be a String

discovered_host[capabilities]
optional , nil erlaubt

Validations:

  • Must be a String

discovered_host[root_pass]
optional , nil erlaubt

erforderlich, falls kein Wert von Hostgruppe geerbt wird oder es nicht das Standardpasswort in Einstellungen ist

Validations:

  • Must be a String

discovered_host[pxe_loader]
optional , nil erlaubt

DHCP-Dateinamensoption (Standardmäßig 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.


DELETE /api/v2/discovered_hosts/:id
Entdeckten Host löschen

Parameter

Parametername Beschreibung
location_id
optional

Scope nach Standorten

Validations:

  • Must be a Integer

organization_id
optional

Scope nach Organisationen

Validations:

  • Must be a Integer

id
verpflichtend

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
Fakten für einen Host hochladen mit Erstellung des Hosts, wenn erforderlich

Parameter

Parametername Beschreibung
location_id
optional

Scope nach Standorten

Validations:

  • Must be a Integer

organization_id
optional

Scope nach Organisationen

Validations:

  • Must be a Integer

facts
verpflichtend

Hash, der Fakten für den Host mit minimaler Anzahl an Fakten enthält: discovery_bootif, macaddress_eth0, ipaddress, ipaddress_eth0, interfaces: eth0 (Beispiel für primäre Schnittstelle mit dem Namen eth0)

Validations:

  • Must be a Hash


POST /api/v2/discovered_hosts/:id/auto_provision
Regeln auf einem entdeckten Host anwenden

Parameter

Parametername Beschreibung
location_id
optional

Scope nach Standorten

Validations:

  • Must be a Integer

organization_id
optional

Scope nach Organisationen

Validations:

  • Must be a Integer

id
verpflichtend

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
Regeln auf allen kürzlich entdeckten Hosts anwenden

Parameter

Parametername Beschreibung
location_id
optional

Scope nach Standorten

Validations:

  • Must be a Integer

organization_id
optional

Scope nach Organisationen

Validations:

  • Must be a Integer


PUT /api/v2/discovered_hosts/:id/refresh_facts
Fakten eines entdeckten Hosts werden aktualisiert

Parameter

Parametername Beschreibung
location_id
optional

Scope nach Standorten

Validations:

  • Must be a Integer

organization_id
optional

Scope nach Organisationen

Validations:

  • Must be a Integer

id
verpflichtend

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
Entdeckten Host neu starten

Parameter

Parametername Beschreibung
location_id
optional

Scope nach Standorten

Validations:

  • Must be a Integer

organization_id
optional

Scope nach Organisationen

Validations:

  • Must be a Integer

id
verpflichtend

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
Alle entdeckten Hosts neu starten

Parameter

Parametername Beschreibung
location_id
optional

Scope nach Standorten

Validations:

  • Must be a Integer

organization_id
optional

Scope nach Organisationen

Validations:

  • Must be a Integer