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
Elenco dei domini

GET /api/subnets/:subnet_id/domains
Elenco di domini per sottorete

GET /api/locations/:location_id/domains
Elenco di domini per posizione

GET /api/organizations/:organization_id/domains
Elenco di domini per organizzazione

Params

Param Name Description
subnet_id
Optional

ID della sottorete

Validations:

  • Must be String

search
Optional

filtra i risultati

Validations:

  • Must be String

order
Optional

ordina risultati

Validations:

  • Must be String

page
Optional

paginazione risultati

Validations:

  • Must be String

per_page
Optional

numero di voci per richiesta

Validations:

  • Must be String


GET /api/domains/:id
Mostra un dominio

Params

Param Name Description
id
Required

ID numerico o nome del 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
Crea 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

Params

Param Name Description
domain
Required

Validations:

  • Must be a Hash

domain[name]
Required

Il nome del dominio DNS completo

Validations:

  • Must be String

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

Descrizione del dominio

Validations:

  • Must be String

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

DNS proxy da usare all'interno di questo dominio

Validations:

  • Must be a number.

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

Insieme di parametri (nome, valore)

Validations:

  • Must be an array of any type


PUT /api/domains/:id
Aggiorna un dominio

Params

Param Name Description
id
Required

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
Required

Validations:

  • Must be a Hash

domain[name]
Optional

Il nome del dominio DNS completo

Validations:

  • Must be String

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

Descrizione del dominio

Validations:

  • Must be String

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

DNS proxy da usare all'interno di questo dominio

Validations:

  • Must be a number.

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

Insieme di parametri (nome, valore)

Validations:

  • Must be an array of any type


DELETE /api/domains/:id
Cancella un dominio

Params

Param Name Description
id
Required

Validations:

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