GET /api/v2/discovered_hosts
Afficher tous les hôtes détectés

Paramètres

Nom du paramètre Description
location_id
optionel

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
optionel

Set the current organization context for the request

Validations:

  • Must be a Integer

search
optionel

filtrer les résultats

Validations:

  • Must be a String

order
optionel

trier les résultats

Validations:

  • Must be a String

page
optionel

paginer les résultats

Validations:

  • Must be a String

per_page
optionel

nombre d'entrées par requête

Validations:

  • Must be a String


GET /api/v2/discovered_hosts/:id
Afficher un hôte détecté

Paramètres

Nom du paramètre Description
location_id
optionel

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
optionel

Set the current organization context for the request

Validations:

  • Must be a Integer

id
requis

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
Créer un hôte détecté pour le test (utiliser /facts pour créer des hôtes)

Paramètres

Nom du paramètre Description
location_id
optionel

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
optionel

Set the current organization context for the request

Validations:

  • Must be a Integer

discovered_host
optionel , nil autorisé

Validations:

  • Must be a Hash

discovered_host[name]
requis

Validations:

  • Must be a String

discovered_host[ip]
requis

Validations:

  • Must be a String

discovered_host[mac]
requis

Validations:

  • Must be a String

discovered_host[pxe_loader]
optionel , nil autorisé

Option nom de fichier DHCP (Grub2 ou PXELinux par défaut)

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
Provisionner un hôte détecté

Paramètres

Nom du paramètre Description
location_id
optionel

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
optionel

Set the current organization context for the request

Validations:

  • Must be a Integer

id
requis

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
optionel , nil autorisé

Validations:

  • Must be a Hash

discovered_host[name]
optionel , nil autorisé

Validations:

  • Must be a String

discovered_host[environment_id]
optionel , nil autorisé

Validations:

  • Must be a String

discovered_host[ip]
optionel , nil autorisé

n'est pas requis s'il s'agit d'un sous-réseau avec un proxy DHCP

Validations:

  • Must be a String

discovered_host[mac]
optionel , nil autorisé

non requis s'il s'agit d'une machine virtuelle

Validations:

  • Must be a String

discovered_host[architecture_id]
optionel , nil autorisé

Validations:

  • Must be a number.

discovered_host[domain_id]
optionel , nil autorisé

Validations:

  • Must be a number.

discovered_host[puppet_proxy_id]
optionel , nil autorisé

Validations:

  • Must be a number.

discovered_host[puppet_class_ids]
optionel , nil autorisé

Validations:

  • Must be an array of any type

discovered_host[operatingsystem_id]
optionel , nil autorisé

Validations:

  • Must be a String

discovered_host[medium_id]
optionel , nil autorisé

Validations:

  • Must be a number.

discovered_host[ptable_id]
optionel , nil autorisé

Validations:

  • Must be a number.

discovered_host[subnet_id]
optionel , nil autorisé

Validations:

  • Must be a number.

discovered_host[sp_subnet_id]
optionel , nil autorisé

Validations:

  • Must be a number.

discovered_host[model_id]
optionel , nil autorisé

Validations:

  • Must be a number.

discovered_host[hostgroup_id]
optionel , nil autorisé

Validations:

  • Must be a number.

discovered_host[owner_id]
optionel , nil autorisé

Validations:

  • Must be a number.

discovered_host[puppet_ca_proxy_id]
optionel , nil autorisé

Validations:

  • Must be a number.

discovered_host[image_id]
optionel , nil autorisé

Validations:

  • Must be a number.

discovered_host[host_parameters_attributes]
optionel , nil autorisé

Validations:

  • Must be an array of any type

discovered_host[build]
optionel , nil autorisé

Validations:

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

discovered_host[enabled]
optionel , nil autorisé

Validations:

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

discovered_host[provision_method]
optionel , nil autorisé

Validations:

  • Must be a String

discovered_host[managed]
optionel , nil autorisé

Validations:

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

discovered_host[progress_report_id]
optionel , nil autorisé

UUID pour surveiller l'état des tâches d'orchestration : GET /api/orchestration/:UUID/tasks

Validations:

  • Must be a String

discovered_host[capabilities]
optionel , nil autorisé

Validations:

  • Must be a String

discovered_host[root_pass]
optionel , nil autorisé

requis si la valeur n'est pas héritée d'un groupe d'hôtes ou du mot de passe par défaut défini dans les paramètres

Validations:

  • Must be a String

discovered_host[pxe_loader]
optionel , nil autorisé

Option nom de fichier DHCP (Grub2 ou PXELinux par défaut)

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
Supprimer un hôte détecté

Paramètres

Nom du paramètre Description
location_id
optionel

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
optionel

Set the current organization context for the request

Validations:

  • Must be a Integer

id
requis

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
Télécharge les facts d'un hôte, créé l'hôte si besoin

Paramètres

Nom du paramètre Description
location_id
optionel

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
optionel

Set the current organization context for the request

Validations:

  • Must be a Integer

facts
requis

hachage contenant les facts de l'hôte avec un ensemble minimal de facts : discovery_bootif, macaddress_eth0, ipaddress, ipaddress_eth0, interfaces: eth0 (exemple si l'interface principale s'appelle eth0)

Validations:

  • Must be a Hash


POST /api/v2/discovered_hosts/:id/auto_provision
Exécuter les règles sur un hôte détecté

Paramètres

Nom du paramètre Description
location_id
optionel

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
optionel

Set the current organization context for the request

Validations:

  • Must be a Integer

id
requis

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
Exécuter les règles sur tous les hôtes actuellement détectés

Paramètres

Nom du paramètre Description
location_id
optionel

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
optionel

Set the current organization context for the request

Validations:

  • Must be a Integer


PUT /api/v2/discovered_hosts/:id/refresh_facts
Actualisation des facts d'un hôte détecté

Paramètres

Nom du paramètre Description
location_id
optionel

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
optionel

Set the current organization context for the request

Validations:

  • Must be a Integer

id
requis

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
Redémarrage d'un hôte détecté

Paramètres

Nom du paramètre Description
location_id
optionel

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
optionel

Set the current organization context for the request

Validations:

  • Must be a Integer

id
requis

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
Redémarrage de tous les hôtes détectés

Paramètres

Nom du paramètre Description
location_id
optionel

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
optionel

Set the current organization context for the request

Validations:

  • Must be a Integer