1. Registry
  2. Packages
  3. OVH
  4. API Docs
  5. CloudLoadbalancerListener
Viewing docs for OVHCloud v2.21.0
published on Friday, Sep 25, 2026 by OVHcloud
ovh logo
Viewing docs for OVHCloud v2.21.0
published on Friday, Sep 25, 2026 by OVHcloud

    Creates a listener on a load balancer in a public cloud project.

    Example Usage

    Basic HTTP Listener

    import * as pulumi from "@pulumi/pulumi";
    import * as ovh from "@ovhcloud/pulumi-ovh";
    
    const http = new ovh.CloudLoadbalancerListener("http", {
        serviceName: "xxxxxxxxxx",
        loadbalancerId: lb.id,
        name: "http-listener",
        protocol: "HTTP",
        protocolPort: 80,
    });
    
    import pulumi
    import pulumi_ovh as ovh
    
    http = ovh.CloudLoadbalancerListener("http",
        service_name="xxxxxxxxxx",
        loadbalancer_id=lb["id"],
        name="http-listener",
        protocol="HTTP",
        protocol_port=80)
    
    package main
    
    import (
    	"github.com/ovh/pulumi-ovh/sdk/v2/go/ovh"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ovh.NewCloudLoadbalancerListener(ctx, "http", &ovh.CloudLoadbalancerListenerArgs{
    			ServiceName:    pulumi.String("xxxxxxxxxx"),
    			LoadbalancerId: pulumi.Any(lb.Id),
    			Name:           pulumi.String("http-listener"),
    			Protocol:       pulumi.String("HTTP"),
    			ProtocolPort:   pulumi.Int(80),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ovh = Pulumi.Ovh;
    
    return await Deployment.RunAsync(() => 
    {
        var http = new Ovh.CloudLoadbalancerListener("http", new()
        {
            ServiceName = "xxxxxxxxxx",
            LoadbalancerId = lb.Id,
            Name = "http-listener",
            Protocol = "HTTP",
            ProtocolPort = 80,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.ovhcloud.pulumi.ovh.CloudLoadbalancerListener;
    import com.ovhcloud.pulumi.ovh.CloudLoadbalancerListenerArgs;
    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 http = new CloudLoadbalancerListener("http", CloudLoadbalancerListenerArgs.builder()
                .serviceName("xxxxxxxxxx")
                .loadbalancerId(lb.id())
                .name("http-listener")
                .protocol("HTTP")
                .protocolPort(80)
                .build());
    
        }
    }
    
    resources:
      http:
        type: ovh:CloudLoadbalancerListener
        properties:
          serviceName: xxxxxxxxxx
          loadbalancerId: ${lb.id}
          name: http-listener
          protocol: HTTP
          protocolPort: 80
    
    Example coming soon!
    

    HTTPS Listener with TLS and Insert Headers

    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    resources:
      https:
        type: ovh:CloudLoadbalancerListener
        properties:
          serviceName: xxxxxxxxxx
          loadbalancerId: ${lb.id}
          name: https-listener
          protocol: TERMINATED_HTTPS
          protocolPort: 443
          description: HTTPS listener with TLS termination
          defaultTlsContainerRef: https://key-manager.cloud.ovh.net/v1/containers/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
          tlsVersions:
            - TLSv1.2
            - TLSv1.3
          insertHeaders:
            x_forwarded_for: true
            x_forwarded_port: true
            x_forwarded_proto: true
          timeoutClientData: 50000
          timeoutMemberData: 50000
          timeoutMemberConnect: 5000
    
    Example coming soon!
    

    Create CloudLoadbalancerListener Resource

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

    Constructor syntax

    new CloudLoadbalancerListener(name: string, args: CloudLoadbalancerListenerArgs, opts?: CustomResourceOptions);
    @overload
    def CloudLoadbalancerListener(resource_name: str,
                                  args: CloudLoadbalancerListenerArgs,
                                  opts: Optional[ResourceOptions] = None)
    
    @overload
    def CloudLoadbalancerListener(resource_name: str,
                                  opts: Optional[ResourceOptions] = None,
                                  loadbalancer_id: Optional[str] = None,
                                  service_name: Optional[str] = None,
                                  protocol_port: Optional[int] = None,
                                  protocol: Optional[str] = None,
                                  description: Optional[str] = None,
                                  insert_headers: Optional[CloudLoadbalancerListenerInsertHeadersArgs] = None,
                                  allowed_cidrs: Optional[Sequence[str]] = None,
                                  name: Optional[str] = None,
                                  default_tls_container_ref: Optional[str] = None,
                                  default_pool_id: Optional[str] = None,
                                  connection_limit: Optional[int] = None,
                                  sni_container_refs: Optional[Sequence[str]] = None,
                                  timeout_client_data: Optional[int] = None,
                                  timeout_member_connect: Optional[int] = None,
                                  timeout_member_data: Optional[int] = None,
                                  timeout_tcp_inspect: Optional[int] = None,
                                  tls_versions: Optional[Sequence[str]] = None)
    func NewCloudLoadbalancerListener(ctx *Context, name string, args CloudLoadbalancerListenerArgs, opts ...ResourceOption) (*CloudLoadbalancerListener, error)
    public CloudLoadbalancerListener(string name, CloudLoadbalancerListenerArgs args, CustomResourceOptions? opts = null)
    public CloudLoadbalancerListener(String name, CloudLoadbalancerListenerArgs args)
    public CloudLoadbalancerListener(String name, CloudLoadbalancerListenerArgs args, CustomResourceOptions options)
    
    type: ovh:CloudLoadbalancerListener
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "ovh_cloud_loadbalancer_listener" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args CloudLoadbalancerListenerArgs
    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 CloudLoadbalancerListenerArgs
    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 CloudLoadbalancerListenerArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args CloudLoadbalancerListenerArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args CloudLoadbalancerListenerArgs
    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 cloudLoadbalancerListenerResource = new Ovh.CloudLoadbalancerListener("cloudLoadbalancerListenerResource", new()
    {
        LoadbalancerId = "string",
        ServiceName = "string",
        ProtocolPort = 0,
        Protocol = "string",
        Description = "string",
        InsertHeaders = new Ovh.Inputs.CloudLoadbalancerListenerInsertHeadersArgs
        {
            XForwardedFor = false,
            XForwardedPort = false,
            XForwardedProto = false,
            XSslClientDn = false,
            XSslClientHasCert = false,
            XSslClientVerify = false,
        },
        AllowedCidrs = new[]
        {
            "string",
        },
        Name = "string",
        DefaultTlsContainerRef = "string",
        DefaultPoolId = "string",
        ConnectionLimit = 0,
        SniContainerRefs = new[]
        {
            "string",
        },
        TimeoutClientData = 0,
        TimeoutMemberConnect = 0,
        TimeoutMemberData = 0,
        TimeoutTcpInspect = 0,
        TlsVersions = new[]
        {
            "string",
        },
    });
    
    example, err := ovh.NewCloudLoadbalancerListener(ctx, "cloudLoadbalancerListenerResource", &ovh.CloudLoadbalancerListenerArgs{
    	LoadbalancerId: pulumi.String("string"),
    	ServiceName:    pulumi.String("string"),
    	ProtocolPort:   pulumi.Int(0),
    	Protocol:       pulumi.String("string"),
    	Description:    pulumi.String("string"),
    	InsertHeaders: &ovh.CloudLoadbalancerListenerInsertHeadersArgs{
    		XForwardedFor:     pulumi.Bool(false),
    		XForwardedPort:    pulumi.Bool(false),
    		XForwardedProto:   pulumi.Bool(false),
    		XSslClientDn:      pulumi.Bool(false),
    		XSslClientHasCert: pulumi.Bool(false),
    		XSslClientVerify:  pulumi.Bool(false),
    	},
    	AllowedCidrs: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Name:                   pulumi.String("string"),
    	DefaultTlsContainerRef: pulumi.String("string"),
    	DefaultPoolId:          pulumi.String("string"),
    	ConnectionLimit:        pulumi.Int(0),
    	SniContainerRefs: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	TimeoutClientData:    pulumi.Int(0),
    	TimeoutMemberConnect: pulumi.Int(0),
    	TimeoutMemberData:    pulumi.Int(0),
    	TimeoutTcpInspect:    pulumi.Int(0),
    	TlsVersions: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    })
    
    resource "ovh_cloud_loadbalancer_listener" "cloudLoadbalancerListenerResource" {
      lifecycle {
        create_before_destroy = true
      }
      loadbalancer_id = "string"
      service_name    = "string"
      protocol_port   = 0
      protocol        = "string"
      description     = "string"
      insert_headers = {
        x_forwarded_for       = false
        x_forwarded_port      = false
        x_forwarded_proto     = false
        x_ssl_client_dn       = false
        x_ssl_client_has_cert = false
        x_ssl_client_verify   = false
      }
      allowed_cidrs             = ["string"]
      name                      = "string"
      default_tls_container_ref = "string"
      default_pool_id           = "string"
      connection_limit          = 0
      sni_container_refs        = ["string"]
      timeout_client_data       = 0
      timeout_member_connect    = 0
      timeout_member_data       = 0
      timeout_tcp_inspect       = 0
      tls_versions              = ["string"]
    }
    
    var cloudLoadbalancerListenerResource = new CloudLoadbalancerListener("cloudLoadbalancerListenerResource", CloudLoadbalancerListenerArgs.builder()
        .loadbalancerId("string")
        .serviceName("string")
        .protocolPort(0)
        .protocol("string")
        .description("string")
        .insertHeaders(CloudLoadbalancerListenerInsertHeadersArgs.builder()
            .xForwardedFor(false)
            .xForwardedPort(false)
            .xForwardedProto(false)
            .xSslClientDn(false)
            .xSslClientHasCert(false)
            .xSslClientVerify(false)
            .build())
        .allowedCidrs("string")
        .name("string")
        .defaultTlsContainerRef("string")
        .defaultPoolId("string")
        .connectionLimit(0)
        .sniContainerRefs("string")
        .timeoutClientData(0)
        .timeoutMemberConnect(0)
        .timeoutMemberData(0)
        .timeoutTcpInspect(0)
        .tlsVersions("string")
        .build());
    
    cloud_loadbalancer_listener_resource = ovh.CloudLoadbalancerListener("cloudLoadbalancerListenerResource",
        loadbalancer_id="string",
        service_name="string",
        protocol_port=0,
        protocol="string",
        description="string",
        insert_headers={
            "x_forwarded_for": False,
            "x_forwarded_port": False,
            "x_forwarded_proto": False,
            "x_ssl_client_dn": False,
            "x_ssl_client_has_cert": False,
            "x_ssl_client_verify": False,
        },
        allowed_cidrs=["string"],
        name="string",
        default_tls_container_ref="string",
        default_pool_id="string",
        connection_limit=0,
        sni_container_refs=["string"],
        timeout_client_data=0,
        timeout_member_connect=0,
        timeout_member_data=0,
        timeout_tcp_inspect=0,
        tls_versions=["string"])
    
    const cloudLoadbalancerListenerResource = new ovh.CloudLoadbalancerListener("cloudLoadbalancerListenerResource", {
        loadbalancerId: "string",
        serviceName: "string",
        protocolPort: 0,
        protocol: "string",
        description: "string",
        insertHeaders: {
            xForwardedFor: false,
            xForwardedPort: false,
            xForwardedProto: false,
            xSslClientDn: false,
            xSslClientHasCert: false,
            xSslClientVerify: false,
        },
        allowedCidrs: ["string"],
        name: "string",
        defaultTlsContainerRef: "string",
        defaultPoolId: "string",
        connectionLimit: 0,
        sniContainerRefs: ["string"],
        timeoutClientData: 0,
        timeoutMemberConnect: 0,
        timeoutMemberData: 0,
        timeoutTcpInspect: 0,
        tlsVersions: ["string"],
    });
    
    type: ovh:CloudLoadbalancerListener
    properties:
        allowedCidrs:
            - string
        connectionLimit: 0
        defaultPoolId: string
        defaultTlsContainerRef: string
        description: string
        insertHeaders:
            xForwardedFor: false
            xForwardedPort: false
            xForwardedProto: false
            xSslClientDn: false
            xSslClientHasCert: false
            xSslClientVerify: false
        loadbalancerId: string
        name: string
        protocol: string
        protocolPort: 0
        serviceName: string
        sniContainerRefs:
            - string
        timeoutClientData: 0
        timeoutMemberConnect: 0
        timeoutMemberData: 0
        timeoutTcpInspect: 0
        tlsVersions:
            - string
    

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

    LoadbalancerId string
    ID of the load balancer. Changing this value recreates the resource.
    Protocol string
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    ProtocolPort int
    Port number the listener listens on. Changing this value recreates the resource.
    ServiceName string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    AllowedCidrs List<string>
    List of CIDRs allowed to access the listener.
    ConnectionLimit int
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    DefaultPoolId string
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    DefaultTlsContainerRef string
    Reference to the default TLS container.
    Description string
    Description of the listener.
    InsertHeaders CloudLoadbalancerListenerInsertHeaders
    Headers to insert into requests:
    Name string
    Name of the listener.
    SniContainerRefs List<string>
    List of SNI container references.
    TimeoutClientData int
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutMemberConnect int
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutMemberData int
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutTcpInspect int
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TlsVersions List<string>
    List of TLS versions allowed.
    LoadbalancerId string
    ID of the load balancer. Changing this value recreates the resource.
    Protocol string
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    ProtocolPort int
    Port number the listener listens on. Changing this value recreates the resource.
    ServiceName string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    AllowedCidrs []string
    List of CIDRs allowed to access the listener.
    ConnectionLimit int
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    DefaultPoolId string
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    DefaultTlsContainerRef string
    Reference to the default TLS container.
    Description string
    Description of the listener.
    InsertHeaders CloudLoadbalancerListenerInsertHeadersArgs
    Headers to insert into requests:
    Name string
    Name of the listener.
    SniContainerRefs []string
    List of SNI container references.
    TimeoutClientData int
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutMemberConnect int
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutMemberData int
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutTcpInspect int
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TlsVersions []string
    List of TLS versions allowed.
    loadbalancer_id string
    ID of the load balancer. Changing this value recreates the resource.
    protocol string
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    protocol_port number
    Port number the listener listens on. Changing this value recreates the resource.
    service_name string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    allowed_cidrs list(string)
    List of CIDRs allowed to access the listener.
    connection_limit number
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    default_pool_id string
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    default_tls_container_ref string
    Reference to the default TLS container.
    description string
    Description of the listener.
    insert_headers object
    Headers to insert into requests:
    name string
    Name of the listener.
    sni_container_refs list(string)
    List of SNI container references.
    timeout_client_data number
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_member_connect number
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_member_data number
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_tcp_inspect number
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    tls_versions list(string)
    List of TLS versions allowed.
    loadbalancerId String
    ID of the load balancer. Changing this value recreates the resource.
    protocol String
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    protocolPort Integer
    Port number the listener listens on. Changing this value recreates the resource.
    serviceName String
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    allowedCidrs List<String>
    List of CIDRs allowed to access the listener.
    connectionLimit Integer
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    defaultPoolId String
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    defaultTlsContainerRef String
    Reference to the default TLS container.
    description String
    Description of the listener.
    insertHeaders CloudLoadbalancerListenerInsertHeaders
    Headers to insert into requests:
    name String
    Name of the listener.
    sniContainerRefs List<String>
    List of SNI container references.
    timeoutClientData Integer
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberConnect Integer
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberData Integer
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutTcpInspect Integer
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    tlsVersions List<String>
    List of TLS versions allowed.
    loadbalancerId string
    ID of the load balancer. Changing this value recreates the resource.
    protocol string
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    protocolPort number
    Port number the listener listens on. Changing this value recreates the resource.
    serviceName string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    allowedCidrs string[]
    List of CIDRs allowed to access the listener.
    connectionLimit number
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    defaultPoolId string
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    defaultTlsContainerRef string
    Reference to the default TLS container.
    description string
    Description of the listener.
    insertHeaders CloudLoadbalancerListenerInsertHeaders
    Headers to insert into requests:
    name string
    Name of the listener.
    sniContainerRefs string[]
    List of SNI container references.
    timeoutClientData number
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberConnect number
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberData number
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutTcpInspect number
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    tlsVersions string[]
    List of TLS versions allowed.
    loadbalancer_id str
    ID of the load balancer. Changing this value recreates the resource.
    protocol str
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    protocol_port int
    Port number the listener listens on. Changing this value recreates the resource.
    service_name str
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    allowed_cidrs Sequence[str]
    List of CIDRs allowed to access the listener.
    connection_limit int
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    default_pool_id str
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    default_tls_container_ref str
    Reference to the default TLS container.
    description str
    Description of the listener.
    insert_headers CloudLoadbalancerListenerInsertHeadersArgs
    Headers to insert into requests:
    name str
    Name of the listener.
    sni_container_refs Sequence[str]
    List of SNI container references.
    timeout_client_data int
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_member_connect int
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_member_data int
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_tcp_inspect int
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    tls_versions Sequence[str]
    List of TLS versions allowed.
    loadbalancerId String
    ID of the load balancer. Changing this value recreates the resource.
    protocol String
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    protocolPort Number
    Port number the listener listens on. Changing this value recreates the resource.
    serviceName String
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    allowedCidrs List<String>
    List of CIDRs allowed to access the listener.
    connectionLimit Number
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    defaultPoolId String
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    defaultTlsContainerRef String
    Reference to the default TLS container.
    description String
    Description of the listener.
    insertHeaders Property Map
    Headers to insert into requests:
    name String
    Name of the listener.
    sniContainerRefs List<String>
    List of SNI container references.
    timeoutClientData Number
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberConnect Number
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberData Number
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutTcpInspect Number
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    tlsVersions List<String>
    List of TLS versions allowed.

    Outputs

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

    Checksum string
    Computed hash representing the current target specification value.
    CreatedAt string
    Creation date of the listener.
    CurrentState CloudLoadbalancerListenerCurrentState
    Current state of the listener:
    Id string
    The provider-assigned unique ID for this managed resource.
    ResourceStatus string
    Listener readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    UpdatedAt string
    Last update date of the listener.
    Checksum string
    Computed hash representing the current target specification value.
    CreatedAt string
    Creation date of the listener.
    CurrentState CloudLoadbalancerListenerCurrentState
    Current state of the listener:
    Id string
    The provider-assigned unique ID for this managed resource.
    ResourceStatus string
    Listener readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    UpdatedAt string
    Last update date of the listener.
    checksum string
    Computed hash representing the current target specification value.
    created_at string
    Creation date of the listener.
    current_state object
    Current state of the listener:
    id string
    The provider-assigned unique ID for this managed resource.
    resource_status string
    Listener readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    updated_at string
    Last update date of the listener.
    checksum String
    Computed hash representing the current target specification value.
    createdAt String
    Creation date of the listener.
    currentState CloudLoadbalancerListenerCurrentState
    Current state of the listener:
    id String
    The provider-assigned unique ID for this managed resource.
    resourceStatus String
    Listener readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    updatedAt String
    Last update date of the listener.
    checksum string
    Computed hash representing the current target specification value.
    createdAt string
    Creation date of the listener.
    currentState CloudLoadbalancerListenerCurrentState
    Current state of the listener:
    id string
    The provider-assigned unique ID for this managed resource.
    resourceStatus string
    Listener readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    updatedAt string
    Last update date of the listener.
    checksum str
    Computed hash representing the current target specification value.
    created_at str
    Creation date of the listener.
    current_state CloudLoadbalancerListenerCurrentState
    Current state of the listener:
    id str
    The provider-assigned unique ID for this managed resource.
    resource_status str
    Listener readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    updated_at str
    Last update date of the listener.
    checksum String
    Computed hash representing the current target specification value.
    createdAt String
    Creation date of the listener.
    currentState Property Map
    Current state of the listener:
    id String
    The provider-assigned unique ID for this managed resource.
    resourceStatus String
    Listener readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    updatedAt String
    Last update date of the listener.

    Look up Existing CloudLoadbalancerListener Resource

    Get an existing CloudLoadbalancerListener 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?: CloudLoadbalancerListenerState, opts?: CustomResourceOptions): CloudLoadbalancerListener
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            allowed_cidrs: Optional[Sequence[str]] = None,
            checksum: Optional[str] = None,
            connection_limit: Optional[int] = None,
            created_at: Optional[str] = None,
            current_state: Optional[CloudLoadbalancerListenerCurrentStateArgs] = None,
            default_pool_id: Optional[str] = None,
            default_tls_container_ref: Optional[str] = None,
            description: Optional[str] = None,
            insert_headers: Optional[CloudLoadbalancerListenerInsertHeadersArgs] = None,
            loadbalancer_id: Optional[str] = None,
            name: Optional[str] = None,
            protocol: Optional[str] = None,
            protocol_port: Optional[int] = None,
            resource_status: Optional[str] = None,
            service_name: Optional[str] = None,
            sni_container_refs: Optional[Sequence[str]] = None,
            timeout_client_data: Optional[int] = None,
            timeout_member_connect: Optional[int] = None,
            timeout_member_data: Optional[int] = None,
            timeout_tcp_inspect: Optional[int] = None,
            tls_versions: Optional[Sequence[str]] = None,
            updated_at: Optional[str] = None) -> CloudLoadbalancerListener
    func GetCloudLoadbalancerListener(ctx *Context, name string, id IDInput, state *CloudLoadbalancerListenerState, opts ...ResourceOption) (*CloudLoadbalancerListener, error)
    public static CloudLoadbalancerListener Get(string name, Input<string> id, CloudLoadbalancerListenerState? state, CustomResourceOptions? opts = null)
    public static CloudLoadbalancerListener get(String name, Output<String> id, CloudLoadbalancerListenerState state, CustomResourceOptions options)
    resources:  _:    type: ovh:CloudLoadbalancerListener    get:      id: ${id}
    import {
      to = ovh_cloud_loadbalancer_listener.example
      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:
    AllowedCidrs List<string>
    List of CIDRs allowed to access the listener.
    Checksum string
    Computed hash representing the current target specification value.
    ConnectionLimit int
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    CreatedAt string
    Creation date of the listener.
    CurrentState CloudLoadbalancerListenerCurrentState
    Current state of the listener:
    DefaultPoolId string
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    DefaultTlsContainerRef string
    Reference to the default TLS container.
    Description string
    Description of the listener.
    InsertHeaders CloudLoadbalancerListenerInsertHeaders
    Headers to insert into requests:
    LoadbalancerId string
    ID of the load balancer. Changing this value recreates the resource.
    Name string
    Name of the listener.
    Protocol string
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    ProtocolPort int
    Port number the listener listens on. Changing this value recreates the resource.
    ResourceStatus string
    Listener readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    ServiceName string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    SniContainerRefs List<string>
    List of SNI container references.
    TimeoutClientData int
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutMemberConnect int
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutMemberData int
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutTcpInspect int
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TlsVersions List<string>
    List of TLS versions allowed.
    UpdatedAt string
    Last update date of the listener.
    AllowedCidrs []string
    List of CIDRs allowed to access the listener.
    Checksum string
    Computed hash representing the current target specification value.
    ConnectionLimit int
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    CreatedAt string
    Creation date of the listener.
    CurrentState CloudLoadbalancerListenerCurrentStateArgs
    Current state of the listener:
    DefaultPoolId string
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    DefaultTlsContainerRef string
    Reference to the default TLS container.
    Description string
    Description of the listener.
    InsertHeaders CloudLoadbalancerListenerInsertHeadersArgs
    Headers to insert into requests:
    LoadbalancerId string
    ID of the load balancer. Changing this value recreates the resource.
    Name string
    Name of the listener.
    Protocol string
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    ProtocolPort int
    Port number the listener listens on. Changing this value recreates the resource.
    ResourceStatus string
    Listener readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    ServiceName string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    SniContainerRefs []string
    List of SNI container references.
    TimeoutClientData int
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutMemberConnect int
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutMemberData int
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutTcpInspect int
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TlsVersions []string
    List of TLS versions allowed.
    UpdatedAt string
    Last update date of the listener.
    allowed_cidrs list(string)
    List of CIDRs allowed to access the listener.
    checksum string
    Computed hash representing the current target specification value.
    connection_limit number
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    created_at string
    Creation date of the listener.
    current_state object
    Current state of the listener:
    default_pool_id string
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    default_tls_container_ref string
    Reference to the default TLS container.
    description string
    Description of the listener.
    insert_headers object
    Headers to insert into requests:
    loadbalancer_id string
    ID of the load balancer. Changing this value recreates the resource.
    name string
    Name of the listener.
    protocol string
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    protocol_port number
    Port number the listener listens on. Changing this value recreates the resource.
    resource_status string
    Listener readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    service_name string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    sni_container_refs list(string)
    List of SNI container references.
    timeout_client_data number
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_member_connect number
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_member_data number
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_tcp_inspect number
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    tls_versions list(string)
    List of TLS versions allowed.
    updated_at string
    Last update date of the listener.
    allowedCidrs List<String>
    List of CIDRs allowed to access the listener.
    checksum String
    Computed hash representing the current target specification value.
    connectionLimit Integer
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    createdAt String
    Creation date of the listener.
    currentState CloudLoadbalancerListenerCurrentState
    Current state of the listener:
    defaultPoolId String
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    defaultTlsContainerRef String
    Reference to the default TLS container.
    description String
    Description of the listener.
    insertHeaders CloudLoadbalancerListenerInsertHeaders
    Headers to insert into requests:
    loadbalancerId String
    ID of the load balancer. Changing this value recreates the resource.
    name String
    Name of the listener.
    protocol String
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    protocolPort Integer
    Port number the listener listens on. Changing this value recreates the resource.
    resourceStatus String
    Listener readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    serviceName String
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    sniContainerRefs List<String>
    List of SNI container references.
    timeoutClientData Integer
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberConnect Integer
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberData Integer
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutTcpInspect Integer
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    tlsVersions List<String>
    List of TLS versions allowed.
    updatedAt String
    Last update date of the listener.
    allowedCidrs string[]
    List of CIDRs allowed to access the listener.
    checksum string
    Computed hash representing the current target specification value.
    connectionLimit number
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    createdAt string
    Creation date of the listener.
    currentState CloudLoadbalancerListenerCurrentState
    Current state of the listener:
    defaultPoolId string
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    defaultTlsContainerRef string
    Reference to the default TLS container.
    description string
    Description of the listener.
    insertHeaders CloudLoadbalancerListenerInsertHeaders
    Headers to insert into requests:
    loadbalancerId string
    ID of the load balancer. Changing this value recreates the resource.
    name string
    Name of the listener.
    protocol string
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    protocolPort number
    Port number the listener listens on. Changing this value recreates the resource.
    resourceStatus string
    Listener readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    serviceName string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    sniContainerRefs string[]
    List of SNI container references.
    timeoutClientData number
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberConnect number
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberData number
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutTcpInspect number
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    tlsVersions string[]
    List of TLS versions allowed.
    updatedAt string
    Last update date of the listener.
    allowed_cidrs Sequence[str]
    List of CIDRs allowed to access the listener.
    checksum str
    Computed hash representing the current target specification value.
    connection_limit int
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    created_at str
    Creation date of the listener.
    current_state CloudLoadbalancerListenerCurrentStateArgs
    Current state of the listener:
    default_pool_id str
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    default_tls_container_ref str
    Reference to the default TLS container.
    description str
    Description of the listener.
    insert_headers CloudLoadbalancerListenerInsertHeadersArgs
    Headers to insert into requests:
    loadbalancer_id str
    ID of the load balancer. Changing this value recreates the resource.
    name str
    Name of the listener.
    protocol str
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    protocol_port int
    Port number the listener listens on. Changing this value recreates the resource.
    resource_status str
    Listener readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    service_name str
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    sni_container_refs Sequence[str]
    List of SNI container references.
    timeout_client_data int
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_member_connect int
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_member_data int
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_tcp_inspect int
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    tls_versions Sequence[str]
    List of TLS versions allowed.
    updated_at str
    Last update date of the listener.
    allowedCidrs List<String>
    List of CIDRs allowed to access the listener.
    checksum String
    Computed hash representing the current target specification value.
    connectionLimit Number
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    createdAt String
    Creation date of the listener.
    currentState Property Map
    Current state of the listener:
    defaultPoolId String
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    defaultTlsContainerRef String
    Reference to the default TLS container.
    description String
    Description of the listener.
    insertHeaders Property Map
    Headers to insert into requests:
    loadbalancerId String
    ID of the load balancer. Changing this value recreates the resource.
    name String
    Name of the listener.
    protocol String
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    protocolPort Number
    Port number the listener listens on. Changing this value recreates the resource.
    resourceStatus String
    Listener readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    serviceName String
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    sniContainerRefs List<String>
    List of SNI container references.
    timeoutClientData Number
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberConnect Number
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberData Number
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutTcpInspect Number
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    tlsVersions List<String>
    List of TLS versions allowed.
    updatedAt String
    Last update date of the listener.

    Supporting Types

    CloudLoadbalancerListenerCurrentState, CloudLoadbalancerListenerCurrentStateArgs

    AllowedCidrs List<string>
    List of CIDRs allowed to access the listener.
    AvailabilityZone string
    Availability zone.
    ConnectionLimit int
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    DefaultPoolId string
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    DefaultTlsContainerRef string
    Reference to the default TLS container.
    Description string
    Description of the listener.
    InsertHeaders CloudLoadbalancerListenerCurrentStateInsertHeaders
    Headers to insert into requests:
    Name string
    Name of the listener.
    OperatingStatus string
    Operating status of the listener.
    Protocol string
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    ProtocolPort int
    Port number the listener listens on. Changing this value recreates the resource.
    ProvisioningStatus string
    Provisioning status of the listener.
    Region string
    Region.
    SniContainerRefs List<string>
    List of SNI container references.
    TimeoutClientData int
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutMemberConnect int
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutMemberData int
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutTcpInspect int
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TlsVersions List<string>
    List of TLS versions allowed.
    AllowedCidrs []string
    List of CIDRs allowed to access the listener.
    AvailabilityZone string
    Availability zone.
    ConnectionLimit int
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    DefaultPoolId string
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    DefaultTlsContainerRef string
    Reference to the default TLS container.
    Description string
    Description of the listener.
    InsertHeaders CloudLoadbalancerListenerCurrentStateInsertHeaders
    Headers to insert into requests:
    Name string
    Name of the listener.
    OperatingStatus string
    Operating status of the listener.
    Protocol string
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    ProtocolPort int
    Port number the listener listens on. Changing this value recreates the resource.
    ProvisioningStatus string
    Provisioning status of the listener.
    Region string
    Region.
    SniContainerRefs []string
    List of SNI container references.
    TimeoutClientData int
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutMemberConnect int
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutMemberData int
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TimeoutTcpInspect int
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    TlsVersions []string
    List of TLS versions allowed.
    allowed_cidrs list(string)
    List of CIDRs allowed to access the listener.
    availability_zone string
    Availability zone.
    connection_limit number
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    default_pool_id string
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    default_tls_container_ref string
    Reference to the default TLS container.
    description string
    Description of the listener.
    insert_headers object
    Headers to insert into requests:
    name string
    Name of the listener.
    operating_status string
    Operating status of the listener.
    protocol string
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    protocol_port number
    Port number the listener listens on. Changing this value recreates the resource.
    provisioning_status string
    Provisioning status of the listener.
    region string
    Region.
    sni_container_refs list(string)
    List of SNI container references.
    timeout_client_data number
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_member_connect number
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_member_data number
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_tcp_inspect number
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    tls_versions list(string)
    List of TLS versions allowed.
    allowedCidrs List<String>
    List of CIDRs allowed to access the listener.
    availabilityZone String
    Availability zone.
    connectionLimit Integer
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    defaultPoolId String
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    defaultTlsContainerRef String
    Reference to the default TLS container.
    description String
    Description of the listener.
    insertHeaders CloudLoadbalancerListenerCurrentStateInsertHeaders
    Headers to insert into requests:
    name String
    Name of the listener.
    operatingStatus String
    Operating status of the listener.
    protocol String
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    protocolPort Integer
    Port number the listener listens on. Changing this value recreates the resource.
    provisioningStatus String
    Provisioning status of the listener.
    region String
    Region.
    sniContainerRefs List<String>
    List of SNI container references.
    timeoutClientData Integer
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberConnect Integer
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberData Integer
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutTcpInspect Integer
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    tlsVersions List<String>
    List of TLS versions allowed.
    allowedCidrs string[]
    List of CIDRs allowed to access the listener.
    availabilityZone string
    Availability zone.
    connectionLimit number
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    defaultPoolId string
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    defaultTlsContainerRef string
    Reference to the default TLS container.
    description string
    Description of the listener.
    insertHeaders CloudLoadbalancerListenerCurrentStateInsertHeaders
    Headers to insert into requests:
    name string
    Name of the listener.
    operatingStatus string
    Operating status of the listener.
    protocol string
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    protocolPort number
    Port number the listener listens on. Changing this value recreates the resource.
    provisioningStatus string
    Provisioning status of the listener.
    region string
    Region.
    sniContainerRefs string[]
    List of SNI container references.
    timeoutClientData number
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberConnect number
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberData number
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutTcpInspect number
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    tlsVersions string[]
    List of TLS versions allowed.
    allowed_cidrs Sequence[str]
    List of CIDRs allowed to access the listener.
    availability_zone str
    Availability zone.
    connection_limit int
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    default_pool_id str
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    default_tls_container_ref str
    Reference to the default TLS container.
    description str
    Description of the listener.
    insert_headers CloudLoadbalancerListenerCurrentStateInsertHeaders
    Headers to insert into requests:
    name str
    Name of the listener.
    operating_status str
    Operating status of the listener.
    protocol str
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    protocol_port int
    Port number the listener listens on. Changing this value recreates the resource.
    provisioning_status str
    Provisioning status of the listener.
    region str
    Region.
    sni_container_refs Sequence[str]
    List of SNI container references.
    timeout_client_data int
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_member_connect int
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_member_data int
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeout_tcp_inspect int
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    tls_versions Sequence[str]
    List of TLS versions allowed.
    allowedCidrs List<String>
    List of CIDRs allowed to access the listener.
    availabilityZone String
    Availability zone.
    connectionLimit Number
    Maximum number of connections allowed. If omitted, the value assigned by the API is stored in the state.
    defaultPoolId String
    ID of the default pool for this listener (see ovh.CloudLoadbalancerPool). If omitted, the value assigned by the API is stored in the state.
    defaultTlsContainerRef String
    Reference to the default TLS container.
    description String
    Description of the listener.
    insertHeaders Property Map
    Headers to insert into requests:
    name String
    Name of the listener.
    operatingStatus String
    Operating status of the listener.
    protocol String
    Protocol of the listener (HTTP, HTTPS, SCTP, TCP, TERMINATED_HTTPS, UDP). Changing this value recreates the resource.
    protocolPort Number
    Port number the listener listens on. Changing this value recreates the resource.
    provisioningStatus String
    Provisioning status of the listener.
    region String
    Region.
    sniContainerRefs List<String>
    List of SNI container references.
    timeoutClientData Number
    Timeout for client data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberConnect Number
    Timeout for member connection in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutMemberData Number
    Timeout for member data in milliseconds. If omitted, the default assigned by the API is stored in the state.
    timeoutTcpInspect Number
    Timeout for TCP inspect in milliseconds. If omitted, the default assigned by the API is stored in the state.
    tlsVersions List<String>
    List of TLS versions allowed.

    CloudLoadbalancerListenerCurrentStateInsertHeaders, CloudLoadbalancerListenerCurrentStateInsertHeadersArgs

    XForwardedFor bool
    Insert X-Forwarded-For header.
    XForwardedPort bool
    Insert X-Forwarded-Port header.
    XForwardedProto bool
    Insert X-Forwarded-Proto header.
    XSslClientDn bool
    Insert X-SSL-Client-DN header.
    XSslClientHasCert bool
    Insert X-SSL-Client-Has-Cert header.
    XSslClientVerify bool
    Insert X-SSL-Client-Verify header.
    XForwardedFor bool
    Insert X-Forwarded-For header.
    XForwardedPort bool
    Insert X-Forwarded-Port header.
    XForwardedProto bool
    Insert X-Forwarded-Proto header.
    XSslClientDn bool
    Insert X-SSL-Client-DN header.
    XSslClientHasCert bool
    Insert X-SSL-Client-Has-Cert header.
    XSslClientVerify bool
    Insert X-SSL-Client-Verify header.
    x_forwarded_for bool
    Insert X-Forwarded-For header.
    x_forwarded_port bool
    Insert X-Forwarded-Port header.
    x_forwarded_proto bool
    Insert X-Forwarded-Proto header.
    x_ssl_client_dn bool
    Insert X-SSL-Client-DN header.
    x_ssl_client_has_cert bool
    Insert X-SSL-Client-Has-Cert header.
    x_ssl_client_verify bool
    Insert X-SSL-Client-Verify header.
    xForwardedFor Boolean
    Insert X-Forwarded-For header.
    xForwardedPort Boolean
    Insert X-Forwarded-Port header.
    xForwardedProto Boolean
    Insert X-Forwarded-Proto header.
    xSslClientDn Boolean
    Insert X-SSL-Client-DN header.
    xSslClientHasCert Boolean
    Insert X-SSL-Client-Has-Cert header.
    xSslClientVerify Boolean
    Insert X-SSL-Client-Verify header.
    xForwardedFor boolean
    Insert X-Forwarded-For header.
    xForwardedPort boolean
    Insert X-Forwarded-Port header.
    xForwardedProto boolean
    Insert X-Forwarded-Proto header.
    xSslClientDn boolean
    Insert X-SSL-Client-DN header.
    xSslClientHasCert boolean
    Insert X-SSL-Client-Has-Cert header.
    xSslClientVerify boolean
    Insert X-SSL-Client-Verify header.
    x_forwarded_for bool
    Insert X-Forwarded-For header.
    x_forwarded_port bool
    Insert X-Forwarded-Port header.
    x_forwarded_proto bool
    Insert X-Forwarded-Proto header.
    x_ssl_client_dn bool
    Insert X-SSL-Client-DN header.
    x_ssl_client_has_cert bool
    Insert X-SSL-Client-Has-Cert header.
    x_ssl_client_verify bool
    Insert X-SSL-Client-Verify header.
    xForwardedFor Boolean
    Insert X-Forwarded-For header.
    xForwardedPort Boolean
    Insert X-Forwarded-Port header.
    xForwardedProto Boolean
    Insert X-Forwarded-Proto header.
    xSslClientDn Boolean
    Insert X-SSL-Client-DN header.
    xSslClientHasCert Boolean
    Insert X-SSL-Client-Has-Cert header.
    xSslClientVerify Boolean
    Insert X-SSL-Client-Verify header.

    CloudLoadbalancerListenerInsertHeaders, CloudLoadbalancerListenerInsertHeadersArgs

    XForwardedFor bool
    Insert X-Forwarded-For header.
    XForwardedPort bool
    Insert X-Forwarded-Port header.
    XForwardedProto bool
    Insert X-Forwarded-Proto header.
    XSslClientDn bool
    Insert X-SSL-Client-DN header.
    XSslClientHasCert bool
    Insert X-SSL-Client-Has-Cert header.
    XSslClientVerify bool
    Insert X-SSL-Client-Verify header.
    XForwardedFor bool
    Insert X-Forwarded-For header.
    XForwardedPort bool
    Insert X-Forwarded-Port header.
    XForwardedProto bool
    Insert X-Forwarded-Proto header.
    XSslClientDn bool
    Insert X-SSL-Client-DN header.
    XSslClientHasCert bool
    Insert X-SSL-Client-Has-Cert header.
    XSslClientVerify bool
    Insert X-SSL-Client-Verify header.
    x_forwarded_for bool
    Insert X-Forwarded-For header.
    x_forwarded_port bool
    Insert X-Forwarded-Port header.
    x_forwarded_proto bool
    Insert X-Forwarded-Proto header.
    x_ssl_client_dn bool
    Insert X-SSL-Client-DN header.
    x_ssl_client_has_cert bool
    Insert X-SSL-Client-Has-Cert header.
    x_ssl_client_verify bool
    Insert X-SSL-Client-Verify header.
    xForwardedFor Boolean
    Insert X-Forwarded-For header.
    xForwardedPort Boolean
    Insert X-Forwarded-Port header.
    xForwardedProto Boolean
    Insert X-Forwarded-Proto header.
    xSslClientDn Boolean
    Insert X-SSL-Client-DN header.
    xSslClientHasCert Boolean
    Insert X-SSL-Client-Has-Cert header.
    xSslClientVerify Boolean
    Insert X-SSL-Client-Verify header.
    xForwardedFor boolean
    Insert X-Forwarded-For header.
    xForwardedPort boolean
    Insert X-Forwarded-Port header.
    xForwardedProto boolean
    Insert X-Forwarded-Proto header.
    xSslClientDn boolean
    Insert X-SSL-Client-DN header.
    xSslClientHasCert boolean
    Insert X-SSL-Client-Has-Cert header.
    xSslClientVerify boolean
    Insert X-SSL-Client-Verify header.
    x_forwarded_for bool
    Insert X-Forwarded-For header.
    x_forwarded_port bool
    Insert X-Forwarded-Port header.
    x_forwarded_proto bool
    Insert X-Forwarded-Proto header.
    x_ssl_client_dn bool
    Insert X-SSL-Client-DN header.
    x_ssl_client_has_cert bool
    Insert X-SSL-Client-Has-Cert header.
    x_ssl_client_verify bool
    Insert X-SSL-Client-Verify header.
    xForwardedFor Boolean
    Insert X-Forwarded-For header.
    xForwardedPort Boolean
    Insert X-Forwarded-Port header.
    xForwardedProto Boolean
    Insert X-Forwarded-Proto header.
    xSslClientDn Boolean
    Insert X-SSL-Client-DN header.
    xSslClientHasCert Boolean
    Insert X-SSL-Client-Has-Cert header.
    xSslClientVerify Boolean
    Insert X-SSL-Client-Verify header.

    Import

    A cloud load balancer listener can be imported using the service_name, loadbalancer_id, and listener_id, separated by /:

    terraform

    import {

    to = ovh_cloud_loadbalancer_listener.http

    id = “<service_name>/<loadbalancer_id>/<listener_id>”

    }

    bash

    $ pulumi import ovh:index/cloudLoadbalancerListener:CloudLoadbalancerListener http service_name/loadbalancer_id/listener_id
    

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

    Package Details

    Repository
    ovh ovh/pulumi-ovh
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the ovh Terraform Provider.
    ovh logo
    Viewing docs for OVHCloud v2.21.0
    published on Friday, Sep 25, 2026 by OVHcloud

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial