Updated on 2025-08-29 GMT+08:00

Creating a Backend Server Group

Function

This API is used to create a backend server group.

Constraints

Note the following when you create a backend server group:

  • If session_persistence is specified, cookie_name is available only when type is set to APP_COOKIE.

  • If listener_id is specified, the listener must have no backend server group associated.

Calling Method

For details, see Calling APIs.

URI

POST /v3/{project_id}/elb/pools

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition: Specifies the project ID. For details about how to obtain a project ID, see Obtaining a Project ID.

Constraints: N/A

Range: The value can contain a maximum of 32 characters, including digits and lowercase letters.

Default value: N/A

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Definition: Specifies the token used for IAM authentication.

Constraints: N/A

Range: N/A

Default value: N/A

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

pool

Yes

CreatePoolOption object

Definition: Specifies the request parameters for creating a backend server group.

Constraints: N/A

Table 4 CreatePoolOption

Parameter

Mandatory

Type

Description

admin_state_up

No

Boolean

Definition: Specifies the administrative status of the backend server group.

Constraints: The value can only be true.

Range: true

Default value: true

az_affinity

No

AzAffinity object

Definition: Specifies how AZ affinity is configured for the backend server group.

Constraints: N/A

description

No

String

Definition: Provides supplementary information about the backend server group.

Constraints: N/A

Range: N/A

Default value: N/A

lb_algorithm

Yes

String

Definition: Specifies the load balancing algorithm used by the load balancer to route requests to backend servers in the associated backend server group.

Constraints:

  • If the value is SOURCE_IP or QUIC_CID, the weights of backend servers in the backend server group are invalid.

  • QUIC_CID is available only when the protocol of the backend server group is QUIC.

  • QUIC_CID is not supported.

Range:

  • ROUND_ROBIN: weighted round robin

  • LEAST_CONNECTIONS: weighted least connections

  • SOURCE_IP: source IP hash

  • QUIC_CID: connection ID

  • 2_TUPLE_HASH: 2-tuple hash that is only available for IP backend server groups

  • 3_TUPLE_HASH: 3-tuple hash that is only available for IP backend server groups

  • 5_TUPLE_HASH: 5-tuple hash that is only available for IP backend server groups

  • If this parameter is not specified for an IP backend server group, 5_TUPLE_HASH is used by default.

Default value: N/A

listener_id

No

String

Definition: Specifies the ID of the listener with which the backend server group is associated.

Constraints:

  • At least one of listener_id, loadbalancer_id, and type must be specified.

Range: N/A

Default value: N/A

loadbalancer_id

No

String

Definition: Specifies the ID of the load balancer with which the backend server group is associated.

Constraints:

  • At least one of listener_id, loadbalancer_id, and type must be specified.

Range: N/A

Default value: N/A

name

No

String

Definition: Specifies the backend server group name.

Constraints: N/A

Range: N/A

Default value: N/A

project_id

No

String

Definition: Specifies the project ID of the backend server group.

Constraints: N/A

Range: N/A

Default value: N/A

protocol

Yes

String

Definition: Specifies the protocol used by the backend server group to receive requests.

Constraints:

  • If the listener's protocol is UDP, the protocol of the backend server group must be UDP or QUIC.

  • If the listener's protocol is TCP, the protocol of the backend server group must be TCP.

  • If the listener's protocol is IP, the protocol of the backend server group must be IP.

  • If the listener's protocol is HTTP, the protocol of the backend server group must be HTTP.

  • If the listener's protocol is HTTPS, the protocol of the backend server group must be HTTP, HTTPS, or GRPC.

  • If the listener's protocol is TERMINATED_HTTPS, the protocol of the backend server group must be HTTP.

  • If the listener's protocol is QUIC, the protocol of the backend server group must be HTTP, HTTPS, or GRPC.

  • If the listener's protocol is TLS, the protocol of the backend server group can be TLS or TCP. If protocol of the backend server group is TCP, ip_version must be set to v4.

  • If the backend server group's protocol is QUIC, session_persistence must be set to true and type set to SOURCE_IP.

  • If the backend server group's protocol is GRPC, http2_enable of the listener must be set to true.

