Nombre del parámetro | Descripción |
---|---|
hostgroup_id opcional |
ID del grupo de hosts Value: Must be String |
location_id opcional |
ID de la ubicación Value: Must be String |
organization_id opcional |
ID de la organización Value: Must be String |
environment_id opcional |
ID del entorno Value: Must be String |
search opcional |
filtrar resultados Value: Must be String |
order opcional |
ordenar resultados Value: Must be String |
page opcional |
paginar resultados Value: Must be String |
per_page opcional |
número de entradas por petición Value: Must be String |
Nombre del parámetro | Descripción |
---|---|
id requerido |
Value: Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, dot(.), space, underscore(_), hypen(-) with no leading or trailing space. |
Nombre del parámetro | Descripción |
---|---|
host requerido |
Value: Must be a Hash |
host[name] requerido |
Value: Must be String |
host[environment_id] opcional , nil permitido |
obligatorio si los hosts están gestionados y el valor no se ha hereado de un grupo de hosts Value: Must be String |
host[ip] opcional , nil permitido |
no es necesario si estás usando una subred con un proxy DHCP Value: Must be String |
host[mac] opcional , nil permitido |
obligatorio para hosts bare metal gestionados, opcional para máquinas virtuales Value: Must be String |
host[architecture_id] opcional , nil permitido |
obligatorio si los hosts están gestionados y el valor no se ha hereado de un grupo de hosts Value: Must be a number. |
host[domain_id] opcional , nil permitido |
obligatorio si los hosts están gestionados y el valor no se ha hereado de un grupo de hosts Value: Must be a number. |
host[realm_id] opcional , nil permitido |
Value: Must be a number. |
host[puppet_proxy_id] opcional , nil permitido |
Value: Must be a number. |
host[puppet_class_ids] opcional , nil permitido |
Value: Must be an array of any type |
host[operatingsystem_id] opcional , nil permitido |
obligatorio si los hosts están gestionados y el valor no se ha hereado de un grupo de hosts Value: Must be String |
host[medium_id] opcional , nil permitido |
obligatorio si la provisión no está basada en imágenes y el host está gestionado y el valor no se hereda de un grupo de hosts Value: Must be String |
host[ptable_id] opcional , nil permitido |
obligatorio si el host está gestionado y no se han definido particiones personalizadas Value: Must be a number. |
host[subnet_id] opcional , nil permitido |
obligatorio si los hosts están gestionados y el valor no se ha hereado de un grupo de hosts Value: Must be a number. |
host[compute_resource_id] opcional , nil permitido |
nil implica que el host es bare metal Value: Must be a number. |
host[root_pass] opcional , nil permitido |
obligatorio si el host está gestionado y el valor no se hereda de un grupo de hosts o passwords por defecto en la configuración Value: Must be String |
host[model_id] opcional , nil permitido |
Value: Must be a number. |
host[hostgroup_id] opcional , nil permitido |
Value: Must be a number. |
host[owner_id] opcional , nil permitido |
Value: Must be a number. |
host[owner_type] opcional , nil permitido |
Tipo de dueño del host Value: Must be one of: User, Usergroup. |
host[puppet_ca_proxy_id] opcional , nil permitido |
Value: Must be a number. |
host[image_id] opcional , nil permitido |
Value: Must be a number. |
host[host_parameters_attributes] opcional , nil permitido |
Value: Must be an array of any type |
host[build] opcional , nil permitido |
Value: Must be 'true' or 'false' |
host[enabled] opcional , nil permitido |
Value: Must be 'true' or 'false' |
host[provision_method] opcional , nil permitido |
The method used to provision the host. Possible provision_methods may be build (Basado en Red), image (Basado en Imagen) Value: Must be String |
host[managed] opcional , nil permitido |
Bandera Verdadero/Falso indicando si el host está gestionado o no. Nota: este valor también determina si ciertos parámetros son obligatorios. Value: Must be 'true' or 'false' |
host[progress_report_id] opcional , nil permitido |
UUID para seguir el estado de la tarea de orquestación, GET /api/orchestration/:UUID/tasks Value: Must be String |
host[comment] opcional , nil permitido |
Información adicional sobre este equipo Value: Must be String |
host[capabilities] opcional , nil permitido |
Value: Must be String |
host[compute_profile_id] opcional , nil permitido |
Value: Must be a number. |
host[interfaces_attributes] opcional , nil permitido |
Interfaces de red del host. Value: Must be an Array of nested elements |
host[interfaces_attributes][mac] opcional , nil permitido |
Dirección MAC del interfaz. Requisito para interfaces gestionados en bare-metal. Value: Must be String |
host[interfaces_attributes][ip] opcional , nil permitido |
Dirección IP del interfaz Value: Must be String |
host[interfaces_attributes][type] opcional , nil permitido |
Tipo de interfaz, p. ej. bmc. Por defecto interface Value: Must be one of: interface, bmc, bond, bridge. |
host[interfaces_attributes][name] opcional , nil permitido |
Nombre DNS del interfaz Value: Must be String |
host[interfaces_attributes][subnet_id] opcional , nil permitido |
ID de la subred de la interfaz Value: Must be Fixnum |
host[interfaces_attributes][domain_id] opcional , nil permitido |
ID de Foreman de dominio del interfaz. Obligatorio para interfaces primarios en los hosts gestionados. Value: Must be Fixnum |
host[interfaces_attributes][identifier] opcional , nil permitido |
Identificador de dispositivo, p.ej. eth0 o eth1.1 Value: Must be String |
host[interfaces_attributes][managed] opcional , nil permitido |
¿Debería gestionarse este interfaz por proxy inteligente DHCP y DNS y debería configurarse en la provisión? Value: Must be 'true' or 'false' |
host[interfaces_attributes][primary] opcional , nil permitido |
¿Debería usarse este interfaz para construir el FQDN del host? Cada host gestionado necesita tener un interfaz primario. Value: Must be 'true' or 'false' |
host[interfaces_attributes][provision] opcional , nil permitido |
¿Debería usarse este interfaz para TFTP o PXELinux (o SSH para hosts definidos por imagen)? Cada host gestionado necesita tener un interfaz de provisión. Value: Must be 'true' or 'false' |
host[interfaces_attributes][username] opcional , nil permitido |
Sólo para interfaces BMC. Value: Must be String |
host[interfaces_attributes][password] opcional , nil permitido |
Sólo para interfaces BMC. Value: Must be String |
host[interfaces_attributes][provider] opcional , nil permitido |
Proveedor del interfaz, p.ej. IPMI. Sólo para interfaces BMC. Value: Must be one of: IPMI. |
host[interfaces_attributes][virtual] opcional , nil permitido |
Dispositivo VLAN o alias Value: Must be 'true' or 'false' |
host[interfaces_attributes][tag] opcional , nil permitido |
Etiqueta VLAN, este atributo tiene precedencia sobre la ID de subred VLAN. Sólo para interfaces virtuales. Value: Must be String |
host[interfaces_attributes][attached_to] opcional , nil permitido |
Identificador del interfaz al que pertenece este interfaz, p.ej. eth1. Sólo para interfaces virtuales. Value: Must be String |
host[interfaces_attributes][mode] opcional , nil permitido |
Modo de bonding tdel interfaz, p.ej. balance-rr. Solo para interfaces bond. Value: Must be one of: balance-rr, active-backup, balance-xor, broadcast, 802.3ad, balance-tlb, balance-alb. |
host[interfaces_attributes][attached_devices] opcional , nil permitido |
Identifiers of attached interfaces, e.g. `['eth1', 'eth2']`. For bond interfaces those are the slaves. Only for bond and bridges interfaces. Value: Must be an array of any type |
host[interfaces_attributes][bond_options] opcional , nil permitido |
Opciones separadas por espacios, p.ej miimon=100. Solo para interfaces bond. Value: Must be String |
host[interfaces_attributes][compute_attributes] opcional , nil permitido |
Atributos específicos suplementarios de recursos de cómputo para el interfaz. Value: Must be Hash |
host[compute_attributes] opcional , nil permitido |
Atributos adicionales específicos de recursos de cómputo. Value: Must be Hash |
Nombre del parámetro | Descripción |
---|---|
id requerido |
Value: Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space. |
host requerido |
Value: Must be a Hash |
host[name] opcional |
Value: Must be String |
host[environment_id] opcional , nil permitido |
obligatorio si los hosts están gestionados y el valor no se ha hereado de un grupo de hosts Value: Must be String |
host[ip] opcional , nil permitido |
no es necesario si estás usando una subred con un proxy DHCP Value: Must be String |
host[mac] opcional , nil permitido |
obligatorio para hosts bare metal gestionados, opcional para máquinas virtuales Value: Must be String |
host[architecture_id] opcional , nil permitido |
obligatorio si los hosts están gestionados y el valor no se ha hereado de un grupo de hosts Value: Must be a number. |
host[domain_id] opcional , nil permitido |
obligatorio si los hosts están gestionados y el valor no se ha hereado de un grupo de hosts Value: Must be a number. |
host[realm_id] opcional , nil permitido |
Value: Must be a number. |
host[puppet_proxy_id] opcional , nil permitido |
Value: Must be a number. |
host[puppet_class_ids] opcional , nil permitido |
Value: Must be an array of any type |
host[operatingsystem_id] opcional , nil permitido |
obligatorio si los hosts están gestionados y el valor no se ha hereado de un grupo de hosts Value: Must be String |
host[medium_id] opcional , nil permitido |
obligatorio si la provisión no está basada en imágenes y el host está gestionado y el valor no se hereda de un grupo de hosts Value: Must be String |
host[ptable_id] opcional , nil permitido |
obligatorio si el host está gestionado y no se han definido particiones personalizadas Value: Must be a number. |
host[subnet_id] opcional , nil permitido |
obligatorio si los hosts están gestionados y el valor no se ha hereado de un grupo de hosts Value: Must be a number. |
host[compute_resource_id] opcional , nil permitido |
nil implica que el host es bare metal Value: Must be a number. |
host[root_pass] opcional , nil permitido |
obligatorio si el host está gestionado y el valor no se hereda de un grupo de hosts o passwords por defecto en la configuración Value: Must be String |
host[model_id] opcional , nil permitido |
Value: Must be a number. |
host[hostgroup_id] opcional , nil permitido |
Value: Must be a number. |
host[owner_id] opcional , nil permitido |
Value: Must be a number. |
host[owner_type] opcional , nil permitido |
Tipo de dueño del host Value: Must be one of: User, Usergroup. |
host[puppet_ca_proxy_id] opcional , nil permitido |
Value: Must be a number. |
host[image_id] opcional , nil permitido |
Value: Must be a number. |
host[host_parameters_attributes] opcional , nil permitido |
Value: Must be an array of any type |
host[build] opcional , nil permitido |
Value: Must be 'true' or 'false' |
host[enabled] opcional , nil permitido |
Value: Must be 'true' or 'false' |
host[provision_method] opcional , nil permitido |
The method used to provision the host. Possible provision_methods may be build (Basado en Red), image (Basado en Imagen) Value: Must be String |
host[managed] opcional , nil permitido |
Bandera Verdadero/Falso indicando si el host está gestionado o no. Nota: este valor también determina si ciertos parámetros son obligatorios. Value: Must be 'true' or 'false' |
host[progress_report_id] opcional , nil permitido |
UUID para seguir el estado de la tarea de orquestación, GET /api/orchestration/:UUID/tasks Value: Must be String |
host[comment] opcional , nil permitido |
Información adicional sobre este equipo Value: Must be String |
host[capabilities] opcional , nil permitido |
Value: Must be String |
host[compute_profile_id] opcional , nil permitido |
Value: Must be a number. |
host[interfaces_attributes] opcional , nil permitido |
Interfaces de red del host. Value: Must be an Array of nested elements |
host[interfaces_attributes][mac] opcional , nil permitido |
Dirección MAC del interfaz. Requisito para interfaces gestionados en bare-metal. Value: Must be String |
host[interfaces_attributes][ip] opcional , nil permitido |
Dirección IP del interfaz Value: Must be String |
host[interfaces_attributes][type] opcional , nil permitido |
Tipo de interfaz, p. ej. bmc. Por defecto interface Value: Must be one of: interface, bmc, bond, bridge. |
host[interfaces_attributes][name] opcional , nil permitido |
Nombre DNS del interfaz Value: Must be String |
host[interfaces_attributes][subnet_id] opcional , nil permitido |
ID de la subred de la interfaz Value: Must be Fixnum |
host[interfaces_attributes][domain_id] opcional , nil permitido |
ID de Foreman de dominio del interfaz. Obligatorio para interfaces primarios en los hosts gestionados. Value: Must be Fixnum |
host[interfaces_attributes][identifier] opcional , nil permitido |
Identificador de dispositivo, p.ej. eth0 o eth1.1 Value: Must be String |
host[interfaces_attributes][managed] opcional , nil permitido |
¿Debería gestionarse este interfaz por proxy inteligente DHCP y DNS y debería configurarse en la provisión? Value: Must be 'true' or 'false' |
host[interfaces_attributes][primary] opcional , nil permitido |
¿Debería usarse este interfaz para construir el FQDN del host? Cada host gestionado necesita tener un interfaz primario. Value: Must be 'true' or 'false' |
host[interfaces_attributes][provision] opcional , nil permitido |
¿Debería usarse este interfaz para TFTP o PXELinux (o SSH para hosts definidos por imagen)? Cada host gestionado necesita tener un interfaz de provisión. Value: Must be 'true' or 'false' |
host[interfaces_attributes][username] opcional , nil permitido |
Sólo para interfaces BMC. Value: Must be String |
host[interfaces_attributes][password] opcional , nil permitido |
Sólo para interfaces BMC. Value: Must be String |
host[interfaces_attributes][provider] opcional , nil permitido |
Proveedor del interfaz, p.ej. IPMI. Sólo para interfaces BMC. Value: Must be one of: IPMI. |
host[interfaces_attributes][virtual] opcional , nil permitido |
Dispositivo VLAN o alias Value: Must be 'true' or 'false' |
host[interfaces_attributes][tag] opcional , nil permitido |
Etiqueta VLAN, este atributo tiene precedencia sobre la ID de subred VLAN. Sólo para interfaces virtuales. Value: Must be String |
host[interfaces_attributes][attached_to] opcional , nil permitido |
Identificador del interfaz al que pertenece este interfaz, p.ej. eth1. Sólo para interfaces virtuales. Value: Must be String |
host[interfaces_attributes][mode] opcional , nil permitido |
Modo de bonding tdel interfaz, p.ej. balance-rr. Solo para interfaces bond. Value: Must be one of: balance-rr, active-backup, balance-xor, broadcast, 802.3ad, balance-tlb, balance-alb. |
host[interfaces_attributes][attached_devices] opcional , nil permitido |
Identifiers of attached interfaces, e.g. `['eth1', 'eth2']`. For bond interfaces those are the slaves. Only for bond and bridges interfaces. Value: Must be an array of any type |
host[interfaces_attributes][bond_options] opcional , nil permitido |
Opciones separadas por espacios, p.ej miimon=100. Solo para interfaces bond. Value: Must be String |
host[interfaces_attributes][compute_attributes] opcional , nil permitido |
Atributos específicos suplementarios de recursos de cómputo para el interfaz. Value: Must be Hash |
host[compute_attributes] opcional , nil permitido |
Atributos adicionales específicos de recursos de cómputo. Value: Must be Hash |
Nombre del parámetro | Descripción |
---|---|
id requerido |
Value: Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space. |
Return value may either be one of the following:
missing
failed
pending
changed
unchanged
unreported
Nombre del parámetro | Descripción |
---|---|
id requerido |
Value: Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, dot(.), space, underscore(_), hypen(-) with no leading or trailing space. |
Returns string representing a host status of a given type
Nombre del parámetro | Descripción |
---|---|
id requerido |
Value: Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, dot(.), space, underscore(_), hypen(-) with no leading or trailing space. |
type requerido |
status type, can be one of
Value: Must be one of: HostStatus::Global, configuration, build. |
Return the host's compute attributes that can be used to create a clone of this VM
Nombre del parámetro | Descripción |
---|---|
id requerido |
Value: Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, dot(.), space, underscore(_), hypen(-) with no leading or trailing space. |
Nombre del parámetro | Descripción |
---|---|
id requerido |
Value: Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, dot(.), space, underscore(_), hypen(-) with no leading or trailing space. |
Nombre del parámetro | Descripción |
---|---|
id requerido |
Value: Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, dot(.), space, underscore(_), hypen(-) with no leading or trailing space. |
Nombre del parámetro | Descripción |
---|---|
id requerido |
Value: Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, dot(.), space, underscore(_), hypen(-) with no leading or trailing space. |
power_action requerido |
acción de encendido, las acciones válidas incluyen (on/start), (off/stop), (soft/reboot), (cycle/reset), (state/status) Value: Must be String |
Nombre del parámetro | Descripción |
---|---|
id requerido |
Value: Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, dot(.), space, underscore(_), hypen(-) with no leading or trailing space. |
device requerido |
dispositivo de inicio, dispositivos validos son disk, cdrom, pxe, bios Value: Must be String |
Nombre del parámetro | Descripción |
---|---|
name requerido |
nombre de host del host Value: Must be String |
facts requerido |
hash con los detalles para el host Value: Must be Hash |
certname opcional |
opcional: nombre de certificado del host Value: Must be String |
type opcional |
opcional: el tipo STI de host a crear Value: Must be String |
Nombre del parámetro | Descripción |
---|---|
id requerido |
Value: Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, dot(.), space, underscore(_), hypen(-) with no leading or trailing space. |
Nombre del parámetro | Descripción |
---|---|
id requerido |
Value: Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, dot(.), space, underscore(_), hypen(-) with no leading or trailing space. |
kind requerido |
Template kinds, available values: Value: Must be String |