Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi IDP Pulumi Cloud Packages Tutorials
  1. Packages
  2. Scaleway
  3. API Docs
  4. LoadbalancerFrontend
Scaleway v1.27.1 published on Wednesday, Apr 30, 2025 by pulumiverse
pulumiverse/pulumi-scaleway

scaleway.LoadbalancerFrontend

Explore with Pulumi AI

scaleway logo
Scaleway v1.27.1 published on Wednesday, Apr 30, 2025 by pulumiverse
pulumiverse/pulumi-scaleway
    Deprecated: scaleway.index/loadbalancerfrontend.LoadbalancerFrontend has been deprecated in favor of scaleway.loadbalancers/frontend.Frontend

    Creates and manages Scaleway Load Balancer frontends.

    For more information, see the main documentation or API documentation.

    Example Usage

    Basic

    import * as pulumi from "@pulumi/pulumi";
import * as scaleway from "@pulumiverse/scaleway";

const frontend01 = new scaleway.loadbalancers.Frontend("frontend01", {
    lbId: lb01.id,
    backendId: backend01.id,
    name: "frontend01",
    inboundPort: 80,
});

    import pulumi
import pulumiverse_scaleway as scaleway

frontend01 = scaleway.loadbalancers.Frontend("frontend01",
    lb_id=lb01["id"],
    backend_id=backend01["id"],
    name="frontend01",
    inbound_port=80)

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/loadbalancers"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := loadbalancers.NewFrontend(ctx, "frontend01", &loadbalancers.FrontendArgs{
			LbId:        pulumi.Any(lb01.Id),
			BackendId:   pulumi.Any(backend01.Id),
			Name:        pulumi.String("frontend01"),
			InboundPort: pulumi.Int(80),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Scaleway = Pulumiverse.Scaleway;

