Chapter 9. Add Node

When a node is added to a load balancer, it is assigned a unique identifier that can be used for management operations such as changing the condition or removing it.

For the node, enter the IP address that you recorded for your second Cloud Server created in Chapter 3, Create a New Cloud Server. For example, for the XML request, enter:

<node address="<IP address of SECOND cloud server>" port="80" condition="ENABLED"/>

The following examples show the cURL requests for Add Node:

Example 9.1. cURL Add Node Request: XML

curl-i -d \
'<?xml version="1.0" ?> 
<nodes xmlns="http://docs.openstack.org/loadbalancers/api/v1.0">
    <node address="<IP address of SECOND cloud server>" port="80" condition="ENABLED" />
</nodes>' \
-H 'X-Auth-Token: your_auth_token' \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
'https://dfw.loadbalancers.api.rackspacecloud.com/v1.0/your_acct_id/loadbalancers/load_balancer_id/nodes'

Example 9.2. cURL Add Node Request: JSON

curl -i -d \
'{
    "nodes": [
        {
            "address": "<IP address of SECOND cloud server>",
            "port": 80,
            "condition": "ENABLED"
        }
    ]
}' \
-H 'X-Auth-Token: your_auth_token' \
-H 'Content-Type: application/json' \
'https://dfw.loadbalancers.api.rackspacecloud.com/v1.0/your_acct_id/loadbalancers/load_balancer_id/nodes'

Remember to replace the names in the examples above with their actual respective values:

your_auth_token — as returned in your authentication response (see the examples in Chapter 5, Generate an Authentication Token)
your_acct_id — as returned in your authentication response (see the examples in Chapter 5, Generate an Authentication Token)
load_balancer_id — as returned in your create load balancer response (see the examples in Chapter 7, Create a Load Balancer)

The following examples show the responses for Add Node:

Example 9.3. Add Node Response: XML

<nodes xmlns="http://docs.openstack.org/loadbalancers/api/v1.0">
    <node
        address="108.166.67.215"
        id="44717"
        port="80"
        condition="ENABLED"
        status="ONLINE"
        weight="1"/>
</nodes>

Example 9.4. Add Node Response: JSON

{
    "nodes": [
        {
            "address": "108.166.67.215",
            "id": 44717,
            "port": 80,
            "status": "ONLINE",
            "condition": "ENABLED",
            "weight": 1
        }
    ]
}

Legal notices