Responses

  • 200 application/json

    200

    Hide response attribute Show response attribute object
    • load-balancers array[object]

      Load Balancer

      Hide load-balancers attributes Show load-balancers attributes object
      • id string(uuid)

        Load Balancer ID

      • description string

        Load Balancer description

        Maximum length is 255.

      • name string

        Load Balancer name

        Minimum length is 1, maximum length is 255.

      • state string

        Load Balancer state

        Values are creating, migrated, deleting, running, migrating, or error.

      • created-at string(date-time)

        Load Balancer creation date

      • ip string(ipv4)

        Load Balancer public IP

      • services array[object]

        Load Balancer Services

        Load Balancer Service

        Hide services attributes Show services attributes object
        • description string

          Load Balancer Service description

          Maximum length is 255.

        • protocol string

          Network traffic protocol

          Values are tcp or udp.

        • name string

          Load Balancer Service name

          Minimum length is 1, maximum length is 255.

        • state string

          Load Balancer Service state

          Values are creating, deleting, running, updating, or error.

        • target-port integer(int64)

          Port on which the network traffic will be forwarded to on the receiving instance

          Minimum value is 0.

        • port integer(int64)

          Port exposed on the Load Balancer's public IP

          Minimum value is 0.

        • instance-pool object

          Instance Pool

          Hide instance-pool attributes Show instance-pool attributes object
          • application-consistent-snapshot-enabled boolean

            Enable application consistent snapshots

          • anti-affinity-groups array[object]

            Instance Pool Anti-affinity Groups

            Anti-affinity group reference

            Hide anti-affinity-groups attribute Show anti-affinity-groups attribute object
            • id string(uuid)

              Anti-affinity group ID

          • description string

            Instance Pool description

            Minimum length is 1, maximum length is 255.

          • public-ip-assignment string

            Values are inet4, dual, or none.

          • labels object
            Hide labels attribute Show labels attribute object
            • * string Additional properties
          • security-groups array[object]

            Instance Pool Security Groups

            Security group reference

            Hide security-groups attribute Show security-groups attribute object
            • id string(uuid)

              Security group ID

          • elastic-ips array[object]

            Instances Elastic IPs

            Elastic IP reference

            Hide elastic-ips attribute Show elastic-ips attribute object
            • id string(uuid)

              Elastic IP ID

          • name string

            Instance Pool name

            Minimum length is 1, maximum length is 255.

          • instance-type object

            Instance type reference

            Hide instance-type attribute Show instance-type attribute object
            • id string(uuid)

              Instance type ID

          • min-available integer(int64)

            Minimum number of running instances

            Minimum value is 0.

          • private-networks array[object]

            Instance Pool Private Networks

            Private network reference

            Hide private-networks attribute Show private-networks attribute object
            • id string(uuid)

              Private network ID

          • template object

            Template reference

            Hide template attribute Show template attribute object
            • id string(uuid)

              Template ID

          • state string

            Instance Pool state

            Values are scaling-up, scaling-down, destroying, creating, suspended, running, or updating.

          • size integer(int64)

            Number of instances

            Minimum value is 0.

          • ssh-key object

            SSH key reference

            Hide ssh-key attribute Show ssh-key attribute object
            • name string

              SSH key name

              Minimum length is 1, maximum length is 255.

          • instance-prefix string

            The instances created by the Instance Pool will be prefixed with this value (default: pool)

            Minimum length is 1, maximum length is 30.

          • user-data string

            Instances Cloud-init user-data

            Minimum length is 1.

          • manager object

            Resource manager

            Hide manager attributes Show manager attributes object
            • id string(uuid)

              Manager ID

            • type string

              Manager type

              Values are sks-nodepool or instance-pool.

          • instances array[object]

            Instances

            Target Instance

            Hide instances attribute Show instances attribute object
            • id string(uuid)

              Instance ID

          • deploy-target object

            Deploy target reference

            Hide deploy-target attribute Show deploy-target attribute object
            • id string(uuid)

              Deploy target ID

          • ipv6-enabled boolean

            Enable IPv6 for instances

          • id string(uuid)

            Instance Pool ID

          • disk-size integer(int64)

            Instances disk size in GiB

            Minimum value is 10, maximum value is 51200.

          • ssh-keys array[object]

            Instances SSH keys

            SSH key reference

            Hide ssh-keys attribute Show ssh-keys attribute object
            • name string

              SSH key name

              Minimum length is 1, maximum length is 255.

        • strategy string

          Load balancing strategy

          Values are round-robin, maglev-hash, or source-hash.

        • healthcheck object

          Load Balancer Service healthcheck

          Hide healthcheck attributes Show healthcheck attributes object
          • mode string

            Healthcheck mode

            Values are tcp, http, or https.

          • interval integer(int64)

            Healthcheck interval (default: 10). Must be greater than or equal to Timeout

            Minimum value is 5, maximum value is 300.

          • uri string

            An endpoint to use for the HTTP healthcheck, e.g. '/status'

            Minimum length is 1, maximum length is 255.

          • port integer(int64)

            Healthcheck port

            Minimum value is 1, maximum value is 65535.

          • timeout integer(int64)

            Healthcheck timeout value (default: 2). Must be lower than or equal to Interval

            Minimum value is 2, maximum value is 60.

          • retries integer(int64)

            Number of retries before considering a Service failed

            Minimum value is 1, maximum value is 20.

          • tls-sni string

            SNI domain for HTTPS healthchecks

            Minimum length is 1, maximum length is 255.

        • id string(uuid)

          Load Balancer Service ID

        • healthcheck-status array[object]

          Healthcheck status per backend server

          Load Balancer Service status

          Hide healthcheck-status attributes Show healthcheck-status attributes object
          • public-ip string(ipv4)

            Backend server public IP

          • status string

            Status of the instance's healthcheck

            Values are failure or success.

      • labels object
        Hide labels attribute Show labels attribute object
        • * string Additional properties
