1. Packages
  2. Alibaba Cloud Provider
  3. API Docs
  4. gwlb
  5. ServerGroup
Alibaba Cloud v3.66.0 published on Friday, Nov 15, 2024 by Pulumi

alicloud.gwlb.ServerGroup

Explore with Pulumi AI

alicloud logo
Alibaba Cloud v3.66.0 published on Friday, Nov 15, 2024 by Pulumi

    Provides a GWLB Server Group resource.

    For information about GWLB Server Group and how to use it, see What is Server Group.

    NOTE: Available since v1.234.0.

    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,
                    connection_drain_config: Optional[ServerGroupConnectionDrainConfigArgs] = None,
                    dry_run: Optional[bool] = None,
                    health_check_config: Optional[ServerGroupHealthCheckConfigArgs] = None,
                    protocol: Optional[str] = None,
                    resource_group_id: Optional[str] = None,
                    scheduler: Optional[str] = None,
                    server_group_name: Optional[str] = None,
                    server_group_type: Optional[str] = None,
                    servers: Optional[Sequence[ServerGroupServerArgs]] = None,
                    tags: Optional[Mapping[str, 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: alicloud:gwlb: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.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var alicloudServerGroupResource = new AliCloud.Gwlb.ServerGroup("alicloudServerGroupResource", new()
    {
        VpcId = "string",
        ConnectionDrainConfig = new AliCloud.Gwlb.Inputs.ServerGroupConnectionDrainConfigArgs
        {
            ConnectionDrainEnabled = false,
            ConnectionDrainTimeout = 0,
        },
        DryRun = false,
        HealthCheckConfig = new AliCloud.Gwlb.Inputs.ServerGroupHealthCheckConfigArgs
        {
            HealthCheckConnectPort = 0,
            HealthCheckConnectTimeout = 0,
            HealthCheckDomain = "string",
            HealthCheckEnabled = false,
            HealthCheckHttpCodes = new[]
            {
                "string",
            },
            HealthCheckInterval = 0,
            HealthCheckPath = "string",
            HealthCheckProtocol = "string",
            HealthyThreshold = 0,
            UnhealthyThreshold = 0,
        },
        Protocol = "string",
        ResourceGroupId = "string",
        Scheduler = "string",
        ServerGroupName = "string",
        ServerGroupType = "string",
        Servers = new[]
        {
            new AliCloud.Gwlb.Inputs.ServerGroupServerArgs
            {
                ServerId = "string",
                ServerType = "string",
                Port = 0,
                ServerGroupId = "string",
                ServerIp = "string",
                Status = "string",
            },
        },
        Tags = 
        {
            { "string", "string" },
        },
    });
    
    example, err := gwlb.NewServerGroup(ctx, "alicloudServerGroupResource", &gwlb.ServerGroupArgs{
    	VpcId: pulumi.String("string"),
    	ConnectionDrainConfig: &gwlb.ServerGroupConnectionDrainConfigArgs{
    		ConnectionDrainEnabled: pulumi.Bool(false),
    		ConnectionDrainTimeout: pulumi.Int(0),
    	},
    	DryRun: pulumi.Bool(false),
    	HealthCheckConfig: &gwlb.ServerGroupHealthCheckConfigArgs{
    		HealthCheckConnectPort:    pulumi.Int(0),
    		HealthCheckConnectTimeout: pulumi.Int(0),
    		HealthCheckDomain:         pulumi.String("string"),
    		HealthCheckEnabled:        pulumi.Bool(false),
    		HealthCheckHttpCodes: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    		HealthCheckInterval: pulumi.Int(0),
    		HealthCheckPath:     pulumi.String("string"),
    		HealthCheckProtocol: pulumi.String("string"),
    		HealthyThreshold:    pulumi.Int(0),
    		UnhealthyThreshold:  pulumi.Int(0),
    	},
    	Protocol:        pulumi.String("string"),
    	ResourceGroupId: pulumi.String("string"),
    	Scheduler:       pulumi.String("string"),
    	ServerGroupName: pulumi.String("string"),
    	ServerGroupType: pulumi.String("string"),
    	Servers: gwlb.ServerGroupServerArray{
    		&gwlb.ServerGroupServerArgs{
    			ServerId:      pulumi.String("string"),
    			ServerType:    pulumi.String("string"),
    			Port:          pulumi.Int(0),
    			ServerGroupId: pulumi.String("string"),
    			ServerIp:      pulumi.String("string"),
    			Status:        pulumi.String("string"),
    		},
    	},
    	Tags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    })
    
    var alicloudServerGroupResource = new ServerGroup("alicloudServerGroupResource", ServerGroupArgs.builder()
        .vpcId("string")
        .connectionDrainConfig(ServerGroupConnectionDrainConfigArgs.builder()
            .connectionDrainEnabled(false)
            .connectionDrainTimeout(0)
            .build())
        .dryRun(false)
        .healthCheckConfig(ServerGroupHealthCheckConfigArgs.builder()
            .healthCheckConnectPort(0)
            .healthCheckConnectTimeout(0)
            .healthCheckDomain("string")
            .healthCheckEnabled(false)
            .healthCheckHttpCodes("string")
            .healthCheckInterval(0)
            .healthCheckPath("string")
            .healthCheckProtocol("string")
            .healthyThreshold(0)
            .unhealthyThreshold(0)
            .build())
        .protocol("string")
        .resourceGroupId("string")
        .scheduler("string")
        .serverGroupName("string")
        .serverGroupType("string")
        .servers(ServerGroupServerArgs.builder()
            .serverId("string")
            .serverType("string")
            .port(0)
            .serverGroupId("string")
            .serverIp("string")
            .status("string")
            .build())
        .tags(Map.of("string", "string"))
        .build());
    
    alicloud_server_group_resource = alicloud.gwlb.ServerGroup("alicloudServerGroupResource",
        vpc_id="string",
        connection_drain_config={
            "connection_drain_enabled": False,
            "connection_drain_timeout": 0,
        },
        dry_run=False,
        health_check_config={
            "health_check_connect_port": 0,
            "health_check_connect_timeout": 0,
            "health_check_domain": "string",
            "health_check_enabled": False,
            "health_check_http_codes": ["string"],
            "health_check_interval": 0,
            "health_check_path": "string",
            "health_check_protocol": "string",
            "healthy_threshold": 0,
            "unhealthy_threshold": 0,
        },
        protocol="string",
        resource_group_id="string",
        scheduler="string",
        server_group_name="string",
        server_group_type="string",
        servers=[{
            "server_id": "string",
            "server_type": "string",
            "port": 0,
            "server_group_id": "string",
            "server_ip": "string",
            "status": "string",
        }],
        tags={
            "string": "string",
        })
    
    const alicloudServerGroupResource = new alicloud.gwlb.ServerGroup("alicloudServerGroupResource", {
        vpcId: "string",
        connectionDrainConfig: {
            connectionDrainEnabled: false,
            connectionDrainTimeout: 0,
        },
        dryRun: false,
        healthCheckConfig: {
            healthCheckConnectPort: 0,
            healthCheckConnectTimeout: 0,
            healthCheckDomain: "string",
            healthCheckEnabled: false,
            healthCheckHttpCodes: ["string"],
            healthCheckInterval: 0,
            healthCheckPath: "string",
            healthCheckProtocol: "string",
            healthyThreshold: 0,
            unhealthyThreshold: 0,
        },
        protocol: "string",
        resourceGroupId: "string",
        scheduler: "string",
        serverGroupName: "string",
        serverGroupType: "string",
        servers: [{
            serverId: "string",
            serverType: "string",
            port: 0,
            serverGroupId: "string",
            serverIp: "string",
            status: "string",
        }],
        tags: {
            string: "string",
        },
    });
    
    type: alicloud:gwlb:ServerGroup
    properties:
        connectionDrainConfig:
            connectionDrainEnabled: false
            connectionDrainTimeout: 0
        dryRun: false
        healthCheckConfig:
            healthCheckConnectPort: 0
            healthCheckConnectTimeout: 0
            healthCheckDomain: string
            healthCheckEnabled: false
            healthCheckHttpCodes:
                - string
            healthCheckInterval: 0
            healthCheckPath: string
            healthCheckProtocol: string
            healthyThreshold: 0
            unhealthyThreshold: 0
        protocol: string
        resourceGroupId: string
        scheduler: string
        serverGroupName: string
        serverGroupType: string
        servers:
            - port: 0
              serverGroupId: string
              serverId: string
              serverIp: string
              serverType: string
              status: string
        tags:
            string: string
        vpcId: string
    

    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:

    VpcId string

    The VPC instance ID.

    NOTE: If the value of ServerGroupType is Instance, only servers in the VPC can be added to the server group.

    ConnectionDrainConfig Pulumi.AliCloud.Gwlb.Inputs.ServerGroupConnectionDrainConfig
    Connected graceful interrupt configuration. See connection_drain_config below.
    DryRun bool
    Specifies whether to perform only a dry run, without performing the actual request.
    HealthCheckConfig Pulumi.AliCloud.Gwlb.Inputs.ServerGroupHealthCheckConfig
    Health check configurations. See health_check_config below.
    Protocol string
    Backend Protocol. Value:

    • *GENEVE (default)**.
    ResourceGroupId string
    The ID of the resource group.
    Scheduler string
    Scheduling algorithm. Value:

    • 5TCH (default): quintuple hash, which is based on the consistent hash of the quintuple (source IP, Destination IP, source port, destination port, and protocol). The same flow is scheduled to the same backend server.
    • 3TCH: a three-tuple hash, which is based on the consistent hash of three tuples (source IP address, destination IP address, and protocol). The same flow is dispatched to the same backend server.
    • 2TCH: Binary Group hash, which is based on the consistent hash of the binary group (source IP and destination IP). The same flow is scheduled to the same backend server.
    ServerGroupName string

    The server group name.

    It must be 2 to 128 characters in length, start with an uppercase letter or a Chinese character, and can contain digits, half-width periods (.), underscores (_), and dashes (-).

    ServerGroupType string
    The server group type. Value:

    • Instance (default): The instance type. You can add Ecs, Eni, and Eci instances to the server group.
    • Ip: The Ip address type. You can directly add backend servers of the Ip address type to the server group.
    Servers List<Pulumi.AliCloud.Gwlb.Inputs.ServerGroupServer>
    List of servers. See servers below.
    Tags Dictionary<string, string>
    List of resource tags.
    VpcId string

    The VPC instance ID.

    NOTE: If the value of ServerGroupType is Instance, only servers in the VPC can be added to the server group.

    ConnectionDrainConfig ServerGroupConnectionDrainConfigArgs
    Connected graceful interrupt configuration. See connection_drain_config below.
    DryRun bool
    Specifies whether to perform only a dry run, without performing the actual request.
    HealthCheckConfig ServerGroupHealthCheckConfigArgs
    Health check configurations. See health_check_config below.
    Protocol string
    Backend Protocol. Value:

    • *GENEVE (default)**.
    ResourceGroupId string
    The ID of the resource group.
    Scheduler string
    Scheduling algorithm. Value:

    • 5TCH (default): quintuple hash, which is based on the consistent hash of the quintuple (source IP, Destination IP, source port, destination port, and protocol). The same flow is scheduled to the same backend server.
    • 3TCH: a three-tuple hash, which is based on the consistent hash of three tuples (source IP address, destination IP address, and protocol). The same flow is dispatched to the same backend server.
    • 2TCH: Binary Group hash, which is based on the consistent hash of the binary group (source IP and destination IP). The same flow is scheduled to the same backend server.
    ServerGroupName string

    The server group name.

    It must be 2 to 128 characters in length, start with an uppercase letter or a Chinese character, and can contain digits, half-width periods (.), underscores (_), and dashes (-).

    ServerGroupType string
    The server group type. Value:

    • Instance (default): The instance type. You can add Ecs, Eni, and Eci instances to the server group.
    • Ip: The Ip address type. You can directly add backend servers of the Ip address type to the server group.
    Servers []ServerGroupServerArgs
    List of servers. See servers below.
    Tags map[string]string
    List of resource tags.
    vpcId String

    The VPC instance ID.

    NOTE: If the value of ServerGroupType is Instance, only servers in the VPC can be added to the server group.

    connectionDrainConfig ServerGroupConnectionDrainConfig
    Connected graceful interrupt configuration. See connection_drain_config below.
    dryRun Boolean
    Specifies whether to perform only a dry run, without performing the actual request.
    healthCheckConfig ServerGroupHealthCheckConfig
    Health check configurations. See health_check_config below.
    protocol String
    Backend Protocol. Value:

    • *GENEVE (default)**.
    resourceGroupId String
    The ID of the resource group.
    scheduler String
    Scheduling algorithm. Value:

    • 5TCH (default): quintuple hash, which is based on the consistent hash of the quintuple (source IP, Destination IP, source port, destination port, and protocol). The same flow is scheduled to the same backend server.
    • 3TCH: a three-tuple hash, which is based on the consistent hash of three tuples (source IP address, destination IP address, and protocol). The same flow is dispatched to the same backend server.
    • 2TCH: Binary Group hash, which is based on the consistent hash of the binary group (source IP and destination IP). The same flow is scheduled to the same backend server.
    serverGroupName String

    The server group name.

    It must be 2 to 128 characters in length, start with an uppercase letter or a Chinese character, and can contain digits, half-width periods (.), underscores (_), and dashes (-).

    serverGroupType String
    The server group type. Value:

    • Instance (default): The instance type. You can add Ecs, Eni, and Eci instances to the server group.
    • Ip: The Ip address type. You can directly add backend servers of the Ip address type to the server group.
    servers List<ServerGroupServer>
    List of servers. See servers below.
    tags Map<String,String>
    List of resource tags.
    vpcId string

    The VPC instance ID.

    NOTE: If the value of ServerGroupType is Instance, only servers in the VPC can be added to the server group.

    connectionDrainConfig ServerGroupConnectionDrainConfig
    Connected graceful interrupt configuration. See connection_drain_config below.
    dryRun boolean
    Specifies whether to perform only a dry run, without performing the actual request.
    healthCheckConfig ServerGroupHealthCheckConfig
    Health check configurations. See health_check_config below.
    protocol string
    Backend Protocol. Value:

    • *GENEVE (default)**.
    resourceGroupId string
    The ID of the resource group.
    scheduler string
    Scheduling algorithm. Value:

    • 5TCH (default): quintuple hash, which is based on the consistent hash of the quintuple (source IP, Destination IP, source port, destination port, and protocol). The same flow is scheduled to the same backend server.
    • 3TCH: a three-tuple hash, which is based on the consistent hash of three tuples (source IP address, destination IP address, and protocol). The same flow is dispatched to the same backend server.
    • 2TCH: Binary Group hash, which is based on the consistent hash of the binary group (source IP and destination IP). The same flow is scheduled to the same backend server.
    serverGroupName string

    The server group name.

    It must be 2 to 128 characters in length, start with an uppercase letter or a Chinese character, and can contain digits, half-width periods (.), underscores (_), and dashes (-).

    serverGroupType string
    The server group type. Value:

    • Instance (default): The instance type. You can add Ecs, Eni, and Eci instances to the server group.
    • Ip: The Ip address type. You can directly add backend servers of the Ip address type to the server group.
    servers ServerGroupServer[]
    List of servers. See servers below.
    tags {[key: string]: string}
    List of resource tags.
    vpc_id str

    The VPC instance ID.

    NOTE: If the value of ServerGroupType is Instance, only servers in the VPC can be added to the server group.

    connection_drain_config ServerGroupConnectionDrainConfigArgs
    Connected graceful interrupt configuration. See connection_drain_config below.
    dry_run bool
    Specifies whether to perform only a dry run, without performing the actual request.
    health_check_config ServerGroupHealthCheckConfigArgs
    Health check configurations. See health_check_config below.
    protocol str
    Backend Protocol. Value:

    • *GENEVE (default)**.
    resource_group_id str
    The ID of the resource group.
    scheduler str
    Scheduling algorithm. Value:

    • 5TCH (default): quintuple hash, which is based on the consistent hash of the quintuple (source IP, Destination IP, source port, destination port, and protocol). The same flow is scheduled to the same backend server.
    • 3TCH: a three-tuple hash, which is based on the consistent hash of three tuples (source IP address, destination IP address, and protocol). The same flow is dispatched to the same backend server.
    • 2TCH: Binary Group hash, which is based on the consistent hash of the binary group (source IP and destination IP). The same flow is scheduled to the same backend server.
    server_group_name str

    The server group name.

    It must be 2 to 128 characters in length, start with an uppercase letter or a Chinese character, and can contain digits, half-width periods (.), underscores (_), and dashes (-).

    server_group_type str
    The server group type. Value:

    • Instance (default): The instance type. You can add Ecs, Eni, and Eci instances to the server group.
    • Ip: The Ip address type. You can directly add backend servers of the Ip address type to the server group.
    servers Sequence[ServerGroupServerArgs]
    List of servers. See servers below.
    tags Mapping[str, str]
    List of resource tags.
    vpcId String

    The VPC instance ID.

    NOTE: If the value of ServerGroupType is Instance, only servers in the VPC can be added to the server group.

    connectionDrainConfig Property Map
    Connected graceful interrupt configuration. See connection_drain_config below.
    dryRun Boolean
    Specifies whether to perform only a dry run, without performing the actual request.
    healthCheckConfig Property Map
    Health check configurations. See health_check_config below.
    protocol String
    Backend Protocol. Value:

    • *GENEVE (default)**.
    resourceGroupId String
    The ID of the resource group.
    scheduler String
    Scheduling algorithm. Value:

    • 5TCH (default): quintuple hash, which is based on the consistent hash of the quintuple (source IP, Destination IP, source port, destination port, and protocol). The same flow is scheduled to the same backend server.
    • 3TCH: a three-tuple hash, which is based on the consistent hash of three tuples (source IP address, destination IP address, and protocol). The same flow is dispatched to the same backend server.
    • 2TCH: Binary Group hash, which is based on the consistent hash of the binary group (source IP and destination IP). The same flow is scheduled to the same backend server.
    serverGroupName String

    The server group name.

    It must be 2 to 128 characters in length, start with an uppercase letter or a Chinese character, and can contain digits, half-width periods (.), underscores (_), and dashes (-).

    serverGroupType String
    The server group type. Value:

    • Instance (default): The instance type. You can add Ecs, Eni, and Eci instances to the server group.
    • Ip: The Ip address type. You can directly add backend servers of the Ip address type to the server group.
    servers List<Property Map>
    List of servers. See servers below.
    tags Map<String>
    List of resource tags.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the ServerGroup resource produces the following output properties:

    CreateTime string
    The creation time of the server group.
    Id string
    The provider-assigned unique ID for this managed resource.
    Status string
    Server group status. Value:
    CreateTime string
    The creation time of the server group.
    Id string
    The provider-assigned unique ID for this managed resource.
    Status string
    Server group status. Value:
    createTime String
    The creation time of the server group.
    id String
    The provider-assigned unique ID for this managed resource.
    status String
    Server group status. Value:
    createTime string
    The creation time of the server group.
    id string
    The provider-assigned unique ID for this managed resource.
    status string
    Server group status. Value:
    create_time str
    The creation time of the server group.
    id str
    The provider-assigned unique ID for this managed resource.
    status str
    Server group status. Value:
    createTime String
    The creation time of the server group.
    id String
    The provider-assigned unique ID for this managed resource.
    status String
    Server group status. Value:

    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,
            connection_drain_config: Optional[ServerGroupConnectionDrainConfigArgs] = None,
            create_time: Optional[str] = None,
            dry_run: Optional[bool] = None,
            health_check_config: Optional[ServerGroupHealthCheckConfigArgs] = None,
            protocol: Optional[str] = None,
            resource_group_id: Optional[str] = None,
            scheduler: Optional[str] = None,
            server_group_name: Optional[str] = None,
            server_group_type: Optional[str] = None,
            servers: Optional[Sequence[ServerGroupServerArgs]] = None,
            status: Optional[str] = None,
            tags: Optional[Mapping[str, str]] = None,
            vpc_id: Optional[str] = None) -> ServerGroup
    func 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)
    Resource lookup is not supported in YAML
    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.
    The following state arguments are supported:
    ConnectionDrainConfig Pulumi.AliCloud.Gwlb.Inputs.ServerGroupConnectionDrainConfig
    Connected graceful interrupt configuration. See connection_drain_config below.
    CreateTime string
    The creation time of the server group.
    DryRun bool
    Specifies whether to perform only a dry run, without performing the actual request.
    HealthCheckConfig Pulumi.AliCloud.Gwlb.Inputs.ServerGroupHealthCheckConfig
    Health check configurations. See health_check_config below.
    Protocol string
    Backend Protocol. Value:

    • *GENEVE (default)**.
    ResourceGroupId string
    The ID of the resource group.
    Scheduler string
    Scheduling algorithm. Value:

    • 5TCH (default): quintuple hash, which is based on the consistent hash of the quintuple (source IP, Destination IP, source port, destination port, and protocol). The same flow is scheduled to the same backend server.
    • 3TCH: a three-tuple hash, which is based on the consistent hash of three tuples (source IP address, destination IP address, and protocol). The same flow is dispatched to the same backend server.
    • 2TCH: Binary Group hash, which is based on the consistent hash of the binary group (source IP and destination IP). The same flow is scheduled to the same backend server.
    ServerGroupName string

    The server group name.

    It must be 2 to 128 characters in length, start with an uppercase letter or a Chinese character, and can contain digits, half-width periods (.), underscores (_), and dashes (-).

    ServerGroupType string
    The server group type. Value:

    • Instance (default): The instance type. You can add Ecs, Eni, and Eci instances to the server group.
    • Ip: The Ip address type. You can directly add backend servers of the Ip address type to the server group.
    Servers List<Pulumi.AliCloud.Gwlb.Inputs.ServerGroupServer>
    List of servers. See servers below.
    Status string
    Server group status. Value:
    Tags Dictionary<string, string>
    List of resource tags.
    VpcId string

    The VPC instance ID.

    NOTE: If the value of ServerGroupType is Instance, only servers in the VPC can be added to the server group.

    ConnectionDrainConfig ServerGroupConnectionDrainConfigArgs
    Connected graceful interrupt configuration. See connection_drain_config below.
    CreateTime string
    The creation time of the server group.
    DryRun bool
    Specifies whether to perform only a dry run, without performing the actual request.
    HealthCheckConfig ServerGroupHealthCheckConfigArgs
    Health check configurations. See health_check_config below.
    Protocol string
    Backend Protocol. Value:

    • *GENEVE (default)**.
    ResourceGroupId string
    The ID of the resource group.
    Scheduler string
    Scheduling algorithm. Value:

    • 5TCH (default): quintuple hash, which is based on the consistent hash of the quintuple (source IP, Destination IP, source port, destination port, and protocol). The same flow is scheduled to the same backend server.
    • 3TCH: a three-tuple hash, which is based on the consistent hash of three tuples (source IP address, destination IP address, and protocol). The same flow is dispatched to the same backend server.
    • 2TCH: Binary Group hash, which is based on the consistent hash of the binary group (source IP and destination IP). The same flow is scheduled to the same backend server.
    ServerGroupName string

    The server group name.

    It must be 2 to 128 characters in length, start with an uppercase letter or a Chinese character, and can contain digits, half-width periods (.), underscores (_), and dashes (-).

    ServerGroupType string
    The server group type. Value:

    • Instance (default): The instance type. You can add Ecs, Eni, and Eci instances to the server group.
    • Ip: The Ip address type. You can directly add backend servers of the Ip address type to the server group.
    Servers []ServerGroupServerArgs
    List of servers. See servers below.
    Status string
    Server group status. Value:
    Tags map[string]string
    List of resource tags.
    VpcId string

    The VPC instance ID.

    NOTE: If the value of ServerGroupType is Instance, only servers in the VPC can be added to the server group.

    connectionDrainConfig ServerGroupConnectionDrainConfig
    Connected graceful interrupt configuration. See connection_drain_config below.
    createTime String
    The creation time of the server group.
    dryRun Boolean
    Specifies whether to perform only a dry run, without performing the actual request.
    healthCheckConfig ServerGroupHealthCheckConfig
    Health check configurations. See health_check_config below.
    protocol String
    Backend Protocol. Value:

    • *GENEVE (default)**.
    resourceGroupId String
    The ID of the resource group.
    scheduler String
    Scheduling algorithm. Value:

    • 5TCH (default): quintuple hash, which is based on the consistent hash of the quintuple (source IP, Destination IP, source port, destination port, and protocol). The same flow is scheduled to the same backend server.
    • 3TCH: a three-tuple hash, which is based on the consistent hash of three tuples (source IP address, destination IP address, and protocol). The same flow is dispatched to the same backend server.
    • 2TCH: Binary Group hash, which is based on the consistent hash of the binary group (source IP and destination IP). The same flow is scheduled to the same backend server.
    serverGroupName String

    The server group name.

    It must be 2 to 128 characters in length, start with an uppercase letter or a Chinese character, and can contain digits, half-width periods (.), underscores (_), and dashes (-).

    serverGroupType String
    The server group type. Value:

    • Instance (default): The instance type. You can add Ecs, Eni, and Eci instances to the server group.
    • Ip: The Ip address type. You can directly add backend servers of the Ip address type to the server group.
    servers List<ServerGroupServer>
    List of servers. See servers below.
    status String
    Server group status. Value:
    tags Map<String,String>
    List of resource tags.
    vpcId String

    The VPC instance ID.

    NOTE: If the value of ServerGroupType is Instance, only servers in the VPC can be added to the server group.

    connectionDrainConfig ServerGroupConnectionDrainConfig
    Connected graceful interrupt configuration. See connection_drain_config below.
    createTime string
    The creation time of the server group.
    dryRun boolean
    Specifies whether to perform only a dry run, without performing the actual request.
    healthCheckConfig ServerGroupHealthCheckConfig
    Health check configurations. See health_check_config below.
    protocol string
    Backend Protocol. Value:

    • *GENEVE (default)**.
    resourceGroupId string
    The ID of the resource group.
    scheduler string
    Scheduling algorithm. Value:

    • 5TCH (default): quintuple hash, which is based on the consistent hash of the quintuple (source IP, Destination IP, source port, destination port, and protocol). The same flow is scheduled to the same backend server.
    • 3TCH: a three-tuple hash, which is based on the consistent hash of three tuples (source IP address, destination IP address, and protocol). The same flow is dispatched to the same backend server.
    • 2TCH: Binary Group hash, which is based on the consistent hash of the binary group (source IP and destination IP). The same flow is scheduled to the same backend server.
    serverGroupName string

    The server group name.

    It must be 2 to 128 characters in length, start with an uppercase letter or a Chinese character, and can contain digits, half-width periods (.), underscores (_), and dashes (-).

    serverGroupType string
    The server group type. Value:

    • Instance (default): The instance type. You can add Ecs, Eni, and Eci instances to the server group.
    • Ip: The Ip address type. You can directly add backend servers of the Ip address type to the server group.
    servers ServerGroupServer[]
    List of servers. See servers below.
    status string
    Server group status. Value:
    tags {[key: string]: string}
    List of resource tags.
    vpcId string

    The VPC instance ID.

    NOTE: If the value of ServerGroupType is Instance, only servers in the VPC can be added to the server group.

    connection_drain_config ServerGroupConnectionDrainConfigArgs
    Connected graceful interrupt configuration. See connection_drain_config below.
    create_time str
    The creation time of the server group.
    dry_run bool
    Specifies whether to perform only a dry run, without performing the actual request.
    health_check_config ServerGroupHealthCheckConfigArgs
    Health check configurations. See health_check_config below.
    protocol str
    Backend Protocol. Value:

    • *GENEVE (default)**.
    resource_group_id str
    The ID of the resource group.
    scheduler str
    Scheduling algorithm. Value:

    • 5TCH (default): quintuple hash, which is based on the consistent hash of the quintuple (source IP, Destination IP, source port, destination port, and protocol). The same flow is scheduled to the same backend server.
    • 3TCH: a three-tuple hash, which is based on the consistent hash of three tuples (source IP address, destination IP address, and protocol). The same flow is dispatched to the same backend server.
    • 2TCH: Binary Group hash, which is based on the consistent hash of the binary group (source IP and destination IP). The same flow is scheduled to the same backend server.
    server_group_name str

    The server group name.

    It must be 2 to 128 characters in length, start with an uppercase letter or a Chinese character, and can contain digits, half-width periods (.), underscores (_), and dashes (-).

    server_group_type str
    The server group type. Value:

    • Instance (default): The instance type. You can add Ecs, Eni, and Eci instances to the server group.
    • Ip: The Ip address type. You can directly add backend servers of the Ip address type to the server group.
    servers Sequence[ServerGroupServerArgs]
    List of servers. See servers below.
    status str
    Server group status. Value:
    tags Mapping[str, str]
    List of resource tags.
    vpc_id str

    The VPC instance ID.

    NOTE: If the value of ServerGroupType is Instance, only servers in the VPC can be added to the server group.

    connectionDrainConfig Property Map
    Connected graceful interrupt configuration. See connection_drain_config below.
    createTime String
    The creation time of the server group.
    dryRun Boolean
    Specifies whether to perform only a dry run, without performing the actual request.
    healthCheckConfig Property Map
    Health check configurations. See health_check_config below.
    protocol String
    Backend Protocol. Value:

    • *GENEVE (default)**.
    resourceGroupId String
    The ID of the resource group.
    scheduler String
    Scheduling algorithm. Value:

    • 5TCH (default): quintuple hash, which is based on the consistent hash of the quintuple (source IP, Destination IP, source port, destination port, and protocol). The same flow is scheduled to the same backend server.
    • 3TCH: a three-tuple hash, which is based on the consistent hash of three tuples (source IP address, destination IP address, and protocol). The same flow is dispatched to the same backend server.
    • 2TCH: Binary Group hash, which is based on the consistent hash of the binary group (source IP and destination IP). The same flow is scheduled to the same backend server.
    serverGroupName String

    The server group name.

    It must be 2 to 128 characters in length, start with an uppercase letter or a Chinese character, and can contain digits, half-width periods (.), underscores (_), and dashes (-).

    serverGroupType String
    The server group type. Value:

    • Instance (default): The instance type. You can add Ecs, Eni, and Eci instances to the server group.
    • Ip: The Ip address type. You can directly add backend servers of the Ip address type to the server group.
    servers List<Property Map>
    List of servers. See servers below.
    status String
    Server group status. Value:
    tags Map<String>
    List of resource tags.
    vpcId String

    The VPC instance ID.

    NOTE: If the value of ServerGroupType is Instance, only servers in the VPC can be added to the server group.

    Supporting Types

    ServerGroupConnectionDrainConfig, ServerGroupConnectionDrainConfigArgs

    ConnectionDrainEnabled bool
    Whether to open the connection graceful interrupt. Value:
    ConnectionDrainTimeout int

    Connection Grace interrupt timeout.

    Unit: seconds.

    Value range: 1~3600.

    ConnectionDrainEnabled bool
    Whether to open the connection graceful interrupt. Value:
    ConnectionDrainTimeout int

    Connection Grace interrupt timeout.

    Unit: seconds.

    Value range: 1~3600.

    connectionDrainEnabled Boolean
    Whether to open the connection graceful interrupt. Value:
    connectionDrainTimeout Integer

    Connection Grace interrupt timeout.

    Unit: seconds.

    Value range: 1~3600.

    connectionDrainEnabled boolean
    Whether to open the connection graceful interrupt. Value:
    connectionDrainTimeout number

    Connection Grace interrupt timeout.

    Unit: seconds.

    Value range: 1~3600.

    connection_drain_enabled bool
    Whether to open the connection graceful interrupt. Value:
    connection_drain_timeout int

    Connection Grace interrupt timeout.

    Unit: seconds.

    Value range: 1~3600.

    connectionDrainEnabled Boolean
    Whether to open the connection graceful interrupt. Value:
    connectionDrainTimeout Number

    Connection Grace interrupt timeout.

    Unit: seconds.

    Value range: 1~3600.

    ServerGroupHealthCheckConfig, ServerGroupHealthCheckConfigArgs

    HealthCheckConnectPort int

    The port of the backend server used for health check.

    Value range: 1 to 65535.

    Default value: 80.

    HealthCheckConnectTimeout int

    The maximum timeout period for health check responses.

    Unit: seconds.

    Value range: 1 to 300.

    Default value: 5.

    HealthCheckDomain string
    The domain name used for health checks. Value:

    • $SERVER_IP (default): Use the internal IP address of the backend server.
    HealthCheckEnabled bool
    Whether to enable health check. Value:

    • true (default): enabled.
    HealthCheckHttpCodes List<string>
    Health status return code list.
    HealthCheckInterval int

    The time interval of the health check.

    Unit: seconds.

    Value range: 1~50.

    Default value: 10.

    HealthCheckPath string

    Health check path.

    It can be 1 to 80 characters in length and can only use upper and lower case letters, digits, dashes (-), forward slashes (/), half-width periods (.), percent signs (%), and half-width question marks (?), Pound sign (#) and and(&) and extended character set_;~! ()*[]@$^: ',+ =

    Must start with a forward slash (/).

    NOTE: This parameter takes effect only when the HealthCheckProtocol is HTTP.

    HealthCheckProtocol string
    Health check protocol, value:

    • TCP (default): Sends a SYN handshake packet to check whether the server port is alive.
    • HTTP: Sends a GET request to simulate the access behavior of the browser to check whether the server application is healthy.
    HealthyThreshold int

    After the number of consecutive successful health checks, the health check status of the backend server is determined as successful from failed.

    Value range: 2 to 10.

    Default value: 2.

    UnhealthyThreshold int

    The number of consecutive failed health checks that determine the health check status of the backend server from success to failure.

    Value range: 2 to 10.

    Default value: 2.

    HealthCheckConnectPort int

    The port of the backend server used for health check.

    Value range: 1 to 65535.

    Default value: 80.

    HealthCheckConnectTimeout int

    The maximum timeout period for health check responses.

    Unit: seconds.

    Value range: 1 to 300.

    Default value: 5.

    HealthCheckDomain string
    The domain name used for health checks. Value:

    • $SERVER_IP (default): Use the internal IP address of the backend server.
    HealthCheckEnabled bool
    Whether to enable health check. Value:

    • true (default): enabled.
    HealthCheckHttpCodes []string
    Health status return code list.
    HealthCheckInterval int

    The time interval of the health check.

    Unit: seconds.

    Value range: 1~50.

    Default value: 10.

    HealthCheckPath string

    Health check path.

    It can be 1 to 80 characters in length and can only use upper and lower case letters, digits, dashes (-), forward slashes (/), half-width periods (.), percent signs (%), and half-width question marks (?), Pound sign (#) and and(&) and extended character set_;~! ()*[]@$^: ',+ =

    Must start with a forward slash (/).

    NOTE: This parameter takes effect only when the HealthCheckProtocol is HTTP.

    HealthCheckProtocol string
    Health check protocol, value:

    • TCP (default): Sends a SYN handshake packet to check whether the server port is alive.
    • HTTP: Sends a GET request to simulate the access behavior of the browser to check whether the server application is healthy.
    HealthyThreshold int

    After the number of consecutive successful health checks, the health check status of the backend server is determined as successful from failed.

    Value range: 2 to 10.

    Default value: 2.

    UnhealthyThreshold int

    The number of consecutive failed health checks that determine the health check status of the backend server from success to failure.

    Value range: 2 to 10.

    Default value: 2.

    healthCheckConnectPort Integer

    The port of the backend server used for health check.

    Value range: 1 to 65535.

    Default value: 80.

    healthCheckConnectTimeout Integer

    The maximum timeout period for health check responses.

    Unit: seconds.

    Value range: 1 to 300.

    Default value: 5.

    healthCheckDomain String
    The domain name used for health checks. Value:

    • $SERVER_IP (default): Use the internal IP address of the backend server.
    healthCheckEnabled Boolean
    Whether to enable health check. Value:

    • true (default): enabled.
    healthCheckHttpCodes List<String>
    Health status return code list.
    healthCheckInterval Integer

    The time interval of the health check.

    Unit: seconds.

    Value range: 1~50.

    Default value: 10.

    healthCheckPath String

    Health check path.

    It can be 1 to 80 characters in length and can only use upper and lower case letters, digits, dashes (-), forward slashes (/), half-width periods (.), percent signs (%), and half-width question marks (?), Pound sign (#) and and(&) and extended character set_;~! ()*[]@$^: ',+ =

    Must start with a forward slash (/).

    NOTE: This parameter takes effect only when the HealthCheckProtocol is HTTP.

    healthCheckProtocol String
    Health check protocol, value:

    • TCP (default): Sends a SYN handshake packet to check whether the server port is alive.
    • HTTP: Sends a GET request to simulate the access behavior of the browser to check whether the server application is healthy.
    healthyThreshold Integer

    After the number of consecutive successful health checks, the health check status of the backend server is determined as successful from failed.

    Value range: 2 to 10.

    Default value: 2.

    unhealthyThreshold Integer

    The number of consecutive failed health checks that determine the health check status of the backend server from success to failure.

    Value range: 2 to 10.

    Default value: 2.

    healthCheckConnectPort number

    The port of the backend server used for health check.

    Value range: 1 to 65535.

    Default value: 80.

    healthCheckConnectTimeout number

    The maximum timeout period for health check responses.

    Unit: seconds.

    Value range: 1 to 300.

    Default value: 5.

    healthCheckDomain string
    The domain name used for health checks. Value:

    • $SERVER_IP (default): Use the internal IP address of the backend server.
    healthCheckEnabled boolean
    Whether to enable health check. Value:

    • true (default): enabled.
    healthCheckHttpCodes string[]
    Health status return code list.
    healthCheckInterval number

    The time interval of the health check.

    Unit: seconds.

    Value range: 1~50.

    Default value: 10.

    healthCheckPath string

    Health check path.

    It can be 1 to 80 characters in length and can only use upper and lower case letters, digits, dashes (-), forward slashes (/), half-width periods (.), percent signs (%), and half-width question marks (?), Pound sign (#) and and(&) and extended character set_;~! ()*[]@$^: ',+ =

    Must start with a forward slash (/).

    NOTE: This parameter takes effect only when the HealthCheckProtocol is HTTP.

    healthCheckProtocol string
    Health check protocol, value:

    • TCP (default): Sends a SYN handshake packet to check whether the server port is alive.
    • HTTP: Sends a GET request to simulate the access behavior of the browser to check whether the server application is healthy.
    healthyThreshold number

    After the number of consecutive successful health checks, the health check status of the backend server is determined as successful from failed.

    Value range: 2 to 10.

    Default value: 2.

    unhealthyThreshold number

    The number of consecutive failed health checks that determine the health check status of the backend server from success to failure.

    Value range: 2 to 10.

    Default value: 2.

    health_check_connect_port int

    The port of the backend server used for health check.

    Value range: 1 to 65535.

    Default value: 80.

    health_check_connect_timeout int

    The maximum timeout period for health check responses.

    Unit: seconds.

    Value range: 1 to 300.

    Default value: 5.

    health_check_domain str
    The domain name used for health checks. Value:

    • $SERVER_IP (default): Use the internal IP address of the backend server.
    health_check_enabled bool
    Whether to enable health check. Value:

    • true (default): enabled.
    health_check_http_codes Sequence[str]
    Health status return code list.
    health_check_interval int

    The time interval of the health check.

    Unit: seconds.

    Value range: 1~50.

    Default value: 10.

    health_check_path str

    Health check path.

    It can be 1 to 80 characters in length and can only use upper and lower case letters, digits, dashes (-), forward slashes (/), half-width periods (.), percent signs (%), and half-width question marks (?), Pound sign (#) and and(&) and extended character set_;~! ()*[]@$^: ',+ =

    Must start with a forward slash (/).

    NOTE: This parameter takes effect only when the HealthCheckProtocol is HTTP.

    health_check_protocol str
    Health check protocol, value:

    • TCP (default): Sends a SYN handshake packet to check whether the server port is alive.
    • HTTP: Sends a GET request to simulate the access behavior of the browser to check whether the server application is healthy.
    healthy_threshold int

    After the number of consecutive successful health checks, the health check status of the backend server is determined as successful from failed.

    Value range: 2 to 10.

    Default value: 2.

    unhealthy_threshold int

    The number of consecutive failed health checks that determine the health check status of the backend server from success to failure.

    Value range: 2 to 10.

    Default value: 2.

    healthCheckConnectPort Number

    The port of the backend server used for health check.

    Value range: 1 to 65535.

    Default value: 80.

    healthCheckConnectTimeout Number

    The maximum timeout period for health check responses.

    Unit: seconds.

    Value range: 1 to 300.

    Default value: 5.

    healthCheckDomain String
    The domain name used for health checks. Value:

    • $SERVER_IP (default): Use the internal IP address of the backend server.
    healthCheckEnabled Boolean
    Whether to enable health check. Value:

    • true (default): enabled.
    healthCheckHttpCodes List<String>
    Health status return code list.
    healthCheckInterval Number

    The time interval of the health check.

    Unit: seconds.

    Value range: 1~50.

    Default value: 10.

    healthCheckPath String

    Health check path.

    It can be 1 to 80 characters in length and can only use upper and lower case letters, digits, dashes (-), forward slashes (/), half-width periods (.), percent signs (%), and half-width question marks (?), Pound sign (#) and and(&) and extended character set_;~! ()*[]@$^: ',+ =

    Must start with a forward slash (/).

    NOTE: This parameter takes effect only when the HealthCheckProtocol is HTTP.

    healthCheckProtocol String
    Health check protocol, value:

    • TCP (default): Sends a SYN handshake packet to check whether the server port is alive.
    • HTTP: Sends a GET request to simulate the access behavior of the browser to check whether the server application is healthy.
    healthyThreshold Number

    After the number of consecutive successful health checks, the health check status of the backend server is determined as successful from failed.

    Value range: 2 to 10.

    Default value: 2.

    unhealthyThreshold Number

    The number of consecutive failed health checks that determine the health check status of the backend server from success to failure.

    Value range: 2 to 10.

    Default value: 2.

    ServerGroupServer, ServerGroupServerArgs

    ServerId string
    The ID of the backend server.
    ServerType string
    Backend server type. Valid values:

    • Ecs: ECS instance.
    • Eni: ENI instance.
    • Eci: ECI elastic container.
    • Ip: Ip address.
    Port int
    The port used by the backend server.
    ServerGroupId string
    The server group ID.
    ServerIp string
    Server ip.
    Status string
    Server group status. Value:
    ServerId string
    The ID of the backend server.
    ServerType string
    Backend server type. Valid values:

    • Ecs: ECS instance.
    • Eni: ENI instance.
    • Eci: ECI elastic container.
    • Ip: Ip address.
    Port int
    The port used by the backend server.
    ServerGroupId string
    The server group ID.
    ServerIp string
    Server ip.
    Status string
    Server group status. Value:
    serverId String
    The ID of the backend server.
    serverType String
    Backend server type. Valid values:

    • Ecs: ECS instance.
    • Eni: ENI instance.
    • Eci: ECI elastic container.
    • Ip: Ip address.
    port Integer
    The port used by the backend server.
    serverGroupId String
    The server group ID.
    serverIp String
    Server ip.
    status String
    Server group status. Value:
    serverId string
    The ID of the backend server.
    serverType string
    Backend server type. Valid values:

    • Ecs: ECS instance.
    • Eni: ENI instance.
    • Eci: ECI elastic container.
    • Ip: Ip address.
    port number
    The port used by the backend server.
    serverGroupId string
    The server group ID.
    serverIp string
    Server ip.
    status string
    Server group status. Value:
    server_id str
    The ID of the backend server.
    server_type str
    Backend server type. Valid values:

    • Ecs: ECS instance.
    • Eni: ENI instance.
    • Eci: ECI elastic container.
    • Ip: Ip address.
    port int
    The port used by the backend server.
    server_group_id str
    The server group ID.
    server_ip str
    Server ip.
    status str
    Server group status. Value:
    serverId String
    The ID of the backend server.
    serverType String
    Backend server type. Valid values:

    • Ecs: ECS instance.
    • Eni: ENI instance.
    • Eci: ECI elastic container.
    • Ip: Ip address.
    port Number
    The port used by the backend server.
    serverGroupId String
    The server group ID.
    serverIp String
    Server ip.
    status String
    Server group status. Value:

    Import

    GWLB Server Group can be imported using the id, e.g.

    $ pulumi import alicloud:gwlb/serverGroup:ServerGroup example <id>
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    Alibaba Cloud pulumi/pulumi-alicloud
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the alicloud Terraform Provider.
    alicloud logo
    Alibaba Cloud v3.66.0 published on Friday, Nov 15, 2024 by Pulumi