Update load balancer pool

curl --request PATCH \
  --url https://api.gcore.com/cloud/v1/lbpools/{project_id}/{region_id}/{pool_id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ca_secret_id": "<string>",
  "crl_secret_id": "<string>",
  "healthmonitor": {
    "delay": 1073741824,
    "max_retries": 5,
    "timeout": 123,
    "expected_codes": "200,301,302",
    "http_method": "CONNECT",
    "max_retries_down": 5,
    "type": "HTTP",
    "url_path": "/"
  },
  "lb_algorithm": "LEAST_CONNECTIONS",
  "members": [
    {
      "address": "192.168.40.33",
      "id": "a7e7e8d6-0bf7-4ac9-8170-831b47ee2ba9",
      "operating_status": "NO_MONITOR",
      "protocol_port": 80,
      "subnet_id": "32283b0b-b560-4690-810c-f672cbb2e28d",
      "weight": 1
    }
  ],
  "name": "<string>",
  "protocol": "HTTP",
  "secret_id": "<string>",
  "session_persistence": {
    "type": "APP_COOKIE",
    "cookie_name": "cookie_name",
    "persistence_granularity": "<string>",
    "persistence_timeout": 123
  },
  "timeout_client_data": 50000,
  "timeout_member_connect": 50000,
  "timeout_member_data": 0
}
'

{
  "tasks": [
    "<string>"
  ]
}

PATCH

cloud

lbpools

{project_id}

{region_id}

{pool_id}

Update load balancer pool

curl --request PATCH \
  --url https://api.gcore.com/cloud/v1/lbpools/{project_id}/{region_id}/{pool_id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ca_secret_id": "<string>",
  "crl_secret_id": "<string>",
  "healthmonitor": {
    "delay": 1073741824,
    "max_retries": 5,
    "timeout": 123,
    "expected_codes": "200,301,302",
    "http_method": "CONNECT",
    "max_retries_down": 5,
    "type": "HTTP",
    "url_path": "/"
  },
  "lb_algorithm": "LEAST_CONNECTIONS",
  "members": [
    {
      "address": "192.168.40.33",
      "id": "a7e7e8d6-0bf7-4ac9-8170-831b47ee2ba9",
      "operating_status": "NO_MONITOR",
      "protocol_port": 80,
      "subnet_id": "32283b0b-b560-4690-810c-f672cbb2e28d",
      "weight": 1
    }
  ],
  "name": "<string>",
  "protocol": "HTTP",
  "secret_id": "<string>",
  "session_persistence": {
    "type": "APP_COOKIE",
    "cookie_name": "cookie_name",
    "persistence_granularity": "<string>",
    "persistence_timeout": 123
  },
  "timeout_client_data": 50000,
  "timeout_member_connect": 50000,
  "timeout_member_data": 0
}
'

{
  "tasks": [
    "<string>"
  ]
}

Authorizations

Authorization

string

header

required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

project_id

integer

required

Project ID

region_id

integer

required

Region ID

pool_id

string<uuid4>

required

Pool ID

Body

application/json

ca_secret_id

string<uuid4> | null

Secret ID of CA certificate bundle

crl_secret_id

string<uuid4> | null

Secret ID of CA revocation list file

healthmonitor

PatchLbHealthMonitorSerializer · object

New pool health monitor settings

Show child attributes

healthmonitor.delay

integer

required

The time, in seconds, between sending probes to members

Required range: 1 <= x <= 2147483647

healthmonitor.max_retries

integer

required

Number of successes before the member is switched to ONLINE state

Required range: 1 <= x <= 10

healthmonitor.timeout

integer

required

The maximum time to connect. Must be less than the delay value

Required range: x <= 2147483

healthmonitor.expected_codes

string | null

Expected HTTP response codes. Can be a single code or a range of codes. Can only be used together with HTTP or HTTPS health monitor type. For example, 200,202,300-302,401,403,404,500-504. If not specified, the default is 200.

Example:

"200,301,302"

healthmonitor.http_method

enum<string> | null

HTTP method. Can only be used together with HTTP or HTTPS health monitor type.

Available options:

CONNECT,

DELETE,

GET,

HEAD,

OPTIONS,

PATCH,

POST,

PUT,

TRACE

Example:

"CONNECT"

healthmonitor.max_retries_down

integer

Number of failures before the member is switched to ERROR state.

Required range: 1 <= x <= 10

healthmonitor.type

enum<string> | null

Health monitor type. Once health monitor is created, cannot be changed.

Available options:

HTTP,

HTTPS,

K8S,

PING,

TCP,

TLS-HELLO,

UDP-CONNECT

Example:

"HTTP"