GET /load-balancer
curl \
 --request GET 'https://api-ch-gva-2.exoscale.com/v2/load-balancer'
Response examples (200)
{
  "load-balancers": [
    {
      "id": "string",
      "description": "string",
      "name": "string",
      "state": "creating",
      "created-at": "2026-05-04T09:42:00Z",
      "ip": "string",
      "services": [
        {
          "description": "string",
          "protocol": "tcp",
          "name": "string",
          "state": "creating",
          "target-port": 42,
          "port": 42,
          "instance-pool": {
            "application-consistent-snapshot-enabled": true,
            "anti-affinity-groups": [
              {
                "id": "string"
              }
            ],
            "description": "string",
            "public-ip-assignment": "inet4",
            "labels": {
              "additionalProperty1": "string",
              "additionalProperty2": "string"
            },
            "security-groups": [
              {
                "id": "string"
              }
            ],
            "elastic-ips": [
              {
                "id": "string"
              }
            ],
            "name": "string",
            "instance-type": {
              "id": "string"
            },
            "min-available": 42,
            "private-networks": [
              {
                "id": "string"
              }
            ],
            "template": {
              "id": "string"
            },
            "state": "scaling-up",
            "size": 42,
            "ssh-key": {
              "name": "string"
            },
            "instance-prefix": "string",
            "user-data": "string",
            "manager": {
              "id": "string",
              "type": "sks-nodepool"
            },
            "instances": [
              {
                "id": "string"
              }
            ],
            "deploy-target": {
              "id": "string"
            },
            "ipv6-enabled": true,
            "id": "string",
            "disk-size": 42,
            "ssh-keys": [
              {
                "name": "string"
              }
            ]
          },
          "strategy": "round-robin",
          "healthcheck": {
            "mode": "tcp",
            "interval": 42,
            "uri": "string",
            "port": 42,
            "timeout": 42,
            "retries": 42,
            "tls-sni": "string"
          },
          "id": "string",
          "healthcheck-status": [
            {
              "public-ip": "string",
              "status": "failure"
            }
          ]
        }
      ],
      "labels": {
        "additionalProperty1": "string",
        "additionalProperty2": "string"
      }
    }
  ]
}