QUIC is not supported.

Range: TCP, UDP, IP, TLS, HTTP, HTTPS, GRPC, or QUIC

Default value: N/A

session_persistence

No

CreatePoolSessionPersistenceOption object

Definition: Specifies the sticky session.

Constraints: Slow start and sticky session cannot be enabled at the same time. If both are enabled, sticky session will be invalid.

slow_start

No

CreatePoolSlowStartOption object

Definition: Specifies slow start details. After you enable slow start, new backend servers added to the backend server group are warmed up, and the number of requests they can receive increases linearly during the configured slow start duration.

Constraints:

  • This parameter is valid only when the backend server group protocol is HTTP, HTTPS, or GRPC. For other protocols, an error will be reported.

  • Slow start and sticky session cannot be enabled at the same time. If both are enabled, sticky session will be invalid.

This parameter is not supported by gateway load balancers. Please do not use it.

member_deletion_protection_enable

No

Boolean

Definition: Whether to enable removal protection for the backend server. Once the option is enabled, backend servers cannot be removed from the backend server group.

Constraints:

Once the option is enabled, an error will be returned when the following APIs are called to:

  • Delete a load balancer and its associated resources (DELETE /v3/{project_id}/elb/loadbalancers/{loadbalancer_id}/force-elb).

  • Delete a load balancer and its associated EIPs (POST /v3/{project_id}/elb/loadbalancers/{loadbalancer_id}/delete-cascade).

  • Delete a listener and its associated resources (DELETE /v3/{project_id}/elb/listeners/{listener_id}/force).

  • Delete a backend server group and its associated resources (DELETE /v3/{project_id}/elb/pools/{pool_id}/delete-cascade).

  • Remove a backend server (DELETE /v3/{project_id}/elb/pools/{pool_id}/members/{member_id}).

  • Remove backend servers in batches (POST /v3/{project_id}/elb/pools/{pool_id}/members/batch-delete).

Range: false (disable this option) or true (enable this option).

Default value: false

NOTE:
Disable deletion protection or removal protection for your resources before deregistering your account.

This parameter is unsupported. Please do not use it.

vpc_id

No

String

Definition: Specifies the ID of the VPC where the backend server group works.

Constraints:

  • The backend server group must be associated with the VPC.

  • Only backend servers in the VPC or IP as backend servers can be added.

  • type must be set to instance.

  • vpc_id must be specified for IP backend server groups. The value must be the same as that defined by vpc_id for the load balancer.

  • If vpc_id is not specified, VPC ID is determined by the VPC where the backend server works.

Range: N/A

Default value: N/A

type

No

String

Definition: Specifies the backend server group type.

Constraints:

  • If this parameter is not passed, any type of backend servers can be added. type will be returned as an empty string.

  • At least one of listener_id, loadbalancer_id, and type must be specified.

Range:

  • instance: Any type of backend servers can be added. vpc_id is mandatory.

  • ip: Only IP as backend servers can be added. vpc_id cannot be specified. type cannot be set to ip if the backend server group protocol is IP.

Default value: N/A

ip_version

No

String

Definition: Specifies the IP address version supported by the backend server group.

Constraints: N/A

Default value: N/A

quic_cid_hash_strategy

No

QuicCidHashStrategy object

Definition: Specifies multi-path forwarding configuration based on destination connection IDs.

Constraints: N/A

Table 5 AzAffinity

Parameter

Mandatory

Type

Description

enable

Yes

Boolean

Definition: Specifies whether to enable AZ affinity for the backend server group. If this parameter is set to true, ELB forwards traffic across the backend servers in the same AZ as the load balancer.

Constraints:

  • This parameter is available only for IP, TCP, and UDP backend server groups.

  • This parameter is not available for backend server groups that are associated with TLS listeners.

  • If the parameter is set to true, parameter pool_health will be ignored.

