Bind to an address

In your load balancer configuration, a frontend listens for and receives connections from clients. A bind line in a frontend defines the IP address and port on which to listen.

You can manage your binds via the API by calling the endpoint /services/haproxy/configuration/binds.

List binds Jump to heading #

To get a list of existing binds in the fe_main frontend, make a GET request to the binds endpoint. Pass the name of the frontend as an argument:

nix
curl -X GET \
  --user admin:adminpwd \
  "http://127.0.0.1:5555/v2/services/haproxy/configuration/binds?frontend=fe_main"

nix
curl -X GET \
  --user admin:adminpwd \
  "http://127.0.0.1:5555/v2/services/haproxy/configuration/binds?frontend=fe_main"

output
json
{
   "_version":3,
   "data":[{
      "name":"http",
      "port":80
   }]
}

output
json
{
   "_version":3,
   "data":[{
      "name":"http",
      "port":80
   }]
}

List a specific bind Jump to heading #

To get information about a specific bind, add its name to the GET call. In the example below, we pass the name https at the end of the endpoint URL:

nix
curl -X GET \
  --user admin:adminpwd \
  "http://127.0.0.1:5555/v2/services/haproxy/configuration/binds/https?frontend=fe_main"

nix
curl -X GET \
  --user admin:adminpwd \
  "http://127.0.0.1:5555/v2/services/haproxy/configuration/binds/https?frontend=fe_main"

output
json
{
   "_version":3,
   "data":{
      "address":"*",
      "alpn":"h2",
      "name":"https",
      "port":443,
      "ssl":true,
      "ssl_certificate":"/etc/haproxy/ssl/cert.pem"
   }
}

output
json
{
   "_version":3,
   "data":{
      "address":"*",
      "alpn":"h2",
      "name":"https",
      "port":443,
      "ssl":true,
      "ssl_certificate":"/etc/haproxy/ssl/cert.pem"
   }
}

Add a bind Jump to heading #

Add a bind to the fe_main frontend by making a POST request to the binds endpoint. Send the fields to set in the body of the request. Note that in this case, because we are sending an update, we also include the version URL parameter:

nix
CFGVER=$(curl -s -u admin:adminpwd http://localhost:5555/v2/services/haproxy/configuration/version)
curl -X POST \
  --user admin:adminpwd \
  -H "Content-Type: application/json" \
  -d '{
     "name": "https",
     "address": "*",
     "port": 443,
     "alpn": "h2",
     "ssl": true,
     "ssl_certificate": "/etc/haproxy/ssl/cert.pem"
  }' \
  "http://127.0.0.1:5555/v2/services/haproxy/configuration/binds?frontend=fe_main&version=$CFGVER"

nix
CFGVER=$(curl -s -u admin:adminpwd http://localhost:5555/v2/services/haproxy/configuration/version)
curl -X POST \
  --user admin:adminpwd \
  -H "Content-Type: application/json" \
  -d '{
     "name": "https",
     "address": "*",
     "port": 443,
     "alpn": "h2",
     "ssl": true,
     "ssl_certificate": "/etc/haproxy/ssl/cert.pem"
  }' \
  "http://127.0.0.1:5555/v2/services/haproxy/configuration/binds?frontend=fe_main&version=$CFGVER"

Replace a bind Jump to heading #

To make changes to a bind, you replace it entirely. To replace an existing bind, make a PUT request to the binds endpoint, passing the name of the bind at the end of the URL path. In this case, we are updating the bind named https:

nix
CFGVER=$(curl -s -u admin:adminpwd http://localhost:5555/v2/services/haproxy/configuration/version)
curl -X PUT \
   --user admin:adminpwd \
   -H "Content-Type: application/json" \
    -d '{
      "address":"*",
      "alpn":"h2",
      "name":"https",
      "port":8443,
      "ssl":true,
      "ssl_certificate":"/etc/haproxy/ssl/cert.pem"
    }' \
   "http://127.0.0.1:5555/v2/services/haproxy/configuration/binds/https?frontend=fe_main&version=$CFGVER"

nix
CFGVER=$(curl -s -u admin:adminpwd http://localhost:5555/v2/services/haproxy/configuration/version)
curl -X PUT \
   --user admin:adminpwd \
   -H "Content-Type: application/json" \
    -d '{
      "address":"*",
      "alpn":"h2",
      "name":"https",
      "port":8443,
      "ssl":true,
      "ssl_certificate":"/etc/haproxy/ssl/cert.pem"
    }' \
   "http://127.0.0.1:5555/v2/services/haproxy/configuration/binds/https?frontend=fe_main&version=$CFGVER"

Delete a bind Jump to heading #

To delete a bind, use the DELETE method:

nix
CFGVER=$(curl -s -u admin:adminpwd http://localhost:5555/v2/services/haproxy/configuration/version)
curl -X DELETE \
  --user admin:adminpwd \
  "http://127.0.0.1:5555/v2/services/haproxy/configuration/binds/https?frontend=fe_main&version=$CFGVER"

nix
CFGVER=$(curl -s -u admin:adminpwd http://localhost:5555/v2/services/haproxy/configuration/version)
curl -X DELETE \
  --user admin:adminpwd \
  "http://127.0.0.1:5555/v2/services/haproxy/configuration/binds/https?frontend=fe_main&version=$CFGVER"