Foreman considers a domain and a DNS zone as the same thing. That is, if you are planning to manage a site where all the machines are or the form hostname.somewhere.com then the domain is somewhere.com. This allows Foreman to associate a puppet variable with a domain/site and automatically append this variable to all external node requests made by machines at that site.


GET /api/domains
Lista de dominios

GET /api/subnets/:subnet_id/domains
Enumerar dominios por subred

GET /api/locations/:location_id/domains
Enumerar dominios por ubicación

GET /api/organizations/:organization_id/domains
Enumerar dominios por organización

Parámetros

Nombre del parámetro Descripción
subnet_id
opcional

ID de la subred

Validations:

  • Must be String

search
opcional

filtrar resultados

Validations:

  • Must be String

order
opcional

ordenar resultados

Validations:

  • Must be String

page
opcional

paginar resultados

Validations:

  • Must be String

per_page
opcional

número de entradas por petición

Validations:

  • Must be String


GET /api/domains/:id
Mostrar un dominio

Parámetros

Nombre del parámetro Descripción
id
requerido

ID numérico o nombre de dominio

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/domains
Crear un dominio

The fullname field is used for human readability in reports and other pages that refer to domains, and also available as an external node parameter

Parámetros

Nombre del parámetro Descripción
domain
requerido

Validations:

  • Must be a Hash

domain[name]
requerido

Nombre completo del dominio de DNS

Validations:

  • Must be String

domain[fullname]
opcional , nil permitido

Descripción del dominio

Validations:

  • Must be String

domain[dns_id]
opcional , nil permitido

Proxy DNS a usar en este dominio

Validations:

  • Must be a number.

domain[domain_parameters_attributes]
opcional , nil permitido

Matriz de parámetros (nombre, valor)

Validations:

  • Must be an array of any type


PUT /api/domains/:id
Actualizar un dominio

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.

domain
requerido

Validations:

  • Must be a Hash

domain[name]
opcional

Nombre completo del dominio de DNS

Validations:

  • Must be String

domain[fullname]
opcional , nil permitido

Descripción del dominio

Validations:

  • Must be String

domain[dns_id]
opcional , nil permitido

Proxy DNS a usar en este dominio

Validations:

  • Must be a number.

domain[domain_parameters_attributes]
opcional , nil permitido

Matriz de parámetros (nombre, valor)

Validations:

  • Must be an array of any type


DELETE /api/domains/:id
Borrar un dominio

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.