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
Llista dels dominis

GET /api/subnets/:subnet_id/domains
Llista dels dominis per subxarxa

GET /api/locations/:location_id/domains
Llista dels dominis per ubicació

GET /api/organizations/:organization_id/domains
Llista dels dominis per organització

Params

Param Name Description
subnet_id
Optional

Id. de subxarxa


Value:

Must be String

search
Optional

filtra els resultats


Value:

Must be String

order
Optional

ordena els resultats


Value:

Must be String

page
Optional

pagina els resultats


Value:

Must be String

per_page
Optional

Nombre d'entrades per petició


Value:

Must be String


GET /api/domains/:id
Mostra un domini

Params

Param Name Description
id
Required

Id. numèric o nom de domini


Value:

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
Crea un domini

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

Params

Param Name Description
domain
Required

Value:

Must be a Hash

domain[name]
Required

Tot el nom de domini DNS


Value:

Must be String

domain[fullname]
Optional , <span class="translation_missing" title="translation missing: ca.apipie.nil_allowed">Nil Allowed</span>

Descripció del domini


Value:

Must be String

domain[dns_id]
Optional , <span class="translation_missing" title="translation missing: ca.apipie.nil_allowed">Nil Allowed</span>

Servidor intermediari DNS per utilitzar dins d'aquest domini


Value:

Must be a number.

domain[domain_parameters_attributes]
Optional , <span class="translation_missing" title="translation missing: ca.apipie.nil_allowed">Nil Allowed</span>

Array of parameters (name, value)


Value:

Must be an array of any type


PUT /api/domains/:id
Actualitza un domini

Params

Param Name Description
id
Required

Value:

Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.

domain
Required

Value:

Must be a Hash

domain[name]
Optional

Tot el nom de domini DNS


Value:

Must be String

domain[fullname]
Optional , <span class="translation_missing" title="translation missing: ca.apipie.nil_allowed">Nil Allowed</span>

Descripció del domini


Value:

Must be String

domain[dns_id]
Optional , <span class="translation_missing" title="translation missing: ca.apipie.nil_allowed">Nil Allowed</span>

Servidor intermediari DNS per utilitzar dins d'aquest domini


Value:

Must be a number.

domain[domain_parameters_attributes]
Optional , <span class="translation_missing" title="translation missing: ca.apipie.nil_allowed">Nil Allowed</span>

Array of parameters (name, value)


Value:

Must be an array of any type


DELETE /api/domains/:id
Suprimeix un domini

Params

Param Name Description
id
Required

Value:

Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.