Range: false (disable this option) or true (enable this option).

Default value: N/A

az_minimum_healthy_member_percentage

No

Integer

Definition: Specifies a percentage that is used to determine the health of an AZ. If the percentage of healthy servers in the AZ of the load balancer falls below the specified value, az_unhealthy_fallback_strategy is triggered. az_minimum_healthy_member_percentage shows the percentage of backend servers that are healthy in a backend server group of an AZ. The number of healthy servers is rounded up. For example, in AZ A, if there are three backend servers in the backend server group and az_minimum_healthy_member_percentage is set to 66%, the number of healthy servers is rounded up to 2 (3 × 0.66 = 1.98). If there are fewer than two healthy servers in AZ A, az_unhealthy_fallback_strategy is triggered. If az_minimum_healthy_member_percentage is set to 67%, the number of healthy servers is rounded up to 3 (3 × 0.67 = 2.01). If there are fewer than three healthy servers in AZ A, az_unhealthy_fallback_strategy is triggered.

Constraints:

  • If enable is set to true, az_minimum_healthy_member_percentage and az_minimum_healthy_member_count cannot be set to -1 at the same time.

  • If enable is set to true, either az_minimum_healthy_member_percentage or az_minimum_healthy_member_count must be set to -1.

Range: an integer ranging from -1 to 100. -1 indicates that az_minimum_healthy_member_count takes effect.

Default value: N/A

az_minimum_healthy_member_count

No

Integer

Definition: Specifies a number that is used to determine the health of an AZ. If the number of healthy servers in the AZ of the load balancer falls below the specified value, az_unhealthy_fallback_strategy is triggered. az_minimum_healthy_member_count shows the number of healthy servers in a backend server group of an AZ.

Constraints:

  • If enable is set to true, az_minimum_healthy_member_percentage and az_minimum_healthy_member_count cannot be set to -1 at the same time.

  • If enable is set to true, either az_minimum_healthy_member_percentage or az_minimum_healthy_member_count must be set to -1.

Range: an integer ranging from -1 to 10000. -1 indicates that az_minimum_healthy_member_percentage takes effect.

Default value: N/A

az_unhealthy_fallback_strategy

No

String

Definition: Specifies how traffic will be distributed across backend servers in an AZ if the percentage or number of healthy servers in the AZ of the load balancer falls below the specified value.

Range:

  • forward_to_all_member_of_local_az: forwards requests across all backend servers in the same AZ as the load balancer, even if some servers are unhealthy.

  • forward_to_healthy_member_of_remote_az: forwards requests across healthy backend servers in different AZs from the load balancer.

  • forward_to_all_healthy_member: forwards requests across healthy backend servers in all AZs.

  • forward_to_all_member: forwards requests across all backend servers in all AZs, even if some servers are unhealthy.

Constraints: N/A

Default value: forward_to_all_member_of_local_az

Table 6 CreatePoolSessionPersistenceOption

Parameter

Mandatory

Type

Description

cookie_name

No

String

Definition: Specifies the cookie name.

Constraints:

  • This parameter takes effect only when type is set to APP_COOKIE. Otherwise, an error will be returned.

  • This parameter is not supported by gateway load balancers. Please do not use it.

Range: The value can contain a maximum of 1,024 characters.

Default value: N/A

This parameter is unsupported. Please do not use it.

type

Yes

String

Definition: Specifies the sticky session type.

Constraints:

  • If the protocol of the backend server group is TCP or UDP, only SOURCE_IP takes effect.

  • If the protocol of the backend server group is HTTP or HTTPS, only HTTP_COOKIE takes effect.

Range: SOURCE_IP, HTTP_COOKIE, or APP_COOKIE.

Default value: N/A

persistence_timeout

No

Integer

Definition: Specifies the stickiness duration, in minutes.

Constraints: This parameter will not take effect when type is set to APP_COOKIE.

Range:

  • If the protocol of the backend server group is TCP or UDP, the value ranges from 1 to 60, and the default value is 1.

  • If the protocol of the backend server group is HTTP or HTTPS, the value ranges from 1 to 1440, and the default value is 1440.

Default value: N/A

Table 7 CreatePoolSlowStartOption

Parameter

Mandatory

Type

Description

enable

No

Boolean

Definition: Specifies whether to enable slow start.

Constraints: N/A

Range:

  • true: This option will be enabled.

  • false: This option will be disabled.

Default value: false

duration

No

Integer

Definition: Specifies the slow start duration, in seconds.

Constraints: N/A

Range: 30 to 1200, in seconds.

Default value: 30

Table 8 QuicCidHashStrategy

Parameter

Mandatory

Type

Description

len

Yes

Integer

Definition: Specifies the length of the hash factor in the connection ID.

Constraints: This parameter is valid only when the load balancing algorithm is QUIC_CID.

Range: 1 to 20

Default value: 3

offset

Yes

Integer

Definition: Specifies the start position in the connection ID as the hash factor.

Constraints: This parameter is valid only when the load balancing algorithm is QUIC_CID.

Range: 0 to 19

Default value: 1

Response Parameters

Status code: 201

Table 9 Response body parameters

Parameter

Type

Description

request_id

String

Definition: Specifies the request ID.

Range: The value is automatically generated, and can contain characters including digits, lowercase letters, and hyphens (-).

pool

Pool object

Definition: Specifies the backend server group.

Table 10 Pool

Parameter

Type

Description

admin_state_up

Boolean

Definition: Specifies the administrative status of the backend server group. The value can only be true.

Range: true (enabled)

az_affinity

AzAffinity object

Definition: Specifies how AZ affinity is configured for the backend server group.

description

String

Definition: Provides supplementary information about the backend server group.

Range: N/A

healthmonitor_id

String

Definition: Specifies the ID of the health check configured for the backend server group.

Range: N/A

id

String

Definition: Specifies the backend server group ID.

Range: N/A

lb_algorithm

String

Definition: Specifies the load balancing algorithm used by the load balancer to route requests to backend servers in the associated backend server group.

Range:

  • ROUND_ROBIN: weighted round robin

  • LEAST_CONNECTIONS: weighted least connections

  • SOURCE_IP: source IP hash

  • QUIC_CID: connection ID

  • 2_TUPLE_HASH: 2-tuple hash that is only available for IP backend server groups

  • 3_TUPLE_HASH: 3-tuple hash that is only available for IP backend server groups

  • 5_TUPLE_HASH: 5-tuple hash that is only available for IP backend server groups

  • If this parameter is not specified for an IP backend server group, 5_TUPLE_HASH is used by default.

QUIC_CID is not supported.

listeners

Array of ListenerRef objects

Definition: Specifies the IDs of the listeners with which the backend server group is associated.

loadbalancers

Array of LoadBalancerRef objects

Definition: Specifies the IDs of the load balancers with which the backend server group is associated.

members

Array of MemberRef objects

Definition: Specifies the IDs of backend servers in the backend server group.

name

String

Definition: Specifies the backend server group name.

Range: N/A

project_id

String

Definition: Specifies the project ID of the backend server group.

Range: N/A

protocol

String

Definition: Specifies the protocol used by the backend server group to receive requests from the load balancer.

Constraints: N/A

Range: The value can be TCP, UDP, IP, TLS, HTTP, HTTPS, GRPC, or QUIC.

Default value: N/A

QUIC is not supported.

session_persistence

SessionPersistence object

Definition: Specifies the sticky session.

ip_version

String

Definition: Specifies the IP address version supported by the backend server group.

slow_start

SlowStart object

Definition: Specifies slow start details. After you enable slow start, new backend servers added to the backend server group are warmed up, and the number of requests they can receive increases linearly during the configured slow start duration.

This parameter is not supported by gateway load balancers. Please do not use it.

member_deletion_protection_enable

Boolean

Definition: Whether to enable removal protection for the backend server. Once the option is enabled, backend servers cannot be removed from the backend server group.

Constraints:

Once the option is enabled, an error will be returned when the following APIs are called to:

  • Delete a load balancer and its associated resources (DELETE /v3/{project_id}/elb/loadbalancers/{loadbalancer_id}/force-elb).

  • Delete a load balancer and its associated EIPs (POST /v3/{project_id}/elb/loadbalancers/{loadbalancer_id}/delete-cascade).

  • Delete a listener and its associated resources (DELETE /v3/{project_id}/elb/listeners/{listener_id}/force).

  • Delete a backend server group and its associated resources (DELETE /v3/{project_id}/elb/pools/{pool_id}/delete-cascade).

  • Remove a backend server (DELETE /v3/{project_id}/elb/pools/{pool_id}/members/{member_id}).

  • Remove backend servers in batches (POST /v3/{project_id}/elb/pools/{pool_id}/members/batch-delete).

Range: false (disable this option) or true (enable this option).

Default value: false

NOTE:
Disable deletion protection or removal protection for your resources before deregistering your account.

This parameter is unsupported. Please do not use it.

created_at

String

Definition: Specifies the creation time.

Range: The value must be a UTC time in the yyyy-MM-dd'T'HH:mm:ss'Z' format.

updated_at

String

Definition: Specifies the update time.

Range: The value must be a UTC time in the yyyy-MM-dd'T'HH:mm:ss'Z' format.

vpc_id

String

Definition: Specifies the ID of the VPC where the backend server group works.

Range: N/A

type

String

Definition: Specifies the backend server group type.

Range:

  • instance: Any type of backend servers can be added. vpc_id is mandatory.

  • ip: Only IP as backend servers can be added. vpc_id cannot be specified. type cannot be set to ip if the backend server group protocol is IP.

  • "": Any type of backend servers can be added.

any_port_enable

Boolean

Definition: Specifies whether to enable any_port_enable for a backend server group. If this option is enabled, the listener routes the requests to the backend server over the same port as the frontend port. If this option is disabled, the listener routes the requests over the port specified by protocol_port.

Constraints:

This option is available only for TCP, UDP, or QUIC backend server groups.

Range: false (disable this option) or true (enable this option).

This parameter is unsupported. Please do not use it.

connection_drain

ConnectionDrain object

Definition: Specifies the configurations of deregistration delay.

This parameter takes effect when:

  • A backend server is removed from a backend server group.

  • A backend server is detected unhealthy or health checks fail.

  • The weight of a backend server is 0.

This parameter is unsupported. Please do not use it.

enterprise_project_id

String

Definition: Specifies the ID of the enterprise project.

Range:

  • 0: The resource belongs to the default enterprise project.

  • A string in UUID format indicates a non-default enterprise project.

pool_health

PoolHealth object

Definition: Specifies the configurations of the pool health feature.

public_border_group

String

Definition: Specifies the public border group.

Range:

  • center: public border group of the central site

  • Edge site name: public border group of an edge site

This parameter is unsupported. Please do not use it.

quic_cid_hash_strategy

QuicCidHashStrategy object

Definition: Specifies multi-path distribution configuration based on destination connection IDs.

Table 11 AzAffinity

Parameter

Type

Description

enable

Boolean

Definition: Specifies whether to enable AZ affinity for the backend server group. If this parameter is set to true, ELB forwards traffic across the backend servers in the same AZ as the load balancer.

Constraints:

  • This parameter is available only for IP, TCP, and UDP backend server groups.

  • This parameter is not available for backend server groups that are associated with TLS listeners.

  • If the parameter is set to true, parameter pool_health will be ignored.

Range: false (disable this option) or true (enable this option).

Default value: N/A

az_minimum_healthy_member_percentage

Integer

