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

Parámetros

Nombre del parámetro Descripción
location_id
opcional

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
opcional

Set the current organization context for the request

Validations:

  • Must be a Integer

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
location_id
opcional

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
opcional

Set the current organization context for the request

Validations:

  • Must be a Integer

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
location_id
opcional

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
opcional

Set the current organization context for the request

Validations:

  • Must be a Integer

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

Parámetros

Nombre del parámetro Descripción
location_id
opcional

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
opcional

Set the current organization context for the request

Validations:

  • Must be a Integer

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

Parámetros

Nombre del parámetro Descripción
location_id
opcional

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
opcional

Set the current organization context for the request

Validations:

  • Must be a Integer

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
location_id
opcional

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
opcional

Set the current organization context for the request

Validations:

  • Must be a Integer

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
location_id
opcional

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
opcional

Set the current organization context for the request

Validations:

  • Must be a Integer

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

Parámetros

Nombre del parámetro Descripción
location_id
opcional

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
opcional

Set the current organization context for the request

Validations:

  • Must be a Integer


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

Parámetros

Nombre del parámetro Descripción
location_id
opcional

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
opcional

Set the current organization context for the request

Validations:

  • Must be a Integer

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
location_id
opcional

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
opcional

Set the current organization context for the request

Validations:

  • Must be a Integer

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

Parámetros

Nombre del parámetro Descripción
location_id
opcional

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
opcional

Set the current organization context for the request

Validations:

  • Must be a Integer