return await Deployment.RunAsync(() => 
{
    var frontend01 = new Scaleway.Loadbalancers.Frontend("frontend01", new()
    {
        LbId = lb01.Id,
        BackendId = backend01.Id,
        Name = "frontend01",
        InboundPort = 80,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.scaleway.loadbalancers.Frontend;
import com.pulumi.scaleway.loadbalancers.FrontendArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var frontend01 = new Frontend("frontend01", FrontendArgs.builder()
            .lbId(lb01.id())
            .backendId(backend01.id())
            .name("frontend01")
            .inboundPort("80")
            .build());

    }
}

    resources:
  frontend01:
    type: scaleway:loadbalancers:Frontend
    properties:
      lbId: ${lb01.id}
      backendId: ${backend01.id}
      name: frontend01
      inboundPort: '80'

    With ACLs

    import * as pulumi from "@pulumi/pulumi";
import * as scaleway from "@pulumiverse/scaleway";

const frontend01 = new scaleway.loadbalancers.Frontend("frontend01", {
    lbId: lb01.id,
    backendId: backend01.id,
    name: "frontend01",
    inboundPort: 80,
    acls: [
        {
            name: "blacklist wellknwon IPs",
            action: {
                type: "allow",
            },
            match: {
                ipSubnets: [
                    "192.168.0.1",
                    "192.168.0.2",
                    "192.168.10.0/24",
                ],
            },
        },
        {
            action: {
                type: "deny",
            },
            match: {
                ipSubnets: ["51.51.51.51"],
                httpFilter: "regex",
                httpFilterValues: ["^foo*bar$"],
            },
        },
        {
            action: {
                type: "allow",
            },
            match: {
                httpFilter: "path_begin",
                httpFilterValues: [
                    "foo",
                    "bar",
                ],
            },
        },
        {
            action: {
                type: "allow",
            },
            match: {
                httpFilter: "path_begin",
                httpFilterValues: ["hi"],
                invert: true,
            },
        },
        {
            action: {
                type: "allow",
            },
            match: {
                httpFilter: "http_header_match",
                httpFilterValues: "foo",
                httpFilterOption: "bar",
            },
        },
        {
            action: {
                type: "redirect",
                redirects: [{
                    type: "location",
                    target: "https://example.com",
                    code: 307,
                }],
            },
            match: {
                ipSubnets: ["10.0.0.10"],
                httpFilter: "path_begin",
                httpFilterValues: [
                    "foo",
                    "bar",
                ],
            },
        },
    ],
});

    import pulumi
import pulumiverse_scaleway as scaleway

frontend01 = scaleway.loadbalancers.Frontend("frontend01",
    lb_id=lb01["id"],
    backend_id=backend01["id"],
    name="frontend01",
    inbound_port=80,
    acls=[
        {
            "name": "blacklist wellknwon IPs",
            "action": {
                "type": "allow",
            },
            "match": {
                "ip_subnets": [
                    "192.168.0.1",
                    "192.168.0.2",
                    "192.168.10.0/24",
                ],
            },
        },
        {
            "action": {
                "type": "deny",
            },
            "match": {
                "ip_subnets": ["51.51.51.51"],
                "http_filter": "regex",
                "http_filter_values": ["^foo*bar$"],
            },
        },
        {
            "action": {
                "type": "allow",
            },
            "match": {
                "http_filter": "path_begin",
                "http_filter_values": [
                    "foo",
                    "bar",
                ],
            },
        },
        {
            "action": {
                "type": "allow",
            },
            "match": {
                "http_filter": "path_begin",
                "http_filter_values": ["hi"],
                "invert": True,
            },
        },
        {
            "action": {
                "type": "allow",
            },
            "match": {
                "http_filter": "http_header_match",
                "http_filter_values": "foo",
                "http_filter_option": "bar",
            },
        },
        {
            "action": {
                "type": "redirect",
                "redirects": [{
                    "type": "location",
                    "target": "https://example.com",
                    "code": 307,
                }],
            },
            "match": {
                "ip_subnets": ["10.0.0.10"],
                "http_filter": "path_begin",
                "http_filter_values": [
                    "foo",
                    "bar",
                ],
            },
        },
    ])

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/loadbalancers"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := loadbalancers.NewFrontend(ctx, "frontend01", &loadbalancers.FrontendArgs{
			LbId:        pulumi.Any(lb01.Id),
			BackendId:   pulumi.Any(backend01.Id),
			Name:        pulumi.String("frontend01"),
			InboundPort: pulumi.Int(80),
			Acls: loadbalancers.FrontendAclArray{
				&loadbalancers.FrontendAclArgs{
					Name: pulumi.String("blacklist wellknwon IPs"),
					Action: &loadbalancers.FrontendAclActionArgs{
						Type: pulumi.String("allow"),
					},
					Match: &loadbalancers.FrontendAclMatchArgs{
						IpSubnets: pulumi.StringArray{
							pulumi.String("192.168.0.1"),
							pulumi.String("192.168.0.2"),
							pulumi.String("192.168.10.0/24"),
						},
					},
				},
				&loadbalancers.FrontendAclArgs{
					Action: &loadbalancers.FrontendAclActionArgs{
						Type: pulumi.String("deny"),
					},
					Match: &loadbalancers.FrontendAclMatchArgs{
						IpSubnets: pulumi.StringArray{
							pulumi.String("51.51.51.51"),
						},
						HttpFilter: pulumi.String("regex"),
						HttpFilterValues: pulumi.StringArray{
							pulumi.String("^foo*bar$"),
						},
					},
				},
				&loadbalancers.FrontendAclArgs{
					Action: &loadbalancers.FrontendAclActionArgs{
						Type: pulumi.String("allow"),
					},
					Match: &loadbalancers.FrontendAclMatchArgs{
						HttpFilter: pulumi.String("path_begin"),
						HttpFilterValues: pulumi.StringArray{
							pulumi.String("foo"),
							pulumi.String("bar"),
						},
					},
				},
				&loadbalancers.FrontendAclArgs{
					Action: &loadbalancers.FrontendAclActionArgs{
						Type: pulumi.String("allow"),
					},
					Match: &loadbalancers.FrontendAclMatchArgs{
						HttpFilter: pulumi.String("path_begin"),
						HttpFilterValues: pulumi.StringArray{
							pulumi.String("hi"),
						},
						Invert: pulumi.Bool(true),
					},
				},
				&loadbalancers.FrontendAclArgs{
					Action: &loadbalancers.FrontendAclActionArgs{
						Type: pulumi.String("allow"),
					},
					Match: &loadbalancers.FrontendAclMatchArgs{
						HttpFilter:       pulumi.String("http_header_match"),
						HttpFilterValues: pulumi.StringArray("foo"),
						HttpFilterOption: pulumi.String("bar"),
					},
				},
				&loadbalancers.FrontendAclArgs{
					Action: &loadbalancers.FrontendAclActionArgs{
						Type: pulumi.String("redirect"),
						Redirects: loadbalancers.FrontendAclActionRedirectArray{
							&loadbalancers.FrontendAclActionRedirectArgs{
								Type:   pulumi.String("location"),
								Target: pulumi.String("https://example.com"),
								Code:   pulumi.Int(307),
							},
						},
					},
					Match: &loadbalancers.FrontendAclMatchArgs{
						IpSubnets: pulumi.StringArray{
							pulumi.String("10.0.0.10"),
						},
						HttpFilter: pulumi.String("path_begin"),
						HttpFilterValues: pulumi.StringArray{
							pulumi.String("foo"),
							pulumi.String("bar"),
						},
					},
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Scaleway = Pulumiverse.Scaleway;

return await Deployment.RunAsync(() => 
{
    var frontend01 = new Scaleway.Loadbalancers.Frontend("frontend01", new()
    {
        LbId = lb01.Id,
        BackendId = backend01.Id,
        Name = "frontend01",
        InboundPort = 80,
        Acls = new[]
        {
            new Scaleway.Loadbalancers.Inputs.FrontendAclArgs
            {
                Name = "blacklist wellknwon IPs",
                Action = new Scaleway.Loadbalancers.Inputs.FrontendAclActionArgs
                {
                    Type = "allow",
                },
                Match = new Scaleway.Loadbalancers.Inputs.FrontendAclMatchArgs
                {
                    IpSubnets = new[]
                    {
                        "192.168.0.1",
                        "192.168.0.2",
                        "192.168.10.0/24",
                    },
                },
            },
            new Scaleway.Loadbalancers.Inputs.FrontendAclArgs
            {
                Action = new Scaleway.Loadbalancers.Inputs.FrontendAclActionArgs
                {
                    Type = "deny",
                },
                Match = new Scaleway.Loadbalancers.Inputs.FrontendAclMatchArgs
                {
                    IpSubnets = new[]
                    {
                        "51.51.51.51",
                    },
                    HttpFilter = "regex",
                    HttpFilterValues = new[]
                    {
                        "^foo*bar$",
                    },
                },
            },
            new Scaleway.Loadbalancers.Inputs.FrontendAclArgs
            {
                Action = new Scaleway.Loadbalancers.Inputs.FrontendAclActionArgs
                {
                    Type = "allow",
                },
                Match = new Scaleway.Loadbalancers.Inputs.FrontendAclMatchArgs
                {
                    HttpFilter = "path_begin",
                    HttpFilterValues = new[]
                    {
                        "foo",
                        "bar",
                    },
                },
            },
            new Scaleway.Loadbalancers.Inputs.FrontendAclArgs
            {
                Action = new Scaleway.Loadbalancers.Inputs.FrontendAclActionArgs
                {
                    Type = "allow",
                },
                Match = new Scaleway.Loadbalancers.Inputs.FrontendAclMatchArgs
                {
                    HttpFilter = "path_begin",
                    HttpFilterValues = new[]
                    {
                        "hi",
                    },
                    Invert = true,
                },
            },
            new Scaleway.Loadbalancers.Inputs.FrontendAclArgs
            {
                Action = new Scaleway.Loadbalancers.Inputs.FrontendAclActionArgs
                {
                    Type = "allow",
                },
                Match = new Scaleway.Loadbalancers.Inputs.FrontendAclMatchArgs
                {
                    HttpFilter = "http_header_match",
                    HttpFilterValues = "foo",
                    HttpFilterOption = "bar",
                },
            },
            new Scaleway.Loadbalancers.Inputs.FrontendAclArgs
            {
                Action = new Scaleway.Loadbalancers.Inputs.FrontendAclActionArgs
                {
                    Type = "redirect",
                    Redirects = new[]
                    {
                        new Scaleway.Loadbalancers.Inputs.FrontendAclActionRedirectArgs
                        {
                            Type = "location",
                            Target = "https://example.com",
                            Code = 307,
                        },
                    },
                },
                Match = new Scaleway.Loadbalancers.Inputs.FrontendAclMatchArgs
                {
                    IpSubnets = new[]
                    {
                        "10.0.0.10",
                    },
                    HttpFilter = "path_begin",
                    HttpFilterValues = new[]
                    {
                        "foo",
                        "bar",
                    },
                },
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.scaleway.loadbalancers.Frontend;
import com.pulumi.scaleway.loadbalancers.FrontendArgs;
import com.pulumi.scaleway.loadbalancers.inputs.FrontendAclArgs;
import com.pulumi.scaleway.loadbalancers.inputs.FrontendAclActionArgs;
import com.pulumi.scaleway.loadbalancers.inputs.FrontendAclMatchArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var frontend01 = new Frontend("frontend01", FrontendArgs.builder()
            .lbId(lb01.id())
            .backendId(backend01.id())
            .name("frontend01")
            .inboundPort("80")
            .acls(            
                FrontendAclArgs.builder()
                    .name("blacklist wellknwon IPs")
                    .action(FrontendAclActionArgs.builder()
                        .type("allow")
                        .build())
                    .match(FrontendAclMatchArgs.builder()
                        .ipSubnets(                        
                            "192.168.0.1",
                            "192.168.0.2",
                            "192.168.10.0/24")
                        .build())
                    .build(),
                FrontendAclArgs.builder()
                    .action(FrontendAclActionArgs.builder()
                        .type("deny")
                        .build())
                    .match(FrontendAclMatchArgs.builder()
                        .ipSubnets("51.51.51.51")
                        .httpFilter("regex")
                        .httpFilterValues("^foo*bar$")
                        .build())
                    .build(),
                FrontendAclArgs.builder()
                    .action(FrontendAclActionArgs.builder()
                        .type("allow")
                        .build())
                    .match(FrontendAclMatchArgs.builder()
                        .httpFilter("path_begin")
                        .httpFilterValues(                        
                            "foo",
                            "bar")
                        .build())
                    .build(),
                FrontendAclArgs.builder()
                    .action(FrontendAclActionArgs.builder()
                        .type("allow")
                        .build())
                    .match(FrontendAclMatchArgs.builder()
                        .httpFilter("path_begin")
                        .httpFilterValues("hi")
                        .invert("true")
                        .build())
                    .build(),
                FrontendAclArgs.builder()
                    .action(FrontendAclActionArgs.builder()
                        .type("allow")
                        .build())
                    .match(FrontendAclMatchArgs.builder()
                        .httpFilter("http_header_match")
                        .httpFilterValues("foo")
                        .httpFilterOption("bar")
                        .build())
                    .build(),
                FrontendAclArgs.builder()
                    .action(FrontendAclActionArgs.builder()
                        .type("redirect")
                        .redirects(FrontendAclActionRedirectArgs.builder()
                            .type("location")
                            .target("https://example.com")
                            .code(307)
                            .build())
                        .build())
                    .match(FrontendAclMatchArgs.builder()
                        .ipSubnets("10.0.0.10")
                        .httpFilter("path_begin")
                        .httpFilterValues(                        
                            "foo",
                            "bar")
                        .build())
                    .build())
            .build());

    }
}

    resources:
  frontend01:
    type: scaleway:loadbalancers:Frontend
    properties:
      lbId: ${lb01.id}
      backendId: ${backend01.id}
      name: frontend01
      inboundPort: '80'
      acls:
        - name: blacklist wellknwon IPs
          action:
            type: allow
          match:
            ipSubnets:
              - 192.168.0.1
              - 192.168.0.2
              - 192.168.10.0/24
        - action:
            type: deny
          match:
            ipSubnets:
              - 51.51.51.51
            httpFilter: regex
            httpFilterValues:
              - ^foo*bar$
        - action:
            type: allow
          match:
            httpFilter: path_begin
            httpFilterValues:
              - foo
              - bar
        - action:
            type: allow
          match:
            httpFilter: path_begin
            httpFilterValues:
              - hi
            invert: 'true'
        - action:
            type: allow
          match:
            httpFilter: http_header_match
            httpFilterValues: foo
            httpFilterOption: bar
        - action:
            type: redirect
            redirects:
              - type: location
                target: https://example.com
                code: 307
          match:
            ipSubnets:
              - 10.0.0.10
            httpFilter: path_begin
            httpFilterValues:
              - foo
              - bar

    Create LoadbalancerFrontend Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new LoadbalancerFrontend(name: string, args: LoadbalancerFrontendArgs, opts?: CustomResourceOptions);
    @overload
def LoadbalancerFrontend(resource_name: str,
                         args: LoadbalancerFrontendArgs,
                         opts: Optional[ResourceOptions] = None)

@overload
def LoadbalancerFrontend(resource_name: str,
                         opts: Optional[ResourceOptions] = None,
                         acls: Optional[Sequence[LoadbalancerFrontendAclArgs]] = None,
                         backend_id: Optional[str] = None,
                         certificate_ids: Optional[Sequence[str]] = None,
                         connection_rate_limit: Optional[int] = None,
                         enable_http3: Optional[bool] = None,
                         external_acls: Optional[bool] = None,
                         inbound_port: Optional[int] = None,
                         lb_id: Optional[str] = None,
                         name: Optional[str] = None,
                         timeout_client: Optional[str] = None)
    func NewLoadbalancerFrontend(ctx *Context, name string, args LoadbalancerFrontendArgs, opts ...ResourceOption) (*LoadbalancerFrontend, error)
    public LoadbalancerFrontend(string name, LoadbalancerFrontendArgs args, CustomResourceOptions? opts = null)
    public LoadbalancerFrontend(String name, LoadbalancerFrontendArgs args)
public LoadbalancerFrontend(String name, LoadbalancerFrontendArgs args, CustomResourceOptions options)

    type: scaleway:LoadbalancerFrontend
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 LoadbalancerFrontendArgs
    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 LoadbalancerFrontendArgs
    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 LoadbalancerFrontendArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args LoadbalancerFrontendArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args LoadbalancerFrontendArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    LoadbalancerFrontend 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 LoadbalancerFrontend resource accepts the following input properties:

    BackendId string

    The ID of the Load Balancer backend this frontend is attached to.

    Important: Updates to lb_id or backend_id will recreate the frontend.

    InboundPort int
    TCP port to listen to on the front side.
    LbId string
    The ID of the Load Balancer this frontend is attached to.
    Acls List<Pulumiverse.Scaleway.Inputs.LoadbalancerFrontendAcl>
    A list of ACL rules to apply to the Load Balancer frontend. Defined below.
    CertificateIds List<string>

    List of certificate IDs that should be used by the frontend.

    Important: Certificates are not allowed on port 80.

    ConnectionRateLimit int
    The rate limit for new connections established on this frontend. Use 0 value to disable, else value is connections per second.
    EnableHttp3 bool
    Activates HTTP/3 protocol.
    ExternalAcls bool
    A boolean to specify whether to use lb_acl. If external_acls is set to true, acl can not be set directly in the Load Balancer frontend.
    Name string
    The ACL name. If not provided it will be randomly generated.
    TimeoutClient string
    Maximum inactivity time on the client side. (e.g. 1s)
    BackendId string

    The ID of the Load Balancer backend this frontend is attached to.

    Important: Updates to lb_id or backend_id will recreate the frontend.

    InboundPort int
    TCP port to listen to on the front side.
    LbId string
    The ID of the Load Balancer this frontend is attached to.
    Acls []LoadbalancerFrontendAclArgs
    A list of ACL rules to apply to the Load Balancer frontend. Defined below.
    CertificateIds []string

    List of certificate IDs that should be used by the frontend.

    Important: Certificates are not allowed on port 80.

    ConnectionRateLimit int
    The rate limit for new connections established on this frontend. Use 0 value to disable, else value is connections per second.
    EnableHttp3 bool
    Activates HTTP/3 protocol.
    ExternalAcls bool
    A boolean to specify whether to use lb_acl. If external_acls is set to true, acl can not be set directly in the Load Balancer frontend.
    Name string
    The ACL name. If not provided it will be randomly generated.
    TimeoutClient string
    Maximum inactivity time on the client side. (e.g. 1s)
    backendId String

    The ID of the Load Balancer backend this frontend is attached to.

    Important: Updates to lb_id or backend_id will recreate the frontend.

    inboundPort Integer
    TCP port to listen to on the front side.
    lbId String
    The ID of the Load Balancer this frontend is attached to.
    acls List<LoadbalancerFrontendAcl>
    A list of ACL rules to apply to the Load Balancer frontend. Defined below.
    certificateIds List<String>

    List of certificate IDs that should be used by the frontend.

    Important: Certificates are not allowed on port 80.

    connectionRateLimit Integer
    The rate limit for new connections established on this frontend. Use 0 value to disable, else value is connections per second.
    enableHttp3 Boolean
    Activates HTTP/3 protocol.
    externalAcls Boolean
    A boolean to specify whether to use lb_acl. If external_acls is set to true, acl can not be set directly in the Load Balancer frontend.
    name String
    The ACL name. If not provided it will be randomly generated.
    timeoutClient String
    Maximum inactivity time on the client side. (e.g. 1s)
    backendId string

    The ID of the Load Balancer backend this frontend is attached to.

    Important: Updates to lb_id or backend_id will recreate the frontend.

    inboundPort number
    TCP port to listen to on the front side.
    lbId string
    The ID of the Load Balancer this frontend is attached to.
    acls LoadbalancerFrontendAcl[]
    A list of ACL rules to apply to the Load Balancer frontend. Defined below.
    certificateIds string[]

    List of certificate IDs that should be used by the frontend.

    Important: Certificates are not allowed on port 80.

    connectionRateLimit number
    The rate limit for new connections established on this frontend. Use 0 value to disable, else value is connections per second.
    enableHttp3 boolean
    Activates HTTP/3 protocol.
    externalAcls boolean
    A boolean to specify whether to use lb_acl. If external_acls is set to true, acl can not be set directly in the Load Balancer frontend.
    name string
    The ACL name. If not provided it will be randomly generated.
    timeoutClient string
    Maximum inactivity time on the client side. (e.g. 1s)
    backend_id str

    The ID of the Load Balancer backend this frontend is attached to.

    Important: Updates to lb_id or backend_id will recreate the frontend.

    inbound_port int
    TCP port to listen to on the front side.
    lb_id str
    The ID of the Load Balancer this frontend is attached to.
    acls Sequence[LoadbalancerFrontendAclArgs]
    A list of ACL rules to apply to the Load Balancer frontend. Defined below.
    certificate_ids Sequence[str]

    List of certificate IDs that should be used by the frontend.

    Important: Certificates are not allowed on port 80.

    connection_rate_limit int
    The rate limit for new connections established on this frontend. Use 0 value to disable, else value is connections per second.
    enable_http3 bool
    Activates HTTP/3 protocol.
    external_acls bool
    A boolean to specify whether to use lb_acl. If external_acls is set to true, acl can not be set directly in the Load Balancer frontend.
    name str
    The ACL name. If not provided it will be randomly generated.
    timeout_client str
    Maximum inactivity time on the client side. (e.g. 1s)
    backendId String

    The ID of the Load Balancer backend this frontend is attached to.

    Important: Updates to lb_id or backend_id will recreate the frontend.

    inboundPort Number
    TCP port to listen to on the front side.
    lbId String
    The ID of the Load Balancer this frontend is attached to.
    acls List<Property Map>
    A list of ACL rules to apply to the Load Balancer frontend. Defined below.
    certificateIds List<String>

    List of certificate IDs that should be used by the frontend.

    Important: Certificates are not allowed on port 80.

    connectionRateLimit Number
    The rate limit for new connections established on this frontend. Use 0 value to disable, else value is connections per second.
    enableHttp3 Boolean
    Activates HTTP/3 protocol.
    externalAcls Boolean
    A boolean to specify whether to use lb_acl. If external_acls is set to true, acl can not be set directly in the Load Balancer frontend.
    name String
    The ACL name. If not provided it will be randomly generated.
    timeoutClient String
    Maximum inactivity time on the client side. (e.g. 1s)

    Outputs

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

    CertificateId string
    (Deprecated, use certificate_ids instead) First certificate ID used by the frontend.

    Deprecated: Please use certificate_ids

    Id string
    The provider-assigned unique ID for this managed resource.
    CertificateId string
    (Deprecated, use certificate_ids instead) First certificate ID used by the frontend.

    Deprecated: Please use certificate_ids

    Id string
    The provider-assigned unique ID for this managed resource.
    certificateId String
    (Deprecated, use certificate_ids instead) First certificate ID used by the frontend.

    Deprecated: Please use certificate_ids

    id String
    The provider-assigned unique ID for this managed resource.
    certificateId string
    (Deprecated, use certificate_ids instead) First certificate ID used by the frontend.

    Deprecated: Please use certificate_ids

    id string
    The provider-assigned unique ID for this managed resource.
    certificate_id str
    (Deprecated, use certificate_ids instead) First certificate ID used by the frontend.

    Deprecated: Please use certificate_ids

    id str
    The provider-assigned unique ID for this managed resource.
    certificateId String
    (Deprecated, use certificate_ids instead) First certificate ID used by the frontend.

    Deprecated: Please use certificate_ids

    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing LoadbalancerFrontend Resource

    Get an existing LoadbalancerFrontend 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?: LoadbalancerFrontendState, opts?: CustomResourceOptions): LoadbalancerFrontend
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        acls: Optional[Sequence[LoadbalancerFrontendAclArgs]] = None,
        backend_id: Optional[str] = None,
        certificate_id: Optional[str] = None,
        certificate_ids: Optional[Sequence[str]] = None,
        connection_rate_limit: Optional[int] = None,
        enable_http3: Optional[bool] = None,
        external_acls: Optional[bool] = None,
        inbound_port: Optional[int] = None,
        lb_id: Optional[str] = None,
        name: Optional[str] = None,
        timeout_client: Optional[str] = None) -> LoadbalancerFrontend
    func GetLoadbalancerFrontend(ctx *Context, name string, id IDInput, state *LoadbalancerFrontendState, opts ...ResourceOption) (*LoadbalancerFrontend, error)
    public static LoadbalancerFrontend Get(string name, Input<string> id, LoadbalancerFrontendState? state, CustomResourceOptions? opts = null)
    public static LoadbalancerFrontend get(String name, Output<String> id, LoadbalancerFrontendState state, CustomResourceOptions options)
    resources:  _:    type: scaleway:LoadbalancerFrontend    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.
    The following state arguments are supported:
    Acls List<Pulumiverse.Scaleway.Inputs.LoadbalancerFrontendAcl>
    A list of ACL rules to apply to the Load Balancer frontend. Defined below.
    BackendId string

    The ID of the Load Balancer backend this frontend is attached to.

    Important: Updates to lb_id or backend_id will recreate the frontend.

    CertificateId string
    (Deprecated, use certificate_ids instead) First certificate ID used by the frontend.

    Deprecated: Please use certificate_ids

    CertificateIds List<string>

    List of certificate IDs that should be used by the frontend.

    Important: Certificates are not allowed on port 80.

    ConnectionRateLimit int
    The rate limit for new connections established on this frontend. Use 0 value to disable, else value is connections per second.
    EnableHttp3 bool
    Activates HTTP/3 protocol.
    ExternalAcls bool
    A boolean to specify whether to use lb_acl. If external_acls is set to true, acl can not be set directly in the Load Balancer frontend.
    InboundPort int
    TCP port to listen to on the front side.
    LbId string
    The ID of the Load Balancer this frontend is attached to.
    Name string
    The ACL name. If not provided it will be randomly generated.
    TimeoutClient string
    Maximum inactivity time on the client side. (e.g. 1s)
    Acls []LoadbalancerFrontendAclArgs
    A list of ACL rules to apply to the Load Balancer frontend. Defined below.
    BackendId string

    The ID of the Load Balancer backend this frontend is attached to.

    Important: Updates to lb_id or backend_id will recreate the frontend.

    CertificateId string
    (Deprecated, use certificate_ids instead) First certificate ID used by the frontend.

    Deprecated: Please use certificate_ids

    CertificateIds []string

    List of certificate IDs that should be used by the frontend.

    Important: Certificates are not allowed on port 80.

    ConnectionRateLimit int
    The rate limit for new connections established on this frontend. Use 0 value to disable, else value is connections per second.
    EnableHttp3 bool
    Activates HTTP/3 protocol.
    ExternalAcls bool
    A boolean to specify whether to use lb_acl. If external_acls is set to true, acl can not be set directly in the Load Balancer frontend.
    InboundPort int
    TCP port to listen to on the front side.
    LbId string
    The ID of the Load Balancer this frontend is attached to.
    Name string
    The ACL name. If not provided it will be randomly generated.
    TimeoutClient string
    Maximum inactivity time on the client side. (e.g. 1s)
    acls List<LoadbalancerFrontendAcl>
    A list of ACL rules to apply to the Load Balancer frontend. Defined below.
    backendId String

    The ID of the Load Balancer backend this frontend is attached to.

    Important: Updates to lb_id or backend_id will recreate the frontend.

    certificateId String
    (Deprecated, use certificate_ids instead) First certificate ID used by the frontend.

    Deprecated: Please use certificate_ids

    certificateIds List<String>

    List of certificate IDs that should be used by the frontend.

    Important: Certificates are not allowed on port 80.

    connectionRateLimit Integer
    The rate limit for new connections established on this frontend. Use 0 value to disable, else value is connections per second.
    enableHttp3 Boolean
    Activates HTTP/3 protocol.
    externalAcls Boolean
    A boolean to specify whether to use lb_acl. If external_acls is set to true, acl can not be set directly in the Load Balancer frontend.
    inboundPort Integer
    TCP port to listen to on the front side.
    lbId String
    The ID of the Load Balancer this frontend is attached to.
    name String
    The ACL name. If not provided it will be randomly generated.
    timeoutClient String
    Maximum inactivity time on the client side. (e.g. 1s)
    acls LoadbalancerFrontendAcl[]
    A list of ACL rules to apply to the Load Balancer frontend. Defined below.
    backendId string

    The ID of the Load Balancer backend this frontend is attached to.

    Important: Updates to lb_id or backend_id will recreate the frontend.

    certificateId string
    (Deprecated, use certificate_ids instead) First certificate ID used by the frontend.

    Deprecated: Please use certificate_ids

    certificateIds string[]

    List of certificate IDs that should be used by the frontend.

    Important: Certificates are not allowed on port 80.

    connectionRateLimit number
    The rate limit for new connections established on this frontend. Use 0 value to disable, else value is connections per second.
    enableHttp3 boolean
    Activates HTTP/3 protocol.
    externalAcls boolean
    A boolean to specify whether to use lb_acl. If external_acls is set to true, acl can not be set directly in the Load Balancer frontend.
    inboundPort number
    TCP port to listen to on the front side.
    lbId string
    The ID of the Load Balancer this frontend is attached to.
    name string
    The ACL name. If not provided it will be randomly generated.
    timeoutClient string
    Maximum inactivity time on the client side. (e.g. 1s)
    acls Sequence[LoadbalancerFrontendAclArgs]
    A list of ACL rules to apply to the Load Balancer frontend. Defined below.
    backend_id str

    The ID of the Load Balancer backend this frontend is attached to.

    Important: Updates to lb_id or backend_id will recreate the frontend.

    certificate_id str
    (Deprecated, use certificate_ids instead) First certificate ID used by the frontend.

    Deprecated: Please use certificate_ids

    certificate_ids Sequence[str]

    List of certificate IDs that should be used by the frontend.

    Important: Certificates are not allowed on port 80.

    connection_rate_limit int
    The rate limit for new connections established on this frontend. Use 0 value to disable, else value is connections per second.
    enable_http3 bool
    Activates HTTP/3 protocol.
    external_acls bool
    A boolean to specify whether to use lb_acl. If external_acls is set to true, acl can not be set directly in the Load Balancer frontend.
    inbound_port int
    TCP port to listen to on the front side.
    lb_id str
    The ID of the Load Balancer this frontend is attached to.
    name str
    The ACL name. If not provided it will be randomly generated.
    timeout_client str
    Maximum inactivity time on the client side. (e.g. 1s)
    acls List<Property Map>
    A list of ACL rules to apply to the Load Balancer frontend. Defined below.
    backendId String

    The ID of the Load Balancer backend this frontend is attached to.

    Important: Updates to lb_id or backend_id will recreate the frontend.

    certificateId String
    (Deprecated, use certificate_ids instead) First certificate ID used by the frontend.

    Deprecated: Please use certificate_ids

    certificateIds List<String>

    List of certificate IDs that should be used by the frontend.

    Important: Certificates are not allowed on port 80.

    connectionRateLimit Number
    The rate limit for new connections established on this frontend. Use 0 value to disable, else value is connections per second.
    enableHttp3 Boolean
    Activates HTTP/3 protocol.
    externalAcls Boolean
    A boolean to specify whether to use lb_acl. If external_acls is set to true, acl can not be set directly in the Load Balancer frontend.
    inboundPort Number
    TCP port to listen to on the front side.
    lbId String
    The ID of the Load Balancer this frontend is attached to.
    name String
    The ACL name. If not provided it will be randomly generated.
    timeoutClient String
    Maximum inactivity time on the client side. (e.g. 1s)

    Supporting Types

    LoadbalancerFrontendAcl, LoadbalancerFrontendAclArgs

    Action Pulumiverse.Scaleway.Inputs.LoadbalancerFrontendAclAction
    Action to undertake when an ACL filter matches.
    Match Pulumiverse.Scaleway.Inputs.LoadbalancerFrontendAclMatch
    The ACL match rule. At least ip_subnet or http_filter and http_filter_value are required.
    CreatedAt string
    IsDate and time of ACL's creation (RFC 3339 format)
    Description string
    Description of the ACL
    Name string
    The ACL name. If not provided it will be randomly generated.
    UpdatedAt string
    IsDate and time of ACL's update (RFC 3339 format)
    Action LoadbalancerFrontendAclAction
    Action to undertake when an ACL filter matches.
    Match LoadbalancerFrontendAclMatch
    The ACL match rule. At least ip_subnet or http_filter and http_filter_value are required.
    CreatedAt string
    IsDate and time of ACL's creation (RFC 3339 format)
    Description string
    Description of the ACL
    Name string
    The ACL name. If not provided it will be randomly generated.
    UpdatedAt string
    IsDate and time of ACL's update (RFC 3339 format)
    action LoadbalancerFrontendAclAction
    Action to undertake when an ACL filter matches.
    match LoadbalancerFrontendAclMatch
    The ACL match rule. At least ip_subnet or http_filter and http_filter_value are required.
    createdAt String
    IsDate and time of ACL's creation (RFC 3339 format)
    description String
    Description of the ACL
    name String
    The ACL name. If not provided it will be randomly generated.
    updatedAt String
    IsDate and time of ACL's update (RFC 3339 format)
    action LoadbalancerFrontendAclAction
    Action to undertake when an ACL filter matches.
    match LoadbalancerFrontendAclMatch
    The ACL match rule. At least ip_subnet or http_filter and http_filter_value are required.
    createdAt string
    IsDate and time of ACL's creation (RFC 3339 format)
    description string
    Description of the ACL
    name string
    The ACL name. If not provided it will be randomly generated.
    updatedAt string
    IsDate and time of ACL's update (RFC 3339 format)
    action LoadbalancerFrontendAclAction
    Action to undertake when an ACL filter matches.
    match LoadbalancerFrontendAclMatch
    The ACL match rule. At least ip_subnet or http_filter and http_filter_value are required.
    created_at str
    IsDate and time of ACL's creation (RFC 3339 format)
    description str
    Description of the ACL
    name str
    The ACL name. If not provided it will be randomly generated.
    updated_at str
    IsDate and time of ACL's update (RFC 3339 format)
    action Property Map
    Action to undertake when an ACL filter matches.
    match Property Map
    The ACL match rule. At least ip_subnet or http_filter and http_filter_value are required.
    createdAt String
    IsDate and time of ACL's creation (RFC 3339 format)
    description String
    Description of the ACL
    name String
    The ACL name. If not provided it will be randomly generated.
    updatedAt String
    IsDate and time of ACL's update (RFC 3339 format)

    LoadbalancerFrontendAclAction, LoadbalancerFrontendAclActionArgs

    Type string
    The action type. Possible values are: allow or deny or redirect.
    Redirects List<Pulumiverse.Scaleway.Inputs.LoadbalancerFrontendAclActionRedirect>
    Redirect parameters when using an ACL with redirect action.
    Type string
    The action type. Possible values are: allow or deny or redirect.
    Redirects []LoadbalancerFrontendAclActionRedirect
    Redirect parameters when using an ACL with redirect action.
    type String
    The action type. Possible values are: allow or deny or redirect.
    redirects List<LoadbalancerFrontendAclActionRedirect>
    Redirect parameters when using an ACL with redirect action.
    type string
    The action type. Possible values are: allow or deny or redirect.
    redirects LoadbalancerFrontendAclActionRedirect[]
    Redirect parameters when using an ACL with redirect action.
    type str
    The action type. Possible values are: allow or deny or redirect.
    redirects Sequence[LoadbalancerFrontendAclActionRedirect]
    Redirect parameters when using an ACL with redirect action.
    type String
    The action type. Possible values are: allow or deny or redirect.
    redirects List<Property Map>
    Redirect parameters when using an ACL with redirect action.

    LoadbalancerFrontendAclActionRedirect, LoadbalancerFrontendAclActionRedirectArgs

    Code int
    The HTTP redirect code to use. Valid values are 301, 302, 303, 307 and 308.
    Target string
    A URL can be used in case of a location redirect (e.g. https://scaleway.com will redirect to this same URL). A scheme name (e.g. https, http, ftp, git) will replace the request's original scheme.
    Type string
    The redirect type. Possible values are: location or scheme.
    Code int
    The HTTP redirect code to use. Valid values are 301, 302, 303, 307 and 308.
    Target string
    A URL can be used in case of a location redirect (e.g. https://scaleway.com will redirect to this same URL). A scheme name (e.g. https, http, ftp, git) will replace the request's original scheme.
    Type string
    The redirect type. Possible values are: location or scheme.
    code Integer
    The HTTP redirect code to use. Valid values are 301, 302, 303, 307 and 308.
    target String
    A URL can be used in case of a location redirect (e.g. https://scaleway.com will redirect to this same URL). A scheme name (e.g. https, http, ftp, git) will replace the request's original scheme.
    type String
    The redirect type. Possible values are: location or scheme.
    code number
    The HTTP redirect code to use. Valid values are 301, 302, 303, 307 and 308.
    target string
    A URL can be used in case of a location redirect (e.g. https://scaleway.com will redirect to this same URL). A scheme name (e.g. https, http, ftp, git) will replace the request's original scheme.
    type string
    The redirect type. Possible values are: location or scheme.
    code int
    The HTTP redirect code to use. Valid values are 301, 302, 303, 307 and 308.
    target str
    A URL can be used in case of a location redirect (e.g. https://scaleway.com will redirect to this same URL). A scheme name (e.g. https, http, ftp, git) will replace the request's original scheme.
    type str
    The redirect type. Possible values are: location or scheme.
    code Number
    The HTTP redirect code to use. Valid values are 301, 302, 303, 307 and 308.
    target String
    A URL can be used in case of a location redirect (e.g. https://scaleway.com will redirect to this same URL). A scheme name (e.g. https, http, ftp, git) will replace the request's original scheme.
    type String
    The redirect type. Possible values are: location or scheme.

    LoadbalancerFrontendAclMatch, LoadbalancerFrontendAclMatchArgs

    HttpFilter string
    The HTTP filter to match. This filter is supported only if your backend protocol has an HTTP forward protocol. It extracts the request's URL path, which starts at the first slash and ends before the question mark (without the host part). Possible values are: acl_http_filter_none, path_begin, path_end, http_header_match or regex.
    HttpFilterOption string
    If you have http_filter at http_header_match, you can use this field to filter on the HTTP header's value.
    HttpFilterValues List<string>
    A list of possible values to match for the given HTTP filter. Keep in mind that in the case of http_header_match the HTTP header field name is case insensitive.
    Invert bool
    If set to true, the condition will be of type "unless".
    IpSubnets List<string>
    A list of IPs, or CIDR v4/v6 addresses of the session client, to match.
    HttpFilter string
    The HTTP filter to match. This filter is supported only if your backend protocol has an HTTP forward protocol. It extracts the request's URL path, which starts at the first slash and ends before the question mark (without the host part). Possible values are: acl_http_filter_none, path_begin, path_end, http_header_match or regex.
    HttpFilterOption string
    If you have http_filter at http_header_match, you can use this field to filter on the HTTP header's value.
    HttpFilterValues []string
    A list of possible values to match for the given HTTP filter. Keep in mind that in the case of http_header_match the HTTP header field name is case insensitive.
    Invert bool
    If set to true, the condition will be of type "unless".
    IpSubnets []string
    A list of IPs, or CIDR v4/v6 addresses of the session client, to match.
    httpFilter String
    The HTTP filter to match. This filter is supported only if your backend protocol has an HTTP forward protocol. It extracts the request's URL path, which starts at the first slash and ends before the question mark (without the host part). Possible values are: acl_http_filter_none, path_begin, path_end, http_header_match or regex.
    httpFilterOption String
    If you have http_filter at http_header_match, you can use this field to filter on the HTTP header's value.
    httpFilterValues List<String>
    A list of possible values to match for the given HTTP filter. Keep in mind that in the case of http_header_match the HTTP header field name is case insensitive.
    invert Boolean
    If set to true, the condition will be of type "unless".
    ipSubnets List<String>
    A list of IPs, or CIDR v4/v6 addresses of the session client, to match.
    httpFilter string
    The HTTP filter to match. This filter is supported only if your backend protocol has an HTTP forward protocol. It extracts the request's URL path, which starts at the first slash and ends before the question mark (without the host part). Possible values are: acl_http_filter_none, path_begin, path_end, http_header_match or regex.
    httpFilterOption string
    If you have http_filter at http_header_match, you can use this field to filter on the HTTP header's value.
    httpFilterValues string[]
    A list of possible values to match for the given HTTP filter. Keep in mind that in the case of http_header_match the HTTP header field name is case insensitive.
    invert boolean
    If set to true, the condition will be of type "unless".
    ipSubnets string[]
    A list of IPs, or CIDR v4/v6 addresses of the session client, to match.
    http_filter str
    The HTTP filter to match. This filter is supported only if your backend protocol has an HTTP forward protocol. It extracts the request's URL path, which starts at the first slash and ends before the question mark (without the host part). Possible values are: acl_http_filter_none, path_begin, path_end, http_header_match or regex.
    http_filter_option str
    If you have http_filter at http_header_match, you can use this field to filter on the HTTP header's value.
    http_filter_values Sequence[str]
    A list of possible values to match for the given HTTP filter. Keep in mind that in the case of http_header_match the HTTP header field name is case insensitive.
    invert bool
    If set to true, the condition will be of type "unless".
    ip_subnets Sequence[str]
    A list of IPs, or CIDR v4/v6 addresses of the session client, to match.
    httpFilter String
    The HTTP filter to match. This filter is supported only if your backend protocol has an HTTP forward protocol. It extracts the request's URL path, which starts at the first slash and ends before the question mark (without the host part). Possible values are: acl_http_filter_none, path_begin, path_end, http_header_match or regex.
    httpFilterOption String
    If you have http_filter at http_header_match, you can use this field to filter on the HTTP header's value.
    httpFilterValues List<String>
    A list of possible values to match for the given HTTP filter. Keep in mind that in the case of http_header_match the HTTP header field name is case insensitive.
    invert Boolean
    If set to true, the condition will be of type "unless".
    ipSubnets List<String>
    A list of IPs, or CIDR v4/v6 addresses of the session client, to match.

    Import

    Load Balancer frontends can be imported using {zone}/{id}, e.g.

    bash

    $ pulumi import scaleway:index/loadbalancerFrontend:LoadbalancerFrontend frontend01 fr-par-1/11111111-1111-1111-1111-111111111111

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

    Package Details

    Repository
    scaleway pulumiverse/pulumi-scaleway
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the scaleway Terraform Provider.
    scaleway logo
    Scaleway v1.27.1 published on Wednesday, Apr 30, 2025 by pulumiverse
    pulumiverse/pulumi-scaleway