Definition: Specifies a percentage that is used to determine the health of an AZ. If the percentage of healthy servers in the AZ of the load balancer falls below the specified value, az_unhealthy_fallback_strategy is triggered. az_minimum_healthy_member_percentage shows the percentage of backend servers that are healthy in a backend server group of an AZ. The number of healthy servers is rounded up. For example, in AZ A, if there are three backend servers in the backend server group and az_minimum_healthy_member_percentage is set to 66%, the number of healthy servers is rounded up to 2 (3 × 0.66 = 1.98). If there are fewer than two healthy servers in AZ A, az_unhealthy_fallback_strategy is triggered. If az_minimum_healthy_member_percentage is set to 67%, the number of healthy servers is rounded up to 3 (3 × 0.67 = 2.01). If there are fewer than three healthy servers in AZ A, az_unhealthy_fallback_strategy is triggered.

Constraints:

  • If enable is set to true, az_minimum_healthy_member_percentage and az_minimum_healthy_member_count cannot be set to -1 at the same time.

  • If enable is set to true, either az_minimum_healthy_member_percentage or az_minimum_healthy_member_count must be set to -1.

Range: an integer ranging from -1 to 100. -1 indicates that az_minimum_healthy_member_count takes effect.

Default value: N/A

az_minimum_healthy_member_count

Integer

Definition: Specifies a number that is used to determine the health of an AZ. If the number of healthy servers in the AZ of the load balancer falls below the specified value, az_unhealthy_fallback_strategy is triggered. az_minimum_healthy_member_count shows the number of healthy servers in a backend server group of an AZ.

Constraints:

  • If enable is set to true, az_minimum_healthy_member_percentage and az_minimum_healthy_member_count cannot be set to -1 at the same time.

  • If enable is set to true, either az_minimum_healthy_member_percentage or az_minimum_healthy_member_count must be set to -1.

Range: an integer ranging from -1 to 10000. -1 indicates that az_minimum_healthy_member_percentage takes effect.

Default value: N/A

az_unhealthy_fallback_strategy

String

Definition: Specifies how traffic will be distributed across backend servers in an AZ if the percentage or number of healthy servers in the AZ of the load balancer falls below the specified value.

Range:

  • forward_to_all_member_of_local_az: forwards requests across all backend servers in the same AZ as the load balancer, even if some servers are unhealthy.

  • forward_to_healthy_member_of_remote_az: forwards requests across healthy backend servers in different AZs from the load balancer.

  • forward_to_all_healthy_member: forwards requests across healthy backend servers in all AZs.

  • forward_to_all_member: forwards requests across all backend servers in all AZs, even if some servers are unhealthy.

Constraints: N/A

Default value: forward_to_all_member_of_local_az

Table 12 ListenerRef

Parameter

Type

Description

id

String

Definition: Specifies the listener ID.

Range: N/A

Table 13 LoadBalancerRef

Parameter

Type

Description

id

String

Definition: Specifies the load balancer ID.

Table 14 MemberRef

Parameter

Type

Description

id

String

Definition: Specifies the backend server ID.

Table 15 SessionPersistence

Parameter

Type

Description

cookie_name

String

Definition: Specifies the cookie name.

Range: The value can contain a maximum of 1,024 characters.

This parameter is unsupported. Please do not use it.

type

String

Definition: Specifies the sticky session type.

Constraints:

  • If the protocol of the backend server group is TCP or UDP, only SOURCE_IP takes effect.

  • If the protocol of the backend server group is HTTP or HTTPS, only HTTP_COOKIE takes effect.

Range: SOURCE_IP, HTTP_COOKIE, or APP_COOKIE.

persistence_timeout

Integer

Definition: Specifies the stickiness duration, in minutes. This parameter will not take effect when type is set to APP_COOKIE.

Range:

  • If the protocol of the backend server group is TCP, UDP, or QUIC, the value ranges from 1 to 60, and the default value is 1.

  • If the protocol of the backend server group is HTTP or HTTPS, the value ranges from 1 to 1440, and the default value is 1440.

Table 16 SlowStart

Parameter

Type

Description

enable

Boolean

Definition: Specifies whether to enable slow start.

Range:

  • true: This option will be enabled.

  • false: This option will be disabled.

duration

Integer

Definition: Specifies the slow start duration, in seconds.

