Discovered hosts

>>>

GET /api/v2/discovered_hosts
Confeccionar una lista de los hosts detectados

Parámetros

Nombre del parámetro Descripción
search
opcional

filtrar resultados

Validations:

  • Must be a String
order
opcional

organizar resultados

Validations:

  • Must be a String
page
opcional

paginar resultados

Validations:

  • Must be a String
per_page
opcional

número de entradas por solicitud

Validations:

  • Must be a String
>>>

GET /api/v2/discovered_hosts/:id
Mostrar un host detectado

Parámetros

Nombre del parámetro Descripción
id
requerido

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
Crear un host detectado para utilizar en pruebas (utilizar/hechos para crear nuevos hosts)

Parámetros

Nombre del parámetro Descripción
discovered_host
opcional , nil permitido

Validations:

  • Must be a Hash
discovered_host[name]
requerido

Validations:

  • Must be a String
discovered_host[ip]
requerido

Validations:

  • Must be a String
discovered_host[mac]
requerido

Validations:

  • Must be a String
discovered_host[pxe_loader]
opcional , nil permitido

Opción de nombre de archivo DHCP (Grub2 o PXELinux en forma predeterminada)

Validations:

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

PUT /api/v2/discovered_hosts/:id
Aprovisionar un host detectado

Parámetros

Nombre del parámetro Descripción
id
requerido

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
opcional , nil permitido

Validations:

  • Must be a Hash
discovered_host[name]
opcional , nil permitido

Validations:

  • Must be a String
discovered_host[environment_id]
opcional , nil permitido

Validations:

  • Must be a String
discovered_host[ip]
opcional , nil permitido

no es necesario si se usa una subred con un proxy DHCP

Validations:

  • Must be a String
discovered_host[mac]
opcional , nil permitido

no es necesario si no se trata de una máquina virtual

Validations:

  • Must be a String
discovered_host[architecture_id]
opcional , nil permitido

Validations:

  • Must be a number.
discovered_host[domain_id]
opcional , nil permitido

Validations:

  • Must be a number.
discovered_host[puppet_proxy_id]
opcional , nil permitido

Validations:

  • Must be a number.
discovered_host[puppet_class_ids]
opcional , nil permitido

Validations:

  • Must be an array of any type
discovered_host[operatingsystem_id]
opcional , nil permitido

Validations:

  • Must be a String
discovered_host[medium_id]
opcional , nil permitido

Validations:

  • Must be a number.
discovered_host[ptable_id]
opcional , nil permitido

Validations:

  • Must be a number.
discovered_host[subnet_id]
opcional , nil permitido

Validations:

  • Must be a number.
discovered_host[sp_subnet_id]
opcional , nil permitido

Validations:

  • Must be a number.
discovered_host[model_id]
opcional , nil permitido

Validations:

  • Must be a number.
discovered_host[hostgroup_id]
opcional , nil permitido

Validations:

  • Must be a number.
discovered_host[owner_id]
opcional , nil permitido

Validations:

  • Must be a number.
discovered_host[puppet_ca_proxy_id]
opcional , nil permitido

Validations:

  • Must be a number.
discovered_host[image_id]
opcional , nil permitido

Validations:

  • Must be a number.
discovered_host[host_parameters_attributes]
opcional , nil permitido

Validations:

  • Must be an array of any type
discovered_host[build]
opcional , nil permitido

Validations:

  • Must be one of: true, false, 1, 0
discovered_host[enabled]
opcional , nil permitido

Validations:

  • Must be one of: true, false, 1, 0
discovered_host[provision_method]
opcional , nil permitido

Validations:

  • Must be a String
discovered_host[managed]
opcional , nil permitido

Validations:

  • Must be one of: true, false, 1, 0
discovered_host[progress_report_id]
opcional , nil permitido

UUID para seguir el estado de la tarea de orquestación, GET /api/orchestration/:UUID/tasks

Validations:

  • Must be a String
discovered_host[capabilities]
opcional , nil permitido

Validations:

  • Must be a String
discovered_host[root_pass]
opcional , nil permitido

es necesario si el valor no se hereda del grupo del host o de la contraseña predeterminada en las configuraciones

Validations:

  • Must be a String
discovered_host[pxe_loader]
opcional , nil permitido

Opción de nombre de archivo DHCP (Grub2 o PXELinux en forma predeterminada)

Validations:

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

DELETE /api/v2/discovered_hosts/:id
Eliminar un host detectado

Parámetros

Nombre del parámetro Descripción
id
requerido

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
Subir eventos para un host, si es necesario cree el host.

Parámetros

Nombre del parámetro Descripción
facts
requerido

hash que contiene eventos correspondientes al host con un conjunto mínimo de eventos: discovery_bootif, macaddress_eth0, ipaddress, ipaddress_eth0, interfaces: eth0 (ejemplo en caso de que la interfaz principal se denomine eth0)

Validations:

  • Must be a Hash
>>>

POST /api/v2/discovered_hosts/:id/auto_provision
Ejecutar reglas en función de un host detectado

Parámetros

Nombre del parámetro Descripción
id
requerido

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
Ejecutar reglas contra todos los hosts detectados actualmente

>>>

PUT /api/v2/discovered_hosts/:id/refresh_facts
Actualizando los eventos de un host detectado

Parámetros

Nombre del parámetro Descripción
id
requerido

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
Reiniciando un host detectado

Parámetros

Nombre del parámetro Descripción
id
requerido

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
Reiniciando todos los hosts detectados