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 of 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/locations/447626442/organizations/447626440/domains
200
{
"total": 1,
"subtotal": 1,
"page": 1,
"per_page": 20,
"search": null,
"sort": {
"by": null,
"order": null
},
"results": [
{
"fullname": "example235.com",
"created_at": "2019-11-07 08:37:31 UTC",
"updated_at": "2019-11-07 08:37:31 UTC",
"id": 759776772,
"name": "example235.com",
"dns_id": null,
"dns": null
}
]
}
| Param name | Description |
|---|---|
|
subnet_id optional |
ID of subnet Validations:
|
|
location_id optional |
Scope by locations Validations:
|
|
organization_id optional |
Scope by organizations Validations:
|
|
search optional |
filter results Validations:
|
|
order optional |
Sort field and order, eg. ‘id DESC’ Validations:
|
|
page optional |
Page number, starting at 1 Validations:
|
|
per_page optional |
Number of results per page to return Validations:
|
| Field name | Type | Possible values |
|---|---|---|
| fullname | string | |
| location | string | |
| location_id | integer | |
| name | string | |
| organization | string | |
| organization_id | integer | |
| params | text |
GET /api/domains/759776768-example929-com
200
{
"fullname": "example929.com",
"created_at": "2019-11-07 08:53:46 UTC",
"updated_at": "2019-11-07 08:53:46 UTC",
"id": 759776768,
"name": "example929.com",
"dns_id": null,
"dns": null,
"subnets": [],
"interfaces": [],
"parameters": [
{
"priority": 30,
"created_at": "2019-11-07 08:53:46 UTC",
"updated_at": "2019-11-07 08:53:46 UTC",
"id": 767575243,
"name": "parameter323",
"parameter_type": "string",
"value": "parameter value 345"
}
],
"locations": [
{
"id": 255093256,
"name": "Location 1",
"title": "Location 1",
"description": null
}
],
"organizations": [
{
"id": 447626438,
"name": "Organization 1",
"title": "Organization 1",
"description": null
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Set the current location context for the request Validations:
|
|
organization_id optional |
Set the current organization context for the request Validations:
|
|
id required |
Numerical ID or domain name Validations:
|
|
show_hidden_parameters optional |
Display hidden parameter values Validations:
|
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
POST /api/domains
{
"organization_id": 447626448,
"domain": {
"name": "example243.com",
"organization_ids": [
447626448
],
"location_ids": [
447626450
]
}
}
201
{
"fullname": null,
"created_at": "2019-11-07 08:37:32 UTC",
"updated_at": "2019-11-07 08:37:32 UTC",
"id": 759776780,
"name": "example243.com",
"dns_id": null,
"dns": null,
"subnets": [],
"interfaces": [],
"parameters": [],
"locations": [
{
"id": 447626450,
"name": "loc67",
"title": "loc67",
"description": null
}
],
"organizations": [
{
"id": 447626448,
"name": "org79",
"title": "org79",
"description": null
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Set the current location context for the request Validations:
|
|
organization_id optional |
Set the current organization context for the request Validations:
|
|
domain required |
Validations:
|
|
domain[name] required |
The full DNS domain name Validations:
|
|
domain[fullname] optional , nil allowed |
Description of the domain Validations:
|
|
domain[dns_id] optional , nil allowed |
DNS proxy ID to use within this domain Validations:
|
|
domain[domain_parameters_attributes] optional , nil allowed |
Array of parameters (name, value) Validations:
|
|
domain[location_ids] optional , nil allowed |
REPLACE locations with given ids Validations:
|
|
domain[organization_ids] optional , nil allowed |
REPLACE organizations with given ids. Validations:
|
PUT /api/domains/759776766
{
"domain": {
"domain_parameters_attributes": [
{
"name": "foo",
"value": "new_value"
}
]
}
}
200
{
"fullname": "example927.com",
"created_at": "2019-11-07 08:53:46 UTC",
"updated_at": "2019-11-07 08:53:46 UTC",
"id": 759776766,
"name": "example927.com",
"dns_id": null,
"dns": null,
"subnets": [],
"interfaces": [],
"parameters": [
{
"priority": 30,
"created_at": "2019-11-07 08:53:46 UTC",
"updated_at": "2019-11-07 08:53:46 UTC",
"id": 767575241,
"name": "foo",
"parameter_type": "string",
"value": "new_value"
}
],
"locations": [
{
"id": 255093256,
"name": "Location 1",
"title": "Location 1",
"description": null
}
],
"organizations": [
{
"id": 447626438,
"name": "Organization 1",
"title": "Organization 1",
"description": null
}
]
}
| Param name | Description |
|---|---|
|
location_id optional |
Set the current location context for the request Validations:
|
|
organization_id optional |
Set the current organization context for the request Validations:
|
|
id required |
Validations:
|
|
domain required |
Validations:
|
|
domain[name] optional |
The full DNS domain name Validations:
|
|
domain[fullname] optional , nil allowed |
Description of the domain Validations:
|
|
domain[dns_id] optional , nil allowed |
DNS proxy ID to use within this domain Validations:
|
|
domain[domain_parameters_attributes] optional , nil allowed |
Array of parameters (name, value) Validations:
|
|
domain[location_ids] optional , nil allowed |
REPLACE locations with given ids Validations:
|
|
domain[organization_ids] optional , nil allowed |
REPLACE organizations with given ids. Validations:
|
DELETE /api/domains/22495316-mydomain-net
{
"domain": {}
}
200
{
"id": 22495316,
"name": "mydomain.net",
"fullname": null,
"created_at": "2019-11-07T08:53:42.031Z",
"updated_at": "2019-11-07T08:53:42.031Z",
"dns_id": 113629430
}
| Param name | Description |
|---|---|
|
location_id optional |
Set the current location context for the request Validations:
|
|
organization_id optional |
Set the current organization context for the request Validations:
|
|
id required |
Validations:
|