Range: 30 to 1200, in seconds.

Table 17 ConnectionDrain

Parameter

Type

Description

enable

Boolean

Definition: Specifies whether to enable connection_drain.

Constraints: N/A

Range: The value can be true (enable this option) or false (disable this option).

Default value: N/A

timeout

Integer

Definition: Specifies the deregistration delay timeout, in seconds.

Constraints: N/A

Range: 10 to 4000, in seconds.

Constraints: N/A

Table 18 PoolHealth

Parameter

Type

Description

minimum_healthy_member_count

Integer

Definition: Specifies the number of healthy backend servers below which the backend server group is considered as unhealthy.

Constraints: N/A

Range:

  • 0 (default): pool_health does not take effect.

  • 1: pool_health takes effect.

Default value: N/A

This parameter is unsupported. Please do not use it.

Table 19 QuicCidHashStrategy

Parameter

Type

Description

len

Integer

Definition: Specifies the length of the hash factor in the connection ID.

Constraints: This parameter is valid only when the load balancing algorithm is QUIC_CID.

Range: 1 to 20

Default value: 3

offset

Integer

Definition: Specifies the start position in the connection ID as the hash factor.

Constraints: This parameter is valid only when the load balancing algorithm is QUIC_CID.

Range: 0 to 19

Default value: 1

Example Requests

  • Creating a backend server group and setting its backend protocol to TCP

    POST https://{ELB_Endpoint}/v3/99a3fff0d03c428eac3678da6a7d0f24/elb/pools
    
    {
      "pool" : {
        "name" : "My pool",
        "lb_algorithm" : "LEAST_CONNECTIONS",
        "listener_id" : "0b11747a-b139-492f-9692-2df0b1c87193",
        "protocol" : "TCP",
        "member_deletion_protection_enable" : false
      }
    }
  • Creating a backend server group and setting its backend protocol to HTTP

    POST https://{ELB_Endpoint}/v3/99a3fff0d03c428eac3678da6a7d0f24/elb/pools
    
    {
      "pool" : {
        "name" : "My pool",
        "lb_algorithm" : "LEAST_CONNECTIONS",
        "listener_id" : "0b11747a-b139-492f-9692-2df0b1c87193",
        "protocol" : "HTTP",
        "slow_start" : {
          "enable" : true,
          "duration" : 50
        },
        "member_deletion_protection_enable" : false
      }
    }
  • Creating an IP backend server group for a gateway load balancer

    POST https://{ELB_Endpoint}/v3/99a3fff0d03c428eac3678da6a7d0f24/elb/pools
    
    {
      "pool" : {
        "name" : "My IP pool",
        "lb_algorithm" : "2_tuple_hash",
        "listener_id" : "0b11747a-b139-492f-9692-2df0b1c87193",
        "protocol" : "IP",
        "type" : "instance",
        "member_deletion_protection_enable" : false
      }
    }

Example Responses

Status code: 201

Successful request.

{
  "pool" : {
    "type" : "",
    "vpc_id" : "",
    "lb_algorithm" : "LEAST_CONNECTIONS",
    "protocol" : "TCP",
    "description" : "",
    "admin_state_up" : true,
    "member_deletion_protection_enable" : false,
    "loadbalancers" : [ {
      "id" : "098b2f68-af1c-41a9-8efd-69958722af62"
    } ],
    "project_id" : "99a3fff0d03c428eac3678da6a7d0f24",
    "session_persistence" : null,
    "healthmonitor_id" : null,
    "listeners" : [ {
      "id" : "0b11747a-b139-492f-9692-2df0b1c87193"
    } ],
    "members" : [ ],
    "id" : "36ce7086-a496-4666-9064-5ba0e6840c75",
    "name" : "My pool",
    "ip_version" : "v4",
    "slow_start" : null
  },
  "request_id" : "2d974978-0733-404d-a21a-b29204f4803a"
}

Status Codes

Status Code

Description

201

Successful request.

Error Codes

See Error Codes.