POST /api/topology/hosts

Description

Add a host to the topology. This is called via the managedomain script and the installer when a new host is registered.

---

Resource URL

https://localhost:8090/api/topology/hosts

---

Parameters

host

mandatory

The new host to be registered. This is passed in the request body. The id field is not required in the request body. Refer to Javadoc for com.vordel.api.topology.model.Host.

---

Response Codes

Response Code	Description
201	Success. The response body contains the created host. The id will be set.
400	The response contains an error e.g.:- An attempt was made to create a host that already exists. An attempt was made to create a host with invalid data.
500	The response contains an error e.g. a failure occurred when propagating this topology update to other Node Managers.

---

Example Request and Response

POST https://localhost:8090/api/topology/hosts

{
    "name": "host1.com"
}

HTTP 1.1 201 Created

{
    "result": {
        "id" : "host-1",
        "name": "host1.com"          
    }
}