healthmonitor.url_path

string | null

URL Path. Defaults to '/'. Can only be used together with HTTP or HTTPS health monitor type.

Minimum string length: 1

Example:

"/"

lb_algorithm

enum<string>

New load balancer pool algorithm of how to distribute requests

Available options:

LEAST_CONNECTIONS,

ROUND_ROBIN,

SOURCE_IP

members

CreateLbPoolMemberSerializer · object[] | null

New sequence of load balancer pool members. If members are the same (by address + port), they will be kept as is without recreation and downtime.

Show child attributes

members.address

string<ipvanyaddress>

required

Member IP address

members.protocol_port

integer

required

Member IP port

members.admin_state_up

boolean

default:true

Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. When null is passed, the value is skipped and defaults to true.

members.backup

boolean

default:false

Set to true if the member is a backup member, to which traffic will be sent exclusively when all non-backup members will be unreachable. It allows to realize ACTIVE-BACKUP load balancing without thinking about VRRP and VIP configuration. Default is false.

members.instance_id

string<uuid4> | null

Either subnet_id or instance_id should be provided

Example:

"a7e7e8d6-0bf7-4ac9-8170-831b47ee2ba9"

members.monitor_address

string<ipvanyaddress> | null

An alternate IP address used for health monitoring of a backend member. Default is null which monitors the member address.

members.monitor_port

integer | null

An alternate protocol port used for health monitoring of a backend member. Default is null which monitors the member protocol_port.

members.subnet_id

string<uuid4> | null

subnet_id in which address is present. Either subnet_id or instance_id should be provided

Example:

"32283b0b-b560-4690-810c-f672cbb2e28d"

members.weight

integer

Member weight. Valid values are 0 < weight <= 256, defaults to 1. Controls traffic distribution based on the pool's load balancing algorithm:

ROUND_ROBIN: Distributes connections to each member in turn according to weights. Higher weight = more turns in the cycle. Example: weights 3 vs 1 = ~75% vs ~25% of requests.
LEAST_CONNECTIONS: Sends new connections to the member with fewest active connections, performing round-robin within groups of the same normalized load. Higher weight = allowed to hold more simultaneous connections before being considered 'more loaded'. Example: weights 2 vs 1 means 20 vs 10 active connections is treated as balanced.
SOURCE_IP: Routes clients consistently to the same member by hashing client source IP; hash result is modulo total weight of running members. Higher weight = more hash buckets, so more client IPs map to that member. Example: weights 2 vs 1 = roughly two-thirds of distinct client IPs map to the higher-weight member.

Required range: x <= 256

Example:

[
  {
    "address": "192.168.40.33",
    "id": "a7e7e8d6-0bf7-4ac9-8170-831b47ee2ba9",
    "operating_status": "NO_MONITOR",
    "protocol_port": 80,
    "subnet_id": "32283b0b-b560-4690-810c-f672cbb2e28d",
    "weight": 1
  }
]

name

string

New pool name

protocol

enum<string>

New communication protocol

Available options:

HTTP,

HTTPS,

PROXY,

PROXYV2,

TCP,

UDP

secret_id

string<uuid4> | null

Secret ID for TLS client authentication to the member servers

session_persistence

MutateLbSessionPersistence · object

New session persistence settings

Show child attributes

session_persistence.type

enum<string>

required

Session persistence type

Available options:

APP_COOKIE,

HTTP_COOKIE,

SOURCE_IP

Should be set if app cookie or http cookie is used

Example:

"cookie_name"

session_persistence.persistence_granularity

string | null

Subnet mask if source_ip is used. For UDP ports only

session_persistence.persistence_timeout

integer | null

Session persistence timeout. For UDP ports only

timeout_client_data

integer | null

Frontend client inactivity timeout in milliseconds

Required range: 0 <= x <= 86400000

Example:

50000

timeout_member_connect

integer | null

Backend member connection timeout in milliseconds

Required range: 0 <= x <= 86400000

Example:

50000

timeout_member_data

integer | null

Backend member inactivity timeout in milliseconds

Required range: 0 <= x <= 86400000

Example:

0

Response

200 - application/json

tasks

string[]

required

List of task IDs representing asynchronous operations. Use these IDs to monitor operation progress:

GET /v1/tasks/{task_id} - Check individual task status and details Poll task status until completion (FINISHED/ERROR) before proceeding with dependent operations.

Delete load balancer pool Create load balancer pool health monitor

⌘I

Overview

IAM

CDN

Managed DNS

Cloud

DDoS Protection

FastEdge

WAAP

Streaming

Object Storage

Resellers

Update load balancer pool

Authorizations

Path Parameters

Body

Response