List Load Balancer Backend Groups

GET

/gateway/{gateway_id}/target-groups/

curl --request GET \
  --url 'https://api.e2enetworks.com/myaccount/api/v1/gpu/gateway/{gateway_id}/target-groups/?project_id=<PROJECT_ID>&location=<LOCATION>&apikey=<API_KEY>' \
  --header 'Authorization: Bearer <API_TOKEN>'

Returns the backend groups of one Load Balancer, oldest first, each with its backends. Needs the Read permission for Load Balancers.

Parameters

Path Parameters

gateway_id

required

integer

Load Balancer ID

Query Parameters

project_id

required

integer

Project ID

active_iam

integer

Active IAM ID (To access contact person account) Find your Active IAM ID here

location

required

string

Allowed values: Delhi Chennai

Location

Responses

200

The backend groups

Media typeapplication/json

object

code

integer

message

string

data

Array<object>

object

id

integer

name

The group’s name.

string

backend_type

What kind of backend the group holds.

string

Allowed values: vm inference autoscale raw_ip

algorithm

How requests are spread across the group. null uses the Load Balancer’s algorithm.

string

nullable

port

The port the group’s backends listen on.

integer

protocol

HTTP, HTTPS or GRPC.

string

health_check_config

How the group’s backends are checked. An empty object {} uses the Load Balancer’s own health check.

object

protocol

TCP, HTTP or GRPC.

string

path

Path to request. For HTTP only. Defaults to /.

string

expected_statuses

Status codes that count as healthy. For HTTP only. Defaults to [200].

Array<integer>

interval_seconds

Seconds between checks. Defaults to 10.

integer

timeout_seconds

Seconds to wait for an answer. Defaults to 3.

integer

healthy_threshold

Passed checks in a row before an unhealthy backend gets traffic again. Defaults to 2.

integer

unhealthy_threshold

Failed checks in a row before a backend stops getting traffic. Defaults to 3.

integer

request_timeout_seconds

Seconds a request to the group may take. null when not set.

integer

nullable

retry_attempts

Times a failed request is sent again. null when not set.

integer

nullable

targets

The backends of the group, in the order they were added.

Array<object>

object

id

integer

ip_address

string

nullable

port

integer

weight

integer

name

string

nullable

resource_ref

Set for vm, inference and autoscale backends.

string

nullable

created_at

string

updated_at

string

errors

object

Example

{
  "code": 200,
  "message": "Success",
  "data": [
    {
      "id": 7,
      "name": "api-pool",
      "backend_type": "vm",
      "algorithm": "ROUND_ROBIN",
      "port": 80,
      "protocol": "HTTP",
      "health_check_config": {
        "protocol": "HTTP",
        "path": "/healthz",
        "interval_seconds": 10
      },
      "request_timeout_seconds": 300,
      "retry_attempts": 0,
      "targets": [
        {
          "id": 31,
          "ip_address": "203.0.113.10",
          "port": 8080,
          "weight": 1,
          "name": "web-1",
          "resource_ref": null
        }
      ],
      "created_at": "2026-10-21T11:17:29Z",
      "updated_at": "2026-10-21T11:17:29Z"
    }
  ],
  "errors": {}
}

400

project_id is missing or not a number. errors holds the project’s own text.

Media typeapplication/json

object

code

integer

message

string

data

object

errors

string

Example

{
  "code": 400,
  "message": "Bad Request",
  "data": {}
}

404

No Load Balancer with that ID in the project and region.

Media typeapplication/json

object

code

integer

message

string

data

object

errors

string

Example

{
  "code": 404,
  "message": "Bad Request",
  "data": {},
  "errors": "Gateway not found"
}