Delete Load Balancer Backend Group

DELETE

/gateway/{gateway_id}/target-groups/{group_id}/

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

import requests

response = requests.delete(
    "https://api.e2enetworks.com/myaccount/api/v1/gpu/gateway/{gateway_id}/target-groups/{group_id}/",
    params={"project_id": "<PROJECT_ID>", "location": "<LOCATION>", "apikey": "<API_KEY>"},
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
print(response.json())

const url = new URL("https://api.e2enetworks.com/myaccount/api/v1/gpu/gateway/{gateway_id}/target-groups/{group_id}/");
url.search = new URLSearchParams({ project_id: "<PROJECT_ID>", location: "<LOCATION>", apikey: "<API_KEY>" });

const response = await fetch(url, {
  method: "DELETE",
  headers: { "Authorization": "Bearer <API_TOKEN>" },
});
console.log(await response.json());

Deletes a backend group and its backends. A group that an Active Rule still sends traffic to cannot be deleted; remove it from the Rule first. Needs the Delete permission for Load Balancers.

Parameters

Path Parameters

gateway_id

required

integer

Load Balancer ID

group_id

required

integer

Backend group 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 group was deleted

application/json

object

code

integer

message

string

data

object

deleted

boolean

errors

object

Example

{
  "code": 200,
  "message": "Success",
  "data": {
    "deleted": true
  },
  "errors": {}
}

400

The group could not be deleted; errors is the error text. The same 400 is returned, with the project’s own text, when project_id is missing or not a number.

application/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.

application/json

object

code

integer

message

string

data

object

errors

string

Example

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

412

No backend group with that ID on this Load Balancer (errors is “Target group not found.”), or an Active Rule still sends traffic to it.

application/json

object

code

integer

message

string

data

object

errors

string

Example

{
  "code": 412,
  "message": "Precondition Failed",
  "data": {},
  "errors": "This target group is still referenced by a routing rule. Remove it from the rule first."
}