published on Thursday, Apr 23, 2026 by Volcengine
published on Thursday, Apr 23, 2026 by Volcengine
A server group is a logical collection of backend servers. The ALB instance determines which server group to forward client requests to based on your configured forwarding rules. Then, the ALB instance distributes requests to backend servers within the server group according to your configured load balancing policy. Backend servers receive and process the requests.
Example Usage
Example coming soon!
Example coming soon!
Example coming soon!
Example coming soon!
Example coming soon!
resources:
albServergroupDemo:
type: volcenginecc:alb:ServerGroup
name: AlbServergroupDemo
properties:
vpcId: vpc-13f8***
serverGroupName: test-servergroup
serverGroupType: instance
protocol: HTTP
scheduler: wrr
crossZoneEnabled: on
healthCheck:
enabled: on
port: 80
interval: 2
timeout: 5
healthy_threshold: 3
unhealthy_threshold: 3
method: GET
http_version: HTTP1.1
uri: /health
http_code: http_2xx
stickySessionConfig:
sticky_session_enabled: on
sticky_session_type: insert
cookie_timeout: 1000
servers:
- instance_id: i-ye3***
type: ecs
ip: 192.168.1.**
port: 80
weight: 10
tags:
- key: env
value: test
Create ServerGroup Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new ServerGroup(name: string, args: ServerGroupArgs, opts?: CustomResourceOptions);@overload
def ServerGroup(resource_name: str,
args: ServerGroupArgs,
opts: Optional[ResourceOptions] = None)
@overload
def ServerGroup(resource_name: str,
opts: Optional[ResourceOptions] = None,
vpc_id: Optional[str] = None,
scheduler: Optional[str] = None,
health_check: Optional[ServerGroupHealthCheckArgs] = None,
ip_address_type: Optional[str] = None,
project_name: Optional[str] = None,
protocol: Optional[str] = None,
cross_zone_enabled: Optional[str] = None,
server_group_name: Optional[str] = None,
server_group_type: Optional[str] = None,
servers: Optional[Sequence[ServerGroupServerArgs]] = None,
status: Optional[str] = None,
sticky_session_config: Optional[ServerGroupStickySessionConfigArgs] = None,
tags: Optional[Sequence[ServerGroupTagArgs]] = None,
description: Optional[str] = None)func NewServerGroup(ctx *Context, name string, args ServerGroupArgs, opts ...ResourceOption) (*ServerGroup, error)public ServerGroup(string name, ServerGroupArgs args, CustomResourceOptions? opts = null)
public ServerGroup(String name, ServerGroupArgs args)
public ServerGroup(String name, ServerGroupArgs args, CustomResourceOptions options)
type: volcenginecc:alb:ServerGroup
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args ServerGroupArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args ServerGroupArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args ServerGroupArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ServerGroupArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ServerGroupArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
ServerGroup Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The ServerGroup resource accepts the following input properties:
- Vpc
Id string - ID of the VPC to which the backend server group belongs.
- Cross
Zone stringEnabled - Whether to enable cross-zone load balancing for the server group. Values: on (default): enabled, off: disabled.
- Description string
- Description of the backend server group.
- Health
Check Volcengine.Server Group Health Check - Server group health check configuration information.
- Ip
Address stringType - IP address type of the server group. Only IPv4 is supported.
- Project
Name string - Name of the project to which the backend server group belongs.
- Protocol string
- Backend protocol: HTTP, HTTPS.
- Scheduler string
- Scheduling algorithm. Parameter values: wrr: Weighted round robin. wlc: Weighted least connections. sh: Source IP hash.
- Server
Group stringName - Name of the backend server group.
- Server
Group stringType - Type of backend server group. instance: Server type. This type of server group supports adding ECS and ENI instances as backend servers. ip: IP type. This type of server group supports adding IP addresses as backend servers.
- Servers
List<Volcengine.
Server Group Server> - Status string
- Server group status. Creating: creating. Active: running. Configuring: configuring. Deleting: deleting.
- Sticky
Session Volcengine.Config Server Group Sticky Session Config - Session persistence parameter information.
-
List<Volcengine.
Server Group Tag>
- Vpc
Id string - ID of the VPC to which the backend server group belongs.
- Cross
Zone stringEnabled - Whether to enable cross-zone load balancing for the server group. Values: on (default): enabled, off: disabled.
- Description string
- Description of the backend server group.
- Health
Check ServerGroup Health Check Args - Server group health check configuration information.
- Ip
Address stringType - IP address type of the server group. Only IPv4 is supported.
- Project
Name string - Name of the project to which the backend server group belongs.
- Protocol string
- Backend protocol: HTTP, HTTPS.
- Scheduler string
- Scheduling algorithm. Parameter values: wrr: Weighted round robin. wlc: Weighted least connections. sh: Source IP hash.
- Server
Group stringName - Name of the backend server group.
- Server
Group stringType - Type of backend server group. instance: Server type. This type of server group supports adding ECS and ENI instances as backend servers. ip: IP type. This type of server group supports adding IP addresses as backend servers.
- Servers
[]Server
Group Server Args - Status string
- Server group status. Creating: creating. Active: running. Configuring: configuring. Deleting: deleting.
- Sticky
Session ServerConfig Group Sticky Session Config Args - Session persistence parameter information.
-
[]Server
Group Tag Args
- vpc
Id String - ID of the VPC to which the backend server group belongs.
- cross
Zone StringEnabled - Whether to enable cross-zone load balancing for the server group. Values: on (default): enabled, off: disabled.
- description String
- Description of the backend server group.
- health
Check ServerGroup Health Check - Server group health check configuration information.
- ip
Address StringType - IP address type of the server group. Only IPv4 is supported.
- project
Name String - Name of the project to which the backend server group belongs.
- protocol String
- Backend protocol: HTTP, HTTPS.
- scheduler String
- Scheduling algorithm. Parameter values: wrr: Weighted round robin. wlc: Weighted least connections. sh: Source IP hash.
- server
Group StringName - Name of the backend server group.
- server
Group StringType - Type of backend server group. instance: Server type. This type of server group supports adding ECS and ENI instances as backend servers. ip: IP type. This type of server group supports adding IP addresses as backend servers.
- servers
List<Server
Group Server> - status String
- Server group status. Creating: creating. Active: running. Configuring: configuring. Deleting: deleting.
- sticky
Session ServerConfig Group Sticky Session Config - Session persistence parameter information.
-
List<Server
Group Tag>
- vpc
Id string - ID of the VPC to which the backend server group belongs.
- cross
Zone stringEnabled - Whether to enable cross-zone load balancing for the server group. Values: on (default): enabled, off: disabled.
- description string
- Description of the backend server group.
- health
Check ServerGroup Health Check - Server group health check configuration information.
- ip
Address stringType - IP address type of the server group. Only IPv4 is supported.
- project
Name string - Name of the project to which the backend server group belongs.
- protocol string
- Backend protocol: HTTP, HTTPS.
- scheduler string
- Scheduling algorithm. Parameter values: wrr: Weighted round robin. wlc: Weighted least connections. sh: Source IP hash.
- server
Group stringName - Name of the backend server group.
- server
Group stringType - Type of backend server group. instance: Server type. This type of server group supports adding ECS and ENI instances as backend servers. ip: IP type. This type of server group supports adding IP addresses as backend servers.
- servers
Server
Group Server[] - status string
- Server group status. Creating: creating. Active: running. Configuring: configuring. Deleting: deleting.
- sticky
Session ServerConfig Group Sticky Session Config - Session persistence parameter information.
-
Server
Group Tag[]
- vpc_
id str - ID of the VPC to which the backend server group belongs.
- cross_
zone_ strenabled - Whether to enable cross-zone load balancing for the server group. Values: on (default): enabled, off: disabled.
- description str
- Description of the backend server group.
- health_
check ServerGroup Health Check Args - Server group health check configuration information.
- ip_
address_ strtype - IP address type of the server group. Only IPv4 is supported.
- project_
name str - Name of the project to which the backend server group belongs.
- protocol str
- Backend protocol: HTTP, HTTPS.
- scheduler str
- Scheduling algorithm. Parameter values: wrr: Weighted round robin. wlc: Weighted least connections. sh: Source IP hash.
- server_
group_ strname - Name of the backend server group.
- server_
group_ strtype - Type of backend server group. instance: Server type. This type of server group supports adding ECS and ENI instances as backend servers. ip: IP type. This type of server group supports adding IP addresses as backend servers.
- servers
Sequence[Server
Group Server Args] - status str
- Server group status. Creating: creating. Active: running. Configuring: configuring. Deleting: deleting.
- sticky_
session_ Serverconfig Group Sticky Session Config Args - Session persistence parameter information.
-
Sequence[Server
Group Tag Args]
- vpc
Id String - ID of the VPC to which the backend server group belongs.
- cross
Zone StringEnabled - Whether to enable cross-zone load balancing for the server group. Values: on (default): enabled, off: disabled.
- description String
- Description of the backend server group.
- health
Check Property Map - Server group health check configuration information.
- ip
Address StringType - IP address type of the server group. Only IPv4 is supported.
- project
Name String - Name of the project to which the backend server group belongs.
- protocol String
- Backend protocol: HTTP, HTTPS.
- scheduler String
- Scheduling algorithm. Parameter values: wrr: Weighted round robin. wlc: Weighted least connections. sh: Source IP hash.
- server
Group StringName - Name of the backend server group.
- server
Group StringType - Type of backend server group. instance: Server type. This type of server group supports adding ECS and ENI instances as backend servers. ip: IP type. This type of server group supports adding IP addresses as backend servers.
- servers List<Property Map>
- status String
- Server group status. Creating: creating. Active: running. Configuring: configuring. Deleting: deleting.
- sticky
Session Property MapConfig - Session persistence parameter information.
- List<Property Map>
Outputs
All input properties are implicitly available as output properties. Additionally, the ServerGroup resource produces the following output properties:
- Create
Time string - Creation time of the backend server group.
- Id string
- The provider-assigned unique ID for this managed resource.
- Listeners
List<Volcengine.
Server Group Listener> - Server
Count int - Number of backend servers in the server group.
- Server
Group stringId - ID of the backend server group.
- Update
Time string - Last operation time of the backend server group.
- Create
Time string - Creation time of the backend server group.
- Id string
- The provider-assigned unique ID for this managed resource.
- Listeners
[]Server
Group Listener - Server
Count int - Number of backend servers in the server group.
- Server
Group stringId - ID of the backend server group.
- Update
Time string - Last operation time of the backend server group.
- create
Time String - Creation time of the backend server group.
- id String
- The provider-assigned unique ID for this managed resource.
- listeners
List<Server
Group Listener> - server
Count Integer - Number of backend servers in the server group.
- server
Group StringId - ID of the backend server group.
- update
Time String - Last operation time of the backend server group.
- create
Time string - Creation time of the backend server group.
- id string
- The provider-assigned unique ID for this managed resource.
- listeners
Server
Group Listener[] - server
Count number - Number of backend servers in the server group.
- server
Group stringId - ID of the backend server group.
- update
Time string - Last operation time of the backend server group.
- create_
time str - Creation time of the backend server group.
- id str
- The provider-assigned unique ID for this managed resource.
- listeners
Sequence[Server
Group Listener] - server_
count int - Number of backend servers in the server group.
- server_
group_ strid - ID of the backend server group.
- update_
time str - Last operation time of the backend server group.
- create
Time String - Creation time of the backend server group.
- id String
- The provider-assigned unique ID for this managed resource.
- listeners List<Property Map>
- server
Count Number - Number of backend servers in the server group.
- server
Group StringId - ID of the backend server group.
- update
Time String - Last operation time of the backend server group.
Look up Existing ServerGroup Resource
Get an existing ServerGroup resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: ServerGroupState, opts?: CustomResourceOptions): ServerGroup@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
create_time: Optional[str] = None,
cross_zone_enabled: Optional[str] = None,
description: Optional[str] = None,
health_check: Optional[ServerGroupHealthCheckArgs] = None,
ip_address_type: Optional[str] = None,
listeners: Optional[Sequence[ServerGroupListenerArgs]] = None,
project_name: Optional[str] = None,
protocol: Optional[str] = None,
scheduler: Optional[str] = None,
server_count: Optional[int] = None,
server_group_id: Optional[str] = None,
server_group_name: Optional[str] = None,
server_group_type: Optional[str] = None,
servers: Optional[Sequence[ServerGroupServerArgs]] = None,
status: Optional[str] = None,
sticky_session_config: Optional[ServerGroupStickySessionConfigArgs] = None,
tags: Optional[Sequence[ServerGroupTagArgs]] = None,
update_time: Optional[str] = None,
vpc_id: Optional[str] = None) -> ServerGroupfunc GetServerGroup(ctx *Context, name string, id IDInput, state *ServerGroupState, opts ...ResourceOption) (*ServerGroup, error)public static ServerGroup Get(string name, Input<string> id, ServerGroupState? state, CustomResourceOptions? opts = null)public static ServerGroup get(String name, Output<String> id, ServerGroupState state, CustomResourceOptions options)resources: _: type: volcenginecc:alb:ServerGroup get: id: ${id}- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Create
Time string - Creation time of the backend server group.
- Cross
Zone stringEnabled - Whether to enable cross-zone load balancing for the server group. Values: on (default): enabled, off: disabled.
- Description string
- Description of the backend server group.
- Health
Check Volcengine.Server Group Health Check - Server group health check configuration information.
- Ip
Address stringType - IP address type of the server group. Only IPv4 is supported.
- Listeners
List<Volcengine.
Server Group Listener> - Project
Name string - Name of the project to which the backend server group belongs.
- Protocol string
- Backend protocol: HTTP, HTTPS.
- Scheduler string
- Scheduling algorithm. Parameter values: wrr: Weighted round robin. wlc: Weighted least connections. sh: Source IP hash.
- Server
Count int - Number of backend servers in the server group.
- Server
Group stringId - ID of the backend server group.
- Server
Group stringName - Name of the backend server group.
- Server
Group stringType - Type of backend server group. instance: Server type. This type of server group supports adding ECS and ENI instances as backend servers. ip: IP type. This type of server group supports adding IP addresses as backend servers.
- Servers
List<Volcengine.
Server Group Server> - Status string
- Server group status. Creating: creating. Active: running. Configuring: configuring. Deleting: deleting.
- Sticky
Session Volcengine.Config Server Group Sticky Session Config - Session persistence parameter information.
-
List<Volcengine.
Server Group Tag> - Update
Time string - Last operation time of the backend server group.
- Vpc
Id string - ID of the VPC to which the backend server group belongs.
- Create
Time string - Creation time of the backend server group.
- Cross
Zone stringEnabled - Whether to enable cross-zone load balancing for the server group. Values: on (default): enabled, off: disabled.
- Description string
- Description of the backend server group.
- Health
Check ServerGroup Health Check Args - Server group health check configuration information.
- Ip
Address stringType - IP address type of the server group. Only IPv4 is supported.
- Listeners
[]Server
Group Listener Args - Project
Name string - Name of the project to which the backend server group belongs.
- Protocol string
- Backend protocol: HTTP, HTTPS.
- Scheduler string
- Scheduling algorithm. Parameter values: wrr: Weighted round robin. wlc: Weighted least connections. sh: Source IP hash.
- Server
Count int - Number of backend servers in the server group.
- Server
Group stringId - ID of the backend server group.
- Server
Group stringName - Name of the backend server group.
- Server
Group stringType - Type of backend server group. instance: Server type. This type of server group supports adding ECS and ENI instances as backend servers. ip: IP type. This type of server group supports adding IP addresses as backend servers.
- Servers
[]Server
Group Server Args - Status string
- Server group status. Creating: creating. Active: running. Configuring: configuring. Deleting: deleting.
- Sticky
Session ServerConfig Group Sticky Session Config Args - Session persistence parameter information.
-
[]Server
Group Tag Args - Update
Time string - Last operation time of the backend server group.
- Vpc
Id string - ID of the VPC to which the backend server group belongs.
- create
Time String - Creation time of the backend server group.
- cross
Zone StringEnabled - Whether to enable cross-zone load balancing for the server group. Values: on (default): enabled, off: disabled.
- description String
- Description of the backend server group.
- health
Check ServerGroup Health Check - Server group health check configuration information.
- ip
Address StringType - IP address type of the server group. Only IPv4 is supported.
- listeners
List<Server
Group Listener> - project
Name String - Name of the project to which the backend server group belongs.
- protocol String
- Backend protocol: HTTP, HTTPS.
- scheduler String
- Scheduling algorithm. Parameter values: wrr: Weighted round robin. wlc: Weighted least connections. sh: Source IP hash.
- server
Count Integer - Number of backend servers in the server group.
- server
Group StringId - ID of the backend server group.
- server
Group StringName - Name of the backend server group.
- server
Group StringType - Type of backend server group. instance: Server type. This type of server group supports adding ECS and ENI instances as backend servers. ip: IP type. This type of server group supports adding IP addresses as backend servers.
- servers
List<Server
Group Server> - status String
- Server group status. Creating: creating. Active: running. Configuring: configuring. Deleting: deleting.
- sticky
Session ServerConfig Group Sticky Session Config - Session persistence parameter information.
-
List<Server
Group Tag> - update
Time String - Last operation time of the backend server group.
- vpc
Id String - ID of the VPC to which the backend server group belongs.
- create
Time string - Creation time of the backend server group.
- cross
Zone stringEnabled - Whether to enable cross-zone load balancing for the server group. Values: on (default): enabled, off: disabled.
- description string
- Description of the backend server group.
- health
Check ServerGroup Health Check - Server group health check configuration information.
- ip
Address stringType - IP address type of the server group. Only IPv4 is supported.
- listeners
Server
Group Listener[] - project
Name string - Name of the project to which the backend server group belongs.
- protocol string
- Backend protocol: HTTP, HTTPS.
- scheduler string
- Scheduling algorithm. Parameter values: wrr: Weighted round robin. wlc: Weighted least connections. sh: Source IP hash.
- server
Count number - Number of backend servers in the server group.
- server
Group stringId - ID of the backend server group.
- server
Group stringName - Name of the backend server group.
- server
Group stringType - Type of backend server group. instance: Server type. This type of server group supports adding ECS and ENI instances as backend servers. ip: IP type. This type of server group supports adding IP addresses as backend servers.
- servers
Server
Group Server[] - status string
- Server group status. Creating: creating. Active: running. Configuring: configuring. Deleting: deleting.
- sticky
Session ServerConfig Group Sticky Session Config - Session persistence parameter information.
-
Server
Group Tag[] - update
Time string - Last operation time of the backend server group.
- vpc
Id string - ID of the VPC to which the backend server group belongs.
- create_
time str - Creation time of the backend server group.
- cross_
zone_ strenabled - Whether to enable cross-zone load balancing for the server group. Values: on (default): enabled, off: disabled.
- description str
- Description of the backend server group.
- health_
check ServerGroup Health Check Args - Server group health check configuration information.
- ip_
address_ strtype - IP address type of the server group. Only IPv4 is supported.
- listeners
Sequence[Server
Group Listener Args] - project_
name str - Name of the project to which the backend server group belongs.
- protocol str
- Backend protocol: HTTP, HTTPS.
- scheduler str
- Scheduling algorithm. Parameter values: wrr: Weighted round robin. wlc: Weighted least connections. sh: Source IP hash.
- server_
count int - Number of backend servers in the server group.
- server_
group_ strid - ID of the backend server group.
- server_
group_ strname - Name of the backend server group.
- server_
group_ strtype - Type of backend server group. instance: Server type. This type of server group supports adding ECS and ENI instances as backend servers. ip: IP type. This type of server group supports adding IP addresses as backend servers.
- servers
Sequence[Server
Group Server Args] - status str
- Server group status. Creating: creating. Active: running. Configuring: configuring. Deleting: deleting.
- sticky_
session_ Serverconfig Group Sticky Session Config Args - Session persistence parameter information.
-
Sequence[Server
Group Tag Args] - update_
time str - Last operation time of the backend server group.
- vpc_
id str - ID of the VPC to which the backend server group belongs.
- create
Time String - Creation time of the backend server group.
- cross
Zone StringEnabled - Whether to enable cross-zone load balancing for the server group. Values: on (default): enabled, off: disabled.
- description String
- Description of the backend server group.
- health
Check Property Map - Server group health check configuration information.
- ip
Address StringType - IP address type of the server group. Only IPv4 is supported.
- listeners List<Property Map>
- project
Name String - Name of the project to which the backend server group belongs.
- protocol String
- Backend protocol: HTTP, HTTPS.
- scheduler String
- Scheduling algorithm. Parameter values: wrr: Weighted round robin. wlc: Weighted least connections. sh: Source IP hash.
- server
Count Number - Number of backend servers in the server group.
- server
Group StringId - ID of the backend server group.
- server
Group StringName - Name of the backend server group.
- server
Group StringType - Type of backend server group. instance: Server type. This type of server group supports adding ECS and ENI instances as backend servers. ip: IP type. This type of server group supports adding IP addresses as backend servers.
- servers List<Property Map>
- status String
- Server group status. Creating: creating. Active: running. Configuring: configuring. Deleting: deleting.
- sticky
Session Property MapConfig - Session persistence parameter information.
- List<Property Map>
- update
Time String - Last operation time of the backend server group.
- vpc
Id String - ID of the VPC to which the backend server group belongs.
Supporting Types
ServerGroupHealthCheck, ServerGroupHealthCheckArgs
- Domain string
- Domain name for health check. Configure this as the actual service address provided by the backend server. This parameter takes effect only when HealthCheck.Protocol is set to HTTP. The domain name must contain at least one '.', and cannot start or end with '.'. Each level of the domain name can contain letters, digits, '-', and '.' characters, and '-' cannot appear at the beginning or end of any level. Length: 1–128 characters. If this parameter is not specified or no value is provided, the default is empty, meaning the load balancer uses the private IP address of each backend server for health checks.
- Enabled string
- Whether the listener enables health check. Values: on: enabled (default), off: disabled.
- Healthy
Threshold int - Health check threshold. Indicates the number of consecutive successful health checks required for a backend server to be considered healthy. Unit: times. Value range: 2–10. Default: 3.
- Http
Code string - HTTP status codes for a successful health check. Separate multiple codes with commas. This parameter is available only when HealthCheck.Protocol is HTTP. Valid values: http2xx (default), http3xx (default), http4xx, http5xx.
- Http
Version string - Health check HTTP protocol version. This parameter is available only when HealthCheck.Protocol is set to HTTP. Values: HTTP1.0 (default for API usage), HTTP1.1.
- Interval int
- After health checks are enabled, the interval for performing health checks. Unit: seconds. Value range: 1–300s. Default: 2.
- Method string
- Health check method after health checks are enabled. This parameter is valid only when HealthCheck.Protocol is set to HTTP. Values: GET: The server must support the GET method. HEAD (default): The server returns only the HEAD header, which reduces backend resource consumption, but the server must support the HEAD method.
- Port int
- Health check port. Supported values: 0 (default): Use the backend server port for health checks. 1–65535: Use the specified port for health checks.
- Protocol string
- Health check protocol. Currently supports HTTP and TCP. Default: HTTP.
- Timeout int
- Health check response timeout. If the backend server does not respond correctly within the specified time, the health check is considered abnormal. Unit: seconds. Value range: 1–60. Default: 2.
- Unhealthy
Threshold int - Unhealthy threshold for health checks. Indicates that a backend server is considered unhealthy if it fails the specified number of consecutive health checks. Unit: times. Range: 2–10. Default: 3.
- Uri string
- Health check path. Must be configured as the actual path provided by the backend server. This parameter is only effective when HealthCheck.Protocol is set to HTTP. Must start with '/'. Only letters, numbers, '-', '_', '/', '.', '%', '?', '#', '&', '=' are allowed. Length: 1–128 characters. If this parameter is not specified or specified without a value, the default is '/'.
- Domain string
- Domain name for health check. Configure this as the actual service address provided by the backend server. This parameter takes effect only when HealthCheck.Protocol is set to HTTP. The domain name must contain at least one '.', and cannot start or end with '.'. Each level of the domain name can contain letters, digits, '-', and '.' characters, and '-' cannot appear at the beginning or end of any level. Length: 1–128 characters. If this parameter is not specified or no value is provided, the default is empty, meaning the load balancer uses the private IP address of each backend server for health checks.
- Enabled string
- Whether the listener enables health check. Values: on: enabled (default), off: disabled.
- Healthy
Threshold int - Health check threshold. Indicates the number of consecutive successful health checks required for a backend server to be considered healthy. Unit: times. Value range: 2–10. Default: 3.
- Http
Code string - HTTP status codes for a successful health check. Separate multiple codes with commas. This parameter is available only when HealthCheck.Protocol is HTTP. Valid values: http2xx (default), http3xx (default), http4xx, http5xx.
- Http
Version string - Health check HTTP protocol version. This parameter is available only when HealthCheck.Protocol is set to HTTP. Values: HTTP1.0 (default for API usage), HTTP1.1.
- Interval int
- After health checks are enabled, the interval for performing health checks. Unit: seconds. Value range: 1–300s. Default: 2.
- Method string
- Health check method after health checks are enabled. This parameter is valid only when HealthCheck.Protocol is set to HTTP. Values: GET: The server must support the GET method. HEAD (default): The server returns only the HEAD header, which reduces backend resource consumption, but the server must support the HEAD method.
- Port int
- Health check port. Supported values: 0 (default): Use the backend server port for health checks. 1–65535: Use the specified port for health checks.
- Protocol string
- Health check protocol. Currently supports HTTP and TCP. Default: HTTP.
- Timeout int
- Health check response timeout. If the backend server does not respond correctly within the specified time, the health check is considered abnormal. Unit: seconds. Value range: 1–60. Default: 2.
- Unhealthy
Threshold int - Unhealthy threshold for health checks. Indicates that a backend server is considered unhealthy if it fails the specified number of consecutive health checks. Unit: times. Range: 2–10. Default: 3.
- Uri string
- Health check path. Must be configured as the actual path provided by the backend server. This parameter is only effective when HealthCheck.Protocol is set to HTTP. Must start with '/'. Only letters, numbers, '-', '_', '/', '.', '%', '?', '#', '&', '=' are allowed. Length: 1–128 characters. If this parameter is not specified or specified without a value, the default is '/'.
- domain String
- Domain name for health check. Configure this as the actual service address provided by the backend server. This parameter takes effect only when HealthCheck.Protocol is set to HTTP. The domain name must contain at least one '.', and cannot start or end with '.'. Each level of the domain name can contain letters, digits, '-', and '.' characters, and '-' cannot appear at the beginning or end of any level. Length: 1–128 characters. If this parameter is not specified or no value is provided, the default is empty, meaning the load balancer uses the private IP address of each backend server for health checks.
- enabled String
- Whether the listener enables health check. Values: on: enabled (default), off: disabled.
- healthy
Threshold Integer - Health check threshold. Indicates the number of consecutive successful health checks required for a backend server to be considered healthy. Unit: times. Value range: 2–10. Default: 3.
- http
Code String - HTTP status codes for a successful health check. Separate multiple codes with commas. This parameter is available only when HealthCheck.Protocol is HTTP. Valid values: http2xx (default), http3xx (default), http4xx, http5xx.
- http
Version String - Health check HTTP protocol version. This parameter is available only when HealthCheck.Protocol is set to HTTP. Values: HTTP1.0 (default for API usage), HTTP1.1.
- interval Integer
- After health checks are enabled, the interval for performing health checks. Unit: seconds. Value range: 1–300s. Default: 2.
- method String
- Health check method after health checks are enabled. This parameter is valid only when HealthCheck.Protocol is set to HTTP. Values: GET: The server must support the GET method. HEAD (default): The server returns only the HEAD header, which reduces backend resource consumption, but the server must support the HEAD method.
- port Integer
- Health check port. Supported values: 0 (default): Use the backend server port for health checks. 1–65535: Use the specified port for health checks.
- protocol String
- Health check protocol. Currently supports HTTP and TCP. Default: HTTP.
- timeout Integer
- Health check response timeout. If the backend server does not respond correctly within the specified time, the health check is considered abnormal. Unit: seconds. Value range: 1–60. Default: 2.
- unhealthy
Threshold Integer - Unhealthy threshold for health checks. Indicates that a backend server is considered unhealthy if it fails the specified number of consecutive health checks. Unit: times. Range: 2–10. Default: 3.
- uri String
- Health check path. Must be configured as the actual path provided by the backend server. This parameter is only effective when HealthCheck.Protocol is set to HTTP. Must start with '/'. Only letters, numbers, '-', '_', '/', '.', '%', '?', '#', '&', '=' are allowed. Length: 1–128 characters. If this parameter is not specified or specified without a value, the default is '/'.
- domain string
- Domain name for health check. Configure this as the actual service address provided by the backend server. This parameter takes effect only when HealthCheck.Protocol is set to HTTP. The domain name must contain at least one '.', and cannot start or end with '.'. Each level of the domain name can contain letters, digits, '-', and '.' characters, and '-' cannot appear at the beginning or end of any level. Length: 1–128 characters. If this parameter is not specified or no value is provided, the default is empty, meaning the load balancer uses the private IP address of each backend server for health checks.
- enabled string
- Whether the listener enables health check. Values: on: enabled (default), off: disabled.
- healthy
Threshold number - Health check threshold. Indicates the number of consecutive successful health checks required for a backend server to be considered healthy. Unit: times. Value range: 2–10. Default: 3.
- http
Code string - HTTP status codes for a successful health check. Separate multiple codes with commas. This parameter is available only when HealthCheck.Protocol is HTTP. Valid values: http2xx (default), http3xx (default), http4xx, http5xx.
- http
Version string - Health check HTTP protocol version. This parameter is available only when HealthCheck.Protocol is set to HTTP. Values: HTTP1.0 (default for API usage), HTTP1.1.
- interval number
- After health checks are enabled, the interval for performing health checks. Unit: seconds. Value range: 1–300s. Default: 2.
- method string
- Health check method after health checks are enabled. This parameter is valid only when HealthCheck.Protocol is set to HTTP. Values: GET: The server must support the GET method. HEAD (default): The server returns only the HEAD header, which reduces backend resource consumption, but the server must support the HEAD method.
- port number
- Health check port. Supported values: 0 (default): Use the backend server port for health checks. 1–65535: Use the specified port for health checks.
- protocol string
- Health check protocol. Currently supports HTTP and TCP. Default: HTTP.
- timeout number
- Health check response timeout. If the backend server does not respond correctly within the specified time, the health check is considered abnormal. Unit: seconds. Value range: 1–60. Default: 2.
- unhealthy
Threshold number - Unhealthy threshold for health checks. Indicates that a backend server is considered unhealthy if it fails the specified number of consecutive health checks. Unit: times. Range: 2–10. Default: 3.
- uri string
- Health check path. Must be configured as the actual path provided by the backend server. This parameter is only effective when HealthCheck.Protocol is set to HTTP. Must start with '/'. Only letters, numbers, '-', '_', '/', '.', '%', '?', '#', '&', '=' are allowed. Length: 1–128 characters. If this parameter is not specified or specified without a value, the default is '/'.
- domain str
- Domain name for health check. Configure this as the actual service address provided by the backend server. This parameter takes effect only when HealthCheck.Protocol is set to HTTP. The domain name must contain at least one '.', and cannot start or end with '.'. Each level of the domain name can contain letters, digits, '-', and '.' characters, and '-' cannot appear at the beginning or end of any level. Length: 1–128 characters. If this parameter is not specified or no value is provided, the default is empty, meaning the load balancer uses the private IP address of each backend server for health checks.
- enabled str
- Whether the listener enables health check. Values: on: enabled (default), off: disabled.
- healthy_
threshold int - Health check threshold. Indicates the number of consecutive successful health checks required for a backend server to be considered healthy. Unit: times. Value range: 2–10. Default: 3.
- http_
code str - HTTP status codes for a successful health check. Separate multiple codes with commas. This parameter is available only when HealthCheck.Protocol is HTTP. Valid values: http2xx (default), http3xx (default), http4xx, http5xx.
- http_
version str - Health check HTTP protocol version. This parameter is available only when HealthCheck.Protocol is set to HTTP. Values: HTTP1.0 (default for API usage), HTTP1.1.
- interval int
- After health checks are enabled, the interval for performing health checks. Unit: seconds. Value range: 1–300s. Default: 2.
- method str
- Health check method after health checks are enabled. This parameter is valid only when HealthCheck.Protocol is set to HTTP. Values: GET: The server must support the GET method. HEAD (default): The server returns only the HEAD header, which reduces backend resource consumption, but the server must support the HEAD method.
- port int
- Health check port. Supported values: 0 (default): Use the backend server port for health checks. 1–65535: Use the specified port for health checks.
- protocol str
- Health check protocol. Currently supports HTTP and TCP. Default: HTTP.
- timeout int
- Health check response timeout. If the backend server does not respond correctly within the specified time, the health check is considered abnormal. Unit: seconds. Value range: 1–60. Default: 2.
- unhealthy_
threshold int - Unhealthy threshold for health checks. Indicates that a backend server is considered unhealthy if it fails the specified number of consecutive health checks. Unit: times. Range: 2–10. Default: 3.
- uri str
- Health check path. Must be configured as the actual path provided by the backend server. This parameter is only effective when HealthCheck.Protocol is set to HTTP. Must start with '/'. Only letters, numbers, '-', '_', '/', '.', '%', '?', '#', '&', '=' are allowed. Length: 1–128 characters. If this parameter is not specified or specified without a value, the default is '/'.
- domain String
- Domain name for health check. Configure this as the actual service address provided by the backend server. This parameter takes effect only when HealthCheck.Protocol is set to HTTP. The domain name must contain at least one '.', and cannot start or end with '.'. Each level of the domain name can contain letters, digits, '-', and '.' characters, and '-' cannot appear at the beginning or end of any level. Length: 1–128 characters. If this parameter is not specified or no value is provided, the default is empty, meaning the load balancer uses the private IP address of each backend server for health checks.
- enabled String
- Whether the listener enables health check. Values: on: enabled (default), off: disabled.
- healthy
Threshold Number - Health check threshold. Indicates the number of consecutive successful health checks required for a backend server to be considered healthy. Unit: times. Value range: 2–10. Default: 3.
- http
Code String - HTTP status codes for a successful health check. Separate multiple codes with commas. This parameter is available only when HealthCheck.Protocol is HTTP. Valid values: http2xx (default), http3xx (default), http4xx, http5xx.
- http
Version String - Health check HTTP protocol version. This parameter is available only when HealthCheck.Protocol is set to HTTP. Values: HTTP1.0 (default for API usage), HTTP1.1.
- interval Number
- After health checks are enabled, the interval for performing health checks. Unit: seconds. Value range: 1–300s. Default: 2.
- method String
- Health check method after health checks are enabled. This parameter is valid only when HealthCheck.Protocol is set to HTTP. Values: GET: The server must support the GET method. HEAD (default): The server returns only the HEAD header, which reduces backend resource consumption, but the server must support the HEAD method.
- port Number
- Health check port. Supported values: 0 (default): Use the backend server port for health checks. 1–65535: Use the specified port for health checks.
- protocol String
- Health check protocol. Currently supports HTTP and TCP. Default: HTTP.
- timeout Number
- Health check response timeout. If the backend server does not respond correctly within the specified time, the health check is considered abnormal. Unit: seconds. Value range: 1–60. Default: 2.
- unhealthy
Threshold Number - Unhealthy threshold for health checks. Indicates that a backend server is considered unhealthy if it fails the specified number of consecutive health checks. Unit: times. Range: 2–10. Default: 3.
- uri String
- Health check path. Must be configured as the actual path provided by the backend server. This parameter is only effective when HealthCheck.Protocol is set to HTTP. Must start with '/'. Only letters, numbers, '-', '_', '/', '.', '%', '?', '#', '&', '=' are allowed. Length: 1–128 characters. If this parameter is not specified or specified without a value, the default is '/'.
ServerGroupListener, ServerGroupListenerArgs
- Listener
Id string - Listener ID.
- Listener
Id string - Listener ID.
- listener
Id String - Listener ID.
- listener
Id string - Listener ID.
- listener_
id str - Listener ID.
- listener
Id String - Listener ID.
ServerGroupServer, ServerGroupServerArgs
- Description string
- Description of the backend server.
- Instance
Id string - ID of the cloud server instance or network interface card.
- Ip string
- Private IP address of the backend server.
- Port int
- Port number on which the backend server receives requests.
- Remote
Enabled string - Enable remote IP feature. This field is valid only when the backend server instance type is IP address, that is, when Type is set to ip. Parameter values: on: Enable. off (default): Disable.
- Server
Id string - Backend server ID.
- Type string
- Backend server instance type. ecs: ECS instance. eni: auxiliary ENI. ip: IP address (valid only for IP-type server groups).
- Weight int
- Weight of the backend server.
- Description string
- Description of the backend server.
- Instance
Id string - ID of the cloud server instance or network interface card.
- Ip string
- Private IP address of the backend server.
- Port int
- Port number on which the backend server receives requests.
- Remote
Enabled string - Enable remote IP feature. This field is valid only when the backend server instance type is IP address, that is, when Type is set to ip. Parameter values: on: Enable. off (default): Disable.
- Server
Id string - Backend server ID.
- Type string
- Backend server instance type. ecs: ECS instance. eni: auxiliary ENI. ip: IP address (valid only for IP-type server groups).
- Weight int
- Weight of the backend server.
- description String
- Description of the backend server.
- instance
Id String - ID of the cloud server instance or network interface card.
- ip String
- Private IP address of the backend server.
- port Integer
- Port number on which the backend server receives requests.
- remote
Enabled String - Enable remote IP feature. This field is valid only when the backend server instance type is IP address, that is, when Type is set to ip. Parameter values: on: Enable. off (default): Disable.
- server
Id String - Backend server ID.
- type String
- Backend server instance type. ecs: ECS instance. eni: auxiliary ENI. ip: IP address (valid only for IP-type server groups).
- weight Integer
- Weight of the backend server.
- description string
- Description of the backend server.
- instance
Id string - ID of the cloud server instance or network interface card.
- ip string
- Private IP address of the backend server.
- port number
- Port number on which the backend server receives requests.
- remote
Enabled string - Enable remote IP feature. This field is valid only when the backend server instance type is IP address, that is, when Type is set to ip. Parameter values: on: Enable. off (default): Disable.
- server
Id string - Backend server ID.
- type string
- Backend server instance type. ecs: ECS instance. eni: auxiliary ENI. ip: IP address (valid only for IP-type server groups).
- weight number
- Weight of the backend server.
- description str
- Description of the backend server.
- instance_
id str - ID of the cloud server instance or network interface card.
- ip str
- Private IP address of the backend server.
- port int
- Port number on which the backend server receives requests.
- remote_
enabled str - Enable remote IP feature. This field is valid only when the backend server instance type is IP address, that is, when Type is set to ip. Parameter values: on: Enable. off (default): Disable.
- server_
id str - Backend server ID.
- type str
- Backend server instance type. ecs: ECS instance. eni: auxiliary ENI. ip: IP address (valid only for IP-type server groups).
- weight int
- Weight of the backend server.
- description String
- Description of the backend server.
- instance
Id String - ID of the cloud server instance or network interface card.
- ip String
- Private IP address of the backend server.
- port Number
- Port number on which the backend server receives requests.
- remote
Enabled String - Enable remote IP feature. This field is valid only when the backend server instance type is IP address, that is, when Type is set to ip. Parameter values: on: Enable. off (default): Disable.
- server
Id String - Backend server ID.
- type String
- Backend server instance type. ecs: ECS instance. eni: auxiliary ENI. ip: IP address (valid only for IP-type server groups).
- weight Number
- Weight of the backend server.
ServerGroupStickySessionConfig, ServerGroupStickySessionConfigArgs
- string
- Name of the session persistence Cookie for service configuration. This is only valid when session persistence is enabled and Cookie overwrite is selected. The specific rules are as follows: The Cookie name must be 1–200 characters long. The name can only contain ASCII letters and digits, cannot contain commas (,), semicolons (;), or spaces, and cannot start with a dollar sign ($). This parameter is required when tickySessionConfig.StickySessionEnabled is set to on and StickySessionConfig.StickySessionType is server. This parameter is invalid when StickySessionConfig.StickySessionEnabled is on and StickySessionConfig.StickySessionType is insert.
- int
- Session persistence cookie timeout. Only valid when session persistence is enabled and the insert cookie option is selected. Unit: seconds. Rules: Timeout range: 1–86400. Default: 1000. This parameter is required when StickySessionConfig.StickySessionEnabled is on and StickySessionConfig.StickySessionType is insert. This parameter is invalid when StickySessionConfig.StickySessionEnabled is on and StickySessionType is server.
- Sticky
Session stringEnabled - Enable session persistence. on: Enable; off (default): Disable.
- Sticky
Session stringType - Cookie handling method. This field is required when StickySessionConfig.StickySessionEnabled is set to on. Parameter values: insert: Inserts a Cookie. ALB records the backend server to which the client's first request is forwarded. ALB inserts a Cookie in the response. Subsequent client requests carry this Cookie, and ALB forwards the requests to the previously recorded backend server. server: Overwrites the Cookie. When session persistence with Cookie overwrite is enabled, after the client's first request is forwarded to the backend server, if ALB detects your custom Cookie in the response, it overwrites the original Cookie. Subsequent client requests carry the overwritten Cookie, and ALB forwards the requests to the previously recorded backend server.
- string
- Name of the session persistence Cookie for service configuration. This is only valid when session persistence is enabled and Cookie overwrite is selected. The specific rules are as follows: The Cookie name must be 1–200 characters long. The name can only contain ASCII letters and digits, cannot contain commas (,), semicolons (;), or spaces, and cannot start with a dollar sign ($). This parameter is required when tickySessionConfig.StickySessionEnabled is set to on and StickySessionConfig.StickySessionType is server. This parameter is invalid when StickySessionConfig.StickySessionEnabled is on and StickySessionConfig.StickySessionType is insert.
- int
- Session persistence cookie timeout. Only valid when session persistence is enabled and the insert cookie option is selected. Unit: seconds. Rules: Timeout range: 1–86400. Default: 1000. This parameter is required when StickySessionConfig.StickySessionEnabled is on and StickySessionConfig.StickySessionType is insert. This parameter is invalid when StickySessionConfig.StickySessionEnabled is on and StickySessionType is server.
- Sticky
Session stringEnabled - Enable session persistence. on: Enable; off (default): Disable.
- Sticky
Session stringType - Cookie handling method. This field is required when StickySessionConfig.StickySessionEnabled is set to on. Parameter values: insert: Inserts a Cookie. ALB records the backend server to which the client's first request is forwarded. ALB inserts a Cookie in the response. Subsequent client requests carry this Cookie, and ALB forwards the requests to the previously recorded backend server. server: Overwrites the Cookie. When session persistence with Cookie overwrite is enabled, after the client's first request is forwarded to the backend server, if ALB detects your custom Cookie in the response, it overwrites the original Cookie. Subsequent client requests carry the overwritten Cookie, and ALB forwards the requests to the previously recorded backend server.
- String
- Name of the session persistence Cookie for service configuration. This is only valid when session persistence is enabled and Cookie overwrite is selected. The specific rules are as follows: The Cookie name must be 1–200 characters long. The name can only contain ASCII letters and digits, cannot contain commas (,), semicolons (;), or spaces, and cannot start with a dollar sign ($). This parameter is required when tickySessionConfig.StickySessionEnabled is set to on and StickySessionConfig.StickySessionType is server. This parameter is invalid when StickySessionConfig.StickySessionEnabled is on and StickySessionConfig.StickySessionType is insert.
- Integer
- Session persistence cookie timeout. Only valid when session persistence is enabled and the insert cookie option is selected. Unit: seconds. Rules: Timeout range: 1–86400. Default: 1000. This parameter is required when StickySessionConfig.StickySessionEnabled is on and StickySessionConfig.StickySessionType is insert. This parameter is invalid when StickySessionConfig.StickySessionEnabled is on and StickySessionType is server.
- sticky
Session StringEnabled - Enable session persistence. on: Enable; off (default): Disable.
- sticky
Session StringType - Cookie handling method. This field is required when StickySessionConfig.StickySessionEnabled is set to on. Parameter values: insert: Inserts a Cookie. ALB records the backend server to which the client's first request is forwarded. ALB inserts a Cookie in the response. Subsequent client requests carry this Cookie, and ALB forwards the requests to the previously recorded backend server. server: Overwrites the Cookie. When session persistence with Cookie overwrite is enabled, after the client's first request is forwarded to the backend server, if ALB detects your custom Cookie in the response, it overwrites the original Cookie. Subsequent client requests carry the overwritten Cookie, and ALB forwards the requests to the previously recorded backend server.
- string
- Name of the session persistence Cookie for service configuration. This is only valid when session persistence is enabled and Cookie overwrite is selected. The specific rules are as follows: The Cookie name must be 1–200 characters long. The name can only contain ASCII letters and digits, cannot contain commas (,), semicolons (;), or spaces, and cannot start with a dollar sign ($). This parameter is required when tickySessionConfig.StickySessionEnabled is set to on and StickySessionConfig.StickySessionType is server. This parameter is invalid when StickySessionConfig.StickySessionEnabled is on and StickySessionConfig.StickySessionType is insert.
- number
- Session persistence cookie timeout. Only valid when session persistence is enabled and the insert cookie option is selected. Unit: seconds. Rules: Timeout range: 1–86400. Default: 1000. This parameter is required when StickySessionConfig.StickySessionEnabled is on and StickySessionConfig.StickySessionType is insert. This parameter is invalid when StickySessionConfig.StickySessionEnabled is on and StickySessionType is server.
- sticky
Session stringEnabled - Enable session persistence. on: Enable; off (default): Disable.
- sticky
Session stringType - Cookie handling method. This field is required when StickySessionConfig.StickySessionEnabled is set to on. Parameter values: insert: Inserts a Cookie. ALB records the backend server to which the client's first request is forwarded. ALB inserts a Cookie in the response. Subsequent client requests carry this Cookie, and ALB forwards the requests to the previously recorded backend server. server: Overwrites the Cookie. When session persistence with Cookie overwrite is enabled, after the client's first request is forwarded to the backend server, if ALB detects your custom Cookie in the response, it overwrites the original Cookie. Subsequent client requests carry the overwritten Cookie, and ALB forwards the requests to the previously recorded backend server.
- str
- Name of the session persistence Cookie for service configuration. This is only valid when session persistence is enabled and Cookie overwrite is selected. The specific rules are as follows: The Cookie name must be 1–200 characters long. The name can only contain ASCII letters and digits, cannot contain commas (,), semicolons (;), or spaces, and cannot start with a dollar sign ($). This parameter is required when tickySessionConfig.StickySessionEnabled is set to on and StickySessionConfig.StickySessionType is server. This parameter is invalid when StickySessionConfig.StickySessionEnabled is on and StickySessionConfig.StickySessionType is insert.
- int
- Session persistence cookie timeout. Only valid when session persistence is enabled and the insert cookie option is selected. Unit: seconds. Rules: Timeout range: 1–86400. Default: 1000. This parameter is required when StickySessionConfig.StickySessionEnabled is on and StickySessionConfig.StickySessionType is insert. This parameter is invalid when StickySessionConfig.StickySessionEnabled is on and StickySessionType is server.
- sticky_
session_ strenabled - Enable session persistence. on: Enable; off (default): Disable.
- sticky_
session_ strtype - Cookie handling method. This field is required when StickySessionConfig.StickySessionEnabled is set to on. Parameter values: insert: Inserts a Cookie. ALB records the backend server to which the client's first request is forwarded. ALB inserts a Cookie in the response. Subsequent client requests carry this Cookie, and ALB forwards the requests to the previously recorded backend server. server: Overwrites the Cookie. When session persistence with Cookie overwrite is enabled, after the client's first request is forwarded to the backend server, if ALB detects your custom Cookie in the response, it overwrites the original Cookie. Subsequent client requests carry the overwritten Cookie, and ALB forwards the requests to the previously recorded backend server.
- String
- Name of the session persistence Cookie for service configuration. This is only valid when session persistence is enabled and Cookie overwrite is selected. The specific rules are as follows: The Cookie name must be 1–200 characters long. The name can only contain ASCII letters and digits, cannot contain commas (,), semicolons (;), or spaces, and cannot start with a dollar sign ($). This parameter is required when tickySessionConfig.StickySessionEnabled is set to on and StickySessionConfig.StickySessionType is server. This parameter is invalid when StickySessionConfig.StickySessionEnabled is on and StickySessionConfig.StickySessionType is insert.
- Number
- Session persistence cookie timeout. Only valid when session persistence is enabled and the insert cookie option is selected. Unit: seconds. Rules: Timeout range: 1–86400. Default: 1000. This parameter is required when StickySessionConfig.StickySessionEnabled is on and StickySessionConfig.StickySessionType is insert. This parameter is invalid when StickySessionConfig.StickySessionEnabled is on and StickySessionType is server.
- sticky
Session StringEnabled - Enable session persistence. on: Enable; off (default): Disable.
- sticky
Session StringType - Cookie handling method. This field is required when StickySessionConfig.StickySessionEnabled is set to on. Parameter values: insert: Inserts a Cookie. ALB records the backend server to which the client's first request is forwarded. ALB inserts a Cookie in the response. Subsequent client requests carry this Cookie, and ALB forwards the requests to the previously recorded backend server. server: Overwrites the Cookie. When session persistence with Cookie overwrite is enabled, after the client's first request is forwarded to the backend server, if ALB detects your custom Cookie in the response, it overwrites the original Cookie. Subsequent client requests carry the overwritten Cookie, and ALB forwards the requests to the previously recorded backend server.
ServerGroupTag, ServerGroupTagArgs
Import
$ pulumi import volcenginecc:alb/serverGroup:ServerGroup example "server_group_id"
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- volcenginecc volcengine/pulumi-volcenginecc
- License
- MPL-2.0
- Notes
- This Pulumi package is based on the
volcengineccTerraform Provider.
published on Thursday, Apr 23, 2026 by Volcengine
