oci.LoadBalancer.Listener
This resource provides the Listener resource in Oracle Cloud Infrastructure Load Balancer service.
Adds a listener to a load balancer.
Example Usage
using System.Collections.Generic;
using Pulumi;
using Oci = Pulumi.Oci;
return await Deployment.RunAsync(() =>
{
var testListener = new Oci.LoadBalancer.Listener("testListener", new()
{
DefaultBackendSetName = oci_load_balancer_backend_set.Test_backend_set.Name,
LoadBalancerId = oci_load_balancer_load_balancer.Test_load_balancer.Id,
Port = @var.Listener_port,
Protocol = @var.Listener_protocol,
ConnectionConfiguration = new Oci.LoadBalancer.Inputs.ListenerConnectionConfigurationArgs
{
IdleTimeoutInSeconds = @var.Listener_connection_configuration_idle_timeout_in_seconds,
BackendTcpProxyProtocolVersion = @var.Listener_connection_configuration_backend_tcp_proxy_protocol_version,
},
HostnameNames = new[]
{
oci_load_balancer_hostname.Test_hostname.Name,
},
PathRouteSetName = oci_load_balancer_path_route_set.Test_path_route_set.Name,
RoutingPolicyName = oci_load_balancer_load_balancer_routing_policy.Test_load_balancer_routing_policy.Name,
RuleSetNames = new[]
{
oci_load_balancer_rule_set.Test_rule_set.Name,
},
SslConfiguration = new Oci.LoadBalancer.Inputs.ListenerSslConfigurationArgs
{
CertificateName = oci_load_balancer_certificate.Test_certificate.Name,
CertificateIds = @var.Listener_ssl_configuration_certificate_ids,
CipherSuiteName = @var.Listener_ssl_configuration_cipher_suite_name,
Protocols = @var.Listener_ssl_configuration_protocols,
ServerOrderPreference = @var.Listener_ssl_configuration_server_order_preference,
TrustedCertificateAuthorityIds = @var.Listener_ssl_configuration_trusted_certificate_authority_ids,
VerifyDepth = @var.Listener_ssl_configuration_verify_depth,
VerifyPeerCertificate = @var.Listener_ssl_configuration_verify_peer_certificate,
},
});
});
package main
import (
"github.com/pulumi/pulumi-oci/sdk/go/oci/LoadBalancer"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := LoadBalancer.NewListener(ctx, "testListener", &LoadBalancer.ListenerArgs{
DefaultBackendSetName: pulumi.Any(oci_load_balancer_backend_set.Test_backend_set.Name),
LoadBalancerId: pulumi.Any(oci_load_balancer_load_balancer.Test_load_balancer.Id),
Port: pulumi.Any(_var.Listener_port),
Protocol: pulumi.Any(_var.Listener_protocol),
ConnectionConfiguration: &loadbalancer.ListenerConnectionConfigurationArgs{
IdleTimeoutInSeconds: pulumi.Any(_var.Listener_connection_configuration_idle_timeout_in_seconds),
BackendTcpProxyProtocolVersion: pulumi.Any(_var.Listener_connection_configuration_backend_tcp_proxy_protocol_version),
},
HostnameNames: pulumi.StringArray{
oci_load_balancer_hostname.Test_hostname.Name,
},
PathRouteSetName: pulumi.Any(oci_load_balancer_path_route_set.Test_path_route_set.Name),
RoutingPolicyName: pulumi.Any(oci_load_balancer_load_balancer_routing_policy.Test_load_balancer_routing_policy.Name),
RuleSetNames: pulumi.StringArray{
oci_load_balancer_rule_set.Test_rule_set.Name,
},
SslConfiguration: &loadbalancer.ListenerSslConfigurationArgs{
CertificateName: pulumi.Any(oci_load_balancer_certificate.Test_certificate.Name),
CertificateIds: pulumi.Any(_var.Listener_ssl_configuration_certificate_ids),
CipherSuiteName: pulumi.Any(_var.Listener_ssl_configuration_cipher_suite_name),
Protocols: pulumi.Any(_var.Listener_ssl_configuration_protocols),
ServerOrderPreference: pulumi.Any(_var.Listener_ssl_configuration_server_order_preference),
TrustedCertificateAuthorityIds: pulumi.Any(_var.Listener_ssl_configuration_trusted_certificate_authority_ids),
VerifyDepth: pulumi.Any(_var.Listener_ssl_configuration_verify_depth),
VerifyPeerCertificate: pulumi.Any(_var.Listener_ssl_configuration_verify_peer_certificate),
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.LoadBalancer.Listener;
import com.pulumi.oci.LoadBalancer.ListenerArgs;
import com.pulumi.oci.LoadBalancer.inputs.ListenerConnectionConfigurationArgs;
import com.pulumi.oci.LoadBalancer.inputs.ListenerSslConfigurationArgs;
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 testListener = new Listener("testListener", ListenerArgs.builder()
.defaultBackendSetName(oci_load_balancer_backend_set.test_backend_set().name())
.loadBalancerId(oci_load_balancer_load_balancer.test_load_balancer().id())
.port(var_.listener_port())
.protocol(var_.listener_protocol())
.connectionConfiguration(ListenerConnectionConfigurationArgs.builder()
.idleTimeoutInSeconds(var_.listener_connection_configuration_idle_timeout_in_seconds())
.backendTcpProxyProtocolVersion(var_.listener_connection_configuration_backend_tcp_proxy_protocol_version())
.build())
.hostnameNames(oci_load_balancer_hostname.test_hostname().name())
.pathRouteSetName(oci_load_balancer_path_route_set.test_path_route_set().name())
.routingPolicyName(oci_load_balancer_load_balancer_routing_policy.test_load_balancer_routing_policy().name())
.ruleSetNames(oci_load_balancer_rule_set.test_rule_set().name())
.sslConfiguration(ListenerSslConfigurationArgs.builder()
.certificateName(oci_load_balancer_certificate.test_certificate().name())
.certificateIds(var_.listener_ssl_configuration_certificate_ids())
.cipherSuiteName(var_.listener_ssl_configuration_cipher_suite_name())
.protocols(var_.listener_ssl_configuration_protocols())
.serverOrderPreference(var_.listener_ssl_configuration_server_order_preference())
.trustedCertificateAuthorityIds(var_.listener_ssl_configuration_trusted_certificate_authority_ids())
.verifyDepth(var_.listener_ssl_configuration_verify_depth())
.verifyPeerCertificate(var_.listener_ssl_configuration_verify_peer_certificate())
.build())
.build());
}
}
import pulumi
import pulumi_oci as oci
test_listener = oci.load_balancer.Listener("testListener",
default_backend_set_name=oci_load_balancer_backend_set["test_backend_set"]["name"],
load_balancer_id=oci_load_balancer_load_balancer["test_load_balancer"]["id"],
port=var["listener_port"],
protocol=var["listener_protocol"],
connection_configuration=oci.load_balancer.ListenerConnectionConfigurationArgs(
idle_timeout_in_seconds=var["listener_connection_configuration_idle_timeout_in_seconds"],
backend_tcp_proxy_protocol_version=var["listener_connection_configuration_backend_tcp_proxy_protocol_version"],
),
hostname_names=[oci_load_balancer_hostname["test_hostname"]["name"]],
path_route_set_name=oci_load_balancer_path_route_set["test_path_route_set"]["name"],
routing_policy_name=oci_load_balancer_load_balancer_routing_policy["test_load_balancer_routing_policy"]["name"],
rule_set_names=[oci_load_balancer_rule_set["test_rule_set"]["name"]],
ssl_configuration=oci.load_balancer.ListenerSslConfigurationArgs(
certificate_name=oci_load_balancer_certificate["test_certificate"]["name"],
certificate_ids=var["listener_ssl_configuration_certificate_ids"],
cipher_suite_name=var["listener_ssl_configuration_cipher_suite_name"],
protocols=var["listener_ssl_configuration_protocols"],
server_order_preference=var["listener_ssl_configuration_server_order_preference"],
trusted_certificate_authority_ids=var["listener_ssl_configuration_trusted_certificate_authority_ids"],
verify_depth=var["listener_ssl_configuration_verify_depth"],
verify_peer_certificate=var["listener_ssl_configuration_verify_peer_certificate"],
))
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testListener = new oci.loadbalancer.Listener("testListener", {
defaultBackendSetName: oci_load_balancer_backend_set.test_backend_set.name,
loadBalancerId: oci_load_balancer_load_balancer.test_load_balancer.id,
port: _var.listener_port,
protocol: _var.listener_protocol,
connectionConfiguration: {
idleTimeoutInSeconds: _var.listener_connection_configuration_idle_timeout_in_seconds,
backendTcpProxyProtocolVersion: _var.listener_connection_configuration_backend_tcp_proxy_protocol_version,
},
hostnameNames: [oci_load_balancer_hostname.test_hostname.name],
pathRouteSetName: oci_load_balancer_path_route_set.test_path_route_set.name,
routingPolicyName: oci_load_balancer_load_balancer_routing_policy.test_load_balancer_routing_policy.name,
ruleSetNames: [oci_load_balancer_rule_set.test_rule_set.name],
sslConfiguration: {
certificateName: oci_load_balancer_certificate.test_certificate.name,
certificateIds: _var.listener_ssl_configuration_certificate_ids,
cipherSuiteName: _var.listener_ssl_configuration_cipher_suite_name,
protocols: _var.listener_ssl_configuration_protocols,
serverOrderPreference: _var.listener_ssl_configuration_server_order_preference,
trustedCertificateAuthorityIds: _var.listener_ssl_configuration_trusted_certificate_authority_ids,
verifyDepth: _var.listener_ssl_configuration_verify_depth,
verifyPeerCertificate: _var.listener_ssl_configuration_verify_peer_certificate,
},
});
resources:
testListener:
type: oci:LoadBalancer:Listener
properties:
#Required
defaultBackendSetName: ${oci_load_balancer_backend_set.test_backend_set.name}
loadBalancerId: ${oci_load_balancer_load_balancer.test_load_balancer.id}
port: ${var.listener_port}
protocol: ${var.listener_protocol}
connectionConfiguration:
idleTimeoutInSeconds: ${var.listener_connection_configuration_idle_timeout_in_seconds}
backendTcpProxyProtocolVersion: ${var.listener_connection_configuration_backend_tcp_proxy_protocol_version}
hostnameNames:
- ${oci_load_balancer_hostname.test_hostname.name}
pathRouteSetName: ${oci_load_balancer_path_route_set.test_path_route_set.name}
routingPolicyName: ${oci_load_balancer_load_balancer_routing_policy.test_load_balancer_routing_policy.name}
ruleSetNames:
- ${oci_load_balancer_rule_set.test_rule_set.name}
sslConfiguration:
certificateName: ${oci_load_balancer_certificate.test_certificate.name}
certificateIds: ${var.listener_ssl_configuration_certificate_ids}
cipherSuiteName: ${var.listener_ssl_configuration_cipher_suite_name}
protocols: ${var.listener_ssl_configuration_protocols}
serverOrderPreference: ${var.listener_ssl_configuration_server_order_preference}
trustedCertificateAuthorityIds: ${var.listener_ssl_configuration_trusted_certificate_authority_ids}
verifyDepth: ${var.listener_ssl_configuration_verify_depth}
verifyPeerCertificate: ${var.listener_ssl_configuration_verify_peer_certificate}
Create Listener Resource
new Listener(name: string, args: ListenerArgs, opts?: CustomResourceOptions);
@overload
def Listener(resource_name: str,
opts: Optional[ResourceOptions] = None,
connection_configuration: Optional[_loadbalancer.ListenerConnectionConfigurationArgs] = None,
default_backend_set_name: Optional[str] = None,
hostname_names: Optional[Sequence[str]] = None,
load_balancer_id: Optional[str] = None,
name: Optional[str] = None,
path_route_set_name: Optional[str] = None,
port: Optional[int] = None,
protocol: Optional[str] = None,
routing_policy_name: Optional[str] = None,
rule_set_names: Optional[Sequence[str]] = None,
ssl_configuration: Optional[_loadbalancer.ListenerSslConfigurationArgs] = None)
@overload
def Listener(resource_name: str,
args: ListenerArgs,
opts: Optional[ResourceOptions] = None)
func NewListener(ctx *Context, name string, args ListenerArgs, opts ...ResourceOption) (*Listener, error)
public Listener(string name, ListenerArgs args, CustomResourceOptions? opts = null)
public Listener(String name, ListenerArgs args)
public Listener(String name, ListenerArgs args, CustomResourceOptions options)
type: oci:LoadBalancer:Listener
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ListenerArgs
- 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 ListenerArgs
- 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 ListenerArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ListenerArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ListenerArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Listener Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The Listener resource accepts the following input properties:
- Default
Backend stringSet Name (Updatable) The name of the associated backend set. Example:
example_backend_set
- Load
Balancer stringId The OCID of the load balancer on which to add a listener.
- Port int
(Updatable) The communication port for the listener. Example:
80
- Protocol string
(Updatable) The protocol on which the listener accepts connection requests. To get a list of valid protocols, use the ListProtocols operation. Example:
HTTP
- Connection
Configuration ListenerConnection Configuration Args (Updatable) Configuration details for the connection between the client and backend servers.
- Hostname
Names List<string> (Updatable) An array of hostname resource names.
- Name string
A friendly name for the listener. It must be unique and it cannot be changed. Avoid entering confidential information. Example:
example_listener
- Path
Route stringSet Name (Updatable) Deprecated. Please use
routingPolicies
instead.- Routing
Policy stringName (Updatable) The name of the routing policy applied to this listener's traffic. Example:
example_routing_policy
- Rule
Set List<string>Names (Updatable) The names of the rule sets to apply to the listener. Example: ["example_rule_set"]
- Ssl
Configuration ListenerSsl Configuration Args (Updatable) The load balancer's SSL handling configuration details.
- Default
Backend stringSet Name (Updatable) The name of the associated backend set. Example:
example_backend_set
- Load
Balancer stringId The OCID of the load balancer on which to add a listener.
- Port int
(Updatable) The communication port for the listener. Example:
80
- Protocol string
(Updatable) The protocol on which the listener accepts connection requests. To get a list of valid protocols, use the ListProtocols operation. Example:
HTTP
- Connection
Configuration ListenerConnection Configuration Args (Updatable) Configuration details for the connection between the client and backend servers.
- Hostname
Names []string (Updatable) An array of hostname resource names.
- Name string
A friendly name for the listener. It must be unique and it cannot be changed. Avoid entering confidential information. Example:
example_listener
- Path
Route stringSet Name (Updatable) Deprecated. Please use
routingPolicies
instead.- Routing
Policy stringName (Updatable) The name of the routing policy applied to this listener's traffic. Example:
example_routing_policy
- Rule
Set []stringNames (Updatable) The names of the rule sets to apply to the listener. Example: ["example_rule_set"]
- Ssl
Configuration ListenerSsl Configuration Args (Updatable) The load balancer's SSL handling configuration details.
- default
Backend StringSet Name (Updatable) The name of the associated backend set. Example:
example_backend_set
- load
Balancer StringId The OCID of the load balancer on which to add a listener.
- port Integer
(Updatable) The communication port for the listener. Example:
80
- protocol String
(Updatable) The protocol on which the listener accepts connection requests. To get a list of valid protocols, use the ListProtocols operation. Example:
HTTP
- connection
Configuration ListenerConnection Configuration Args (Updatable) Configuration details for the connection between the client and backend servers.
- hostname
Names List<String> (Updatable) An array of hostname resource names.
- name String
A friendly name for the listener. It must be unique and it cannot be changed. Avoid entering confidential information. Example:
example_listener
- path
Route StringSet Name (Updatable) Deprecated. Please use
routingPolicies
instead.- routing
Policy StringName (Updatable) The name of the routing policy applied to this listener's traffic. Example:
example_routing_policy
- rule
Set List<String>Names (Updatable) The names of the rule sets to apply to the listener. Example: ["example_rule_set"]
- ssl
Configuration ListenerSsl Configuration Args (Updatable) The load balancer's SSL handling configuration details.
- default
Backend stringSet Name (Updatable) The name of the associated backend set. Example:
example_backend_set
- load
Balancer stringId The OCID of the load balancer on which to add a listener.
- port number
(Updatable) The communication port for the listener. Example:
80
- protocol string
(Updatable) The protocol on which the listener accepts connection requests. To get a list of valid protocols, use the ListProtocols operation. Example:
HTTP
- connection
Configuration ListenerConnection Configuration Args (Updatable) Configuration details for the connection between the client and backend servers.
- hostname
Names string[] (Updatable) An array of hostname resource names.
- name string
A friendly name for the listener. It must be unique and it cannot be changed. Avoid entering confidential information. Example:
example_listener
- path
Route stringSet Name (Updatable) Deprecated. Please use
routingPolicies
instead.- routing
Policy stringName (Updatable) The name of the routing policy applied to this listener's traffic. Example:
example_routing_policy
- rule
Set string[]Names (Updatable) The names of the rule sets to apply to the listener. Example: ["example_rule_set"]
- ssl
Configuration ListenerSsl Configuration Args (Updatable) The load balancer's SSL handling configuration details.
- default_
backend_ strset_ name (Updatable) The name of the associated backend set. Example:
example_backend_set
- load_
balancer_ strid The OCID of the load balancer on which to add a listener.
- port int
(Updatable) The communication port for the listener. Example:
80
- protocol str
(Updatable) The protocol on which the listener accepts connection requests. To get a list of valid protocols, use the ListProtocols operation. Example:
HTTP
- connection_
configuration ListenerConnection Configuration Args (Updatable) Configuration details for the connection between the client and backend servers.
- hostname_
names Sequence[str] (Updatable) An array of hostname resource names.
- name str
A friendly name for the listener. It must be unique and it cannot be changed. Avoid entering confidential information. Example:
example_listener
- path_
route_ strset_ name (Updatable) Deprecated. Please use
routingPolicies
instead.- routing_
policy_ strname (Updatable) The name of the routing policy applied to this listener's traffic. Example:
example_routing_policy
- rule_
set_ Sequence[str]names (Updatable) The names of the rule sets to apply to the listener. Example: ["example_rule_set"]
- ssl_
configuration ListenerSsl Configuration Args (Updatable) The load balancer's SSL handling configuration details.
- default
Backend StringSet Name (Updatable) The name of the associated backend set. Example:
example_backend_set
- load
Balancer StringId The OCID of the load balancer on which to add a listener.
- port Number
(Updatable) The communication port for the listener. Example:
80
- protocol String
(Updatable) The protocol on which the listener accepts connection requests. To get a list of valid protocols, use the ListProtocols operation. Example:
HTTP
- connection
Configuration Property Map (Updatable) Configuration details for the connection between the client and backend servers.
- hostname
Names List<String> (Updatable) An array of hostname resource names.
- name String
A friendly name for the listener. It must be unique and it cannot be changed. Avoid entering confidential information. Example:
example_listener
- path
Route StringSet Name (Updatable) Deprecated. Please use
routingPolicies
instead.- routing
Policy StringName (Updatable) The name of the routing policy applied to this listener's traffic. Example:
example_routing_policy
- rule
Set List<String>Names (Updatable) The names of the rule sets to apply to the listener. Example: ["example_rule_set"]
- ssl
Configuration Property Map (Updatable) The load balancer's SSL handling configuration details.
Outputs
All input properties are implicitly available as output properties. Additionally, the Listener resource produces the following output properties:
Look up Existing Listener Resource
Get an existing Listener 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?: ListenerState, opts?: CustomResourceOptions): Listener
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
connection_configuration: Optional[_loadbalancer.ListenerConnectionConfigurationArgs] = None,
default_backend_set_name: Optional[str] = None,
hostname_names: Optional[Sequence[str]] = None,
load_balancer_id: Optional[str] = None,
name: Optional[str] = None,
path_route_set_name: Optional[str] = None,
port: Optional[int] = None,
protocol: Optional[str] = None,
routing_policy_name: Optional[str] = None,
rule_set_names: Optional[Sequence[str]] = None,
ssl_configuration: Optional[_loadbalancer.ListenerSslConfigurationArgs] = None,
state: Optional[str] = None) -> Listener
func GetListener(ctx *Context, name string, id IDInput, state *ListenerState, opts ...ResourceOption) (*Listener, error)
public static Listener Get(string name, Input<string> id, ListenerState? state, CustomResourceOptions? opts = null)
public static Listener get(String name, Output<String> id, ListenerState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Connection
Configuration ListenerConnection Configuration Args (Updatable) Configuration details for the connection between the client and backend servers.
- Default
Backend stringSet Name (Updatable) The name of the associated backend set. Example:
example_backend_set
- Hostname
Names List<string> (Updatable) An array of hostname resource names.
- Load
Balancer stringId The OCID of the load balancer on which to add a listener.
- Name string
A friendly name for the listener. It must be unique and it cannot be changed. Avoid entering confidential information. Example:
example_listener
- Path
Route stringSet Name (Updatable) Deprecated. Please use
routingPolicies
instead.- Port int
(Updatable) The communication port for the listener. Example:
80
- Protocol string
(Updatable) The protocol on which the listener accepts connection requests. To get a list of valid protocols, use the ListProtocols operation. Example:
HTTP
- Routing
Policy stringName (Updatable) The name of the routing policy applied to this listener's traffic. Example:
example_routing_policy
- Rule
Set List<string>Names (Updatable) The names of the rule sets to apply to the listener. Example: ["example_rule_set"]
- Ssl
Configuration ListenerSsl Configuration Args (Updatable) The load balancer's SSL handling configuration details.
- State string
- Connection
Configuration ListenerConnection Configuration Args (Updatable) Configuration details for the connection between the client and backend servers.
- Default
Backend stringSet Name (Updatable) The name of the associated backend set. Example:
example_backend_set
- Hostname
Names []string (Updatable) An array of hostname resource names.
- Load
Balancer stringId The OCID of the load balancer on which to add a listener.
- Name string
A friendly name for the listener. It must be unique and it cannot be changed. Avoid entering confidential information. Example:
example_listener
- Path
Route stringSet Name (Updatable) Deprecated. Please use
routingPolicies
instead.- Port int
(Updatable) The communication port for the listener. Example:
80
- Protocol string
(Updatable) The protocol on which the listener accepts connection requests. To get a list of valid protocols, use the ListProtocols operation. Example:
HTTP
- Routing
Policy stringName (Updatable) The name of the routing policy applied to this listener's traffic. Example:
example_routing_policy
- Rule
Set []stringNames (Updatable) The names of the rule sets to apply to the listener. Example: ["example_rule_set"]
- Ssl
Configuration ListenerSsl Configuration Args (Updatable) The load balancer's SSL handling configuration details.
- State string
- connection
Configuration ListenerConnection Configuration Args (Updatable) Configuration details for the connection between the client and backend servers.
- default
Backend StringSet Name (Updatable) The name of the associated backend set. Example:
example_backend_set
- hostname
Names List<String> (Updatable) An array of hostname resource names.
- load
Balancer StringId The OCID of the load balancer on which to add a listener.
- name String
A friendly name for the listener. It must be unique and it cannot be changed. Avoid entering confidential information. Example:
example_listener
- path
Route StringSet Name (Updatable) Deprecated. Please use
routingPolicies
instead.- port Integer
(Updatable) The communication port for the listener. Example:
80
- protocol String
(Updatable) The protocol on which the listener accepts connection requests. To get a list of valid protocols, use the ListProtocols operation. Example:
HTTP
- routing
Policy StringName (Updatable) The name of the routing policy applied to this listener's traffic. Example:
example_routing_policy
- rule
Set List<String>Names (Updatable) The names of the rule sets to apply to the listener. Example: ["example_rule_set"]
- ssl
Configuration ListenerSsl Configuration Args (Updatable) The load balancer's SSL handling configuration details.
- state String
- connection
Configuration ListenerConnection Configuration Args (Updatable) Configuration details for the connection between the client and backend servers.
- default
Backend stringSet Name (Updatable) The name of the associated backend set. Example:
example_backend_set
- hostname
Names string[] (Updatable) An array of hostname resource names.
- load
Balancer stringId The OCID of the load balancer on which to add a listener.
- name string
A friendly name for the listener. It must be unique and it cannot be changed. Avoid entering confidential information. Example:
example_listener
- path
Route stringSet Name (Updatable) Deprecated. Please use
routingPolicies
instead.- port number
(Updatable) The communication port for the listener. Example:
80
- protocol string
(Updatable) The protocol on which the listener accepts connection requests. To get a list of valid protocols, use the ListProtocols operation. Example:
HTTP
- routing
Policy stringName (Updatable) The name of the routing policy applied to this listener's traffic. Example:
example_routing_policy
- rule
Set string[]Names (Updatable) The names of the rule sets to apply to the listener. Example: ["example_rule_set"]
- ssl
Configuration ListenerSsl Configuration Args (Updatable) The load balancer's SSL handling configuration details.
- state string
- connection_
configuration ListenerConnection Configuration Args (Updatable) Configuration details for the connection between the client and backend servers.
- default_
backend_ strset_ name (Updatable) The name of the associated backend set. Example:
example_backend_set
- hostname_
names Sequence[str] (Updatable) An array of hostname resource names.
- load_
balancer_ strid The OCID of the load balancer on which to add a listener.
- name str
A friendly name for the listener. It must be unique and it cannot be changed. Avoid entering confidential information. Example:
example_listener
- path_
route_ strset_ name (Updatable) Deprecated. Please use
routingPolicies
instead.- port int
(Updatable) The communication port for the listener. Example:
80
- protocol str
(Updatable) The protocol on which the listener accepts connection requests. To get a list of valid protocols, use the ListProtocols operation. Example:
HTTP
- routing_
policy_ strname (Updatable) The name of the routing policy applied to this listener's traffic. Example:
example_routing_policy
- rule_
set_ Sequence[str]names (Updatable) The names of the rule sets to apply to the listener. Example: ["example_rule_set"]
- ssl_
configuration ListenerSsl Configuration Args (Updatable) The load balancer's SSL handling configuration details.
- state str
- connection
Configuration Property Map (Updatable) Configuration details for the connection between the client and backend servers.
- default
Backend StringSet Name (Updatable) The name of the associated backend set. Example:
example_backend_set
- hostname
Names List<String> (Updatable) An array of hostname resource names.
- load
Balancer StringId The OCID of the load balancer on which to add a listener.
- name String
A friendly name for the listener. It must be unique and it cannot be changed. Avoid entering confidential information. Example:
example_listener
- path
Route StringSet Name (Updatable) Deprecated. Please use
routingPolicies
instead.- port Number
(Updatable) The communication port for the listener. Example:
80
- protocol String
(Updatable) The protocol on which the listener accepts connection requests. To get a list of valid protocols, use the ListProtocols operation. Example:
HTTP
- routing
Policy StringName (Updatable) The name of the routing policy applied to this listener's traffic. Example:
example_routing_policy
- rule
Set List<String>Names (Updatable) The names of the rule sets to apply to the listener. Example: ["example_rule_set"]
- ssl
Configuration Property Map (Updatable) The load balancer's SSL handling configuration details.
- state String
Supporting Types
ListenerConnectionConfiguration
- Idle
Timeout stringIn Seconds (Updatable) The maximum idle time, in seconds, allowed between two successive receive or two successive send operations between the client and backend servers. A send operation does not reset the timer for receive operations. A receive operation does not reset the timer for send operations.
- Backend
Tcp intProxy Protocol Version (Updatable) The backend TCP Proxy Protocol version. Example:
1
- Idle
Timeout stringIn Seconds (Updatable) The maximum idle time, in seconds, allowed between two successive receive or two successive send operations between the client and backend servers. A send operation does not reset the timer for receive operations. A receive operation does not reset the timer for send operations.
- Backend
Tcp intProxy Protocol Version (Updatable) The backend TCP Proxy Protocol version. Example:
1
- idle
Timeout StringIn Seconds (Updatable) The maximum idle time, in seconds, allowed between two successive receive or two successive send operations between the client and backend servers. A send operation does not reset the timer for receive operations. A receive operation does not reset the timer for send operations.
- backend
Tcp IntegerProxy Protocol Version (Updatable) The backend TCP Proxy Protocol version. Example:
1
- idle
Timeout stringIn Seconds (Updatable) The maximum idle time, in seconds, allowed between two successive receive or two successive send operations between the client and backend servers. A send operation does not reset the timer for receive operations. A receive operation does not reset the timer for send operations.
- backend
Tcp numberProxy Protocol Version (Updatable) The backend TCP Proxy Protocol version. Example:
1
- idle_
timeout_ strin_ seconds (Updatable) The maximum idle time, in seconds, allowed between two successive receive or two successive send operations between the client and backend servers. A send operation does not reset the timer for receive operations. A receive operation does not reset the timer for send operations.
- backend_
tcp_ intproxy_ protocol_ version (Updatable) The backend TCP Proxy Protocol version. Example:
1
- idle
Timeout StringIn Seconds (Updatable) The maximum idle time, in seconds, allowed between two successive receive or two successive send operations between the client and backend servers. A send operation does not reset the timer for receive operations. A receive operation does not reset the timer for send operations.
- backend
Tcp NumberProxy Protocol Version (Updatable) The backend TCP Proxy Protocol version. Example:
1
ListenerSslConfiguration
- Certificate
Ids List<string> (Updatable) Ids for Oracle Cloud Infrastructure certificates service certificates. Currently only a single Id may be passed. Example:
[ocid1.certificate.oc1.us-ashburn-1.amaaaaaaav3bgsaa5o2q7rh5nfmkkukfkogasqhk6af2opufhjlqg7m6jqzq]
- Certificate
Name string (Updatable) A friendly name for the certificate bundle. It must be unique and it cannot be changed. Valid certificate bundle names include only alphanumeric characters, dashes, and underscores. Certificate bundle names cannot contain spaces. Avoid entering confidential information. Example:
example_certificate_bundle
- Cipher
Suite stringName (Updatable) The name of the cipher suite to use for HTTPS or SSL connections.
- Protocols List<string>
(Updatable) A list of SSL protocols the load balancer must support for HTTPS or SSL connections.
- Server
Order stringPreference (Updatable) When this attribute is set to ENABLED, the system gives preference to the server ciphers over the client ciphers.
- List<string>
(Updatable) Ids for Oracle Cloud Infrastructure certificates service CA or CA bundles for the load balancer to trust. Example:
[ocid1.cabundle.oc1.us-ashburn-1.amaaaaaaav3bgsaagl4zzyqdop5i2vuwoqewdvauuw34llqa74otq2jdsfyq]
- Verify
Depth int (Updatable) The maximum depth for peer certificate chain verification. Example:
3
- Verify
Peer boolCertificate (Updatable) Whether the load balancer listener should verify peer certificates. Example:
true
- Certificate
Ids []string (Updatable) Ids for Oracle Cloud Infrastructure certificates service certificates. Currently only a single Id may be passed. Example:
[ocid1.certificate.oc1.us-ashburn-1.amaaaaaaav3bgsaa5o2q7rh5nfmkkukfkogasqhk6af2opufhjlqg7m6jqzq]
- Certificate
Name string (Updatable) A friendly name for the certificate bundle. It must be unique and it cannot be changed. Valid certificate bundle names include only alphanumeric characters, dashes, and underscores. Certificate bundle names cannot contain spaces. Avoid entering confidential information. Example:
example_certificate_bundle
- Cipher
Suite stringName (Updatable) The name of the cipher suite to use for HTTPS or SSL connections.
- Protocols []string
(Updatable) A list of SSL protocols the load balancer must support for HTTPS or SSL connections.
- Server
Order stringPreference (Updatable) When this attribute is set to ENABLED, the system gives preference to the server ciphers over the client ciphers.
- []string
(Updatable) Ids for Oracle Cloud Infrastructure certificates service CA or CA bundles for the load balancer to trust. Example:
[ocid1.cabundle.oc1.us-ashburn-1.amaaaaaaav3bgsaagl4zzyqdop5i2vuwoqewdvauuw34llqa74otq2jdsfyq]
- Verify
Depth int (Updatable) The maximum depth for peer certificate chain verification. Example:
3
- Verify
Peer boolCertificate (Updatable) Whether the load balancer listener should verify peer certificates. Example:
true
- certificate
Ids List<String> (Updatable) Ids for Oracle Cloud Infrastructure certificates service certificates. Currently only a single Id may be passed. Example:
[ocid1.certificate.oc1.us-ashburn-1.amaaaaaaav3bgsaa5o2q7rh5nfmkkukfkogasqhk6af2opufhjlqg7m6jqzq]
- certificate
Name String (Updatable) A friendly name for the certificate bundle. It must be unique and it cannot be changed. Valid certificate bundle names include only alphanumeric characters, dashes, and underscores. Certificate bundle names cannot contain spaces. Avoid entering confidential information. Example:
example_certificate_bundle
- cipher
Suite StringName (Updatable) The name of the cipher suite to use for HTTPS or SSL connections.
- protocols List<String>
(Updatable) A list of SSL protocols the load balancer must support for HTTPS or SSL connections.
- server
Order StringPreference (Updatable) When this attribute is set to ENABLED, the system gives preference to the server ciphers over the client ciphers.
- List<String>
(Updatable) Ids for Oracle Cloud Infrastructure certificates service CA or CA bundles for the load balancer to trust. Example:
[ocid1.cabundle.oc1.us-ashburn-1.amaaaaaaav3bgsaagl4zzyqdop5i2vuwoqewdvauuw34llqa74otq2jdsfyq]
- verify
Depth Integer (Updatable) The maximum depth for peer certificate chain verification. Example:
3
- verify
Peer BooleanCertificate (Updatable) Whether the load balancer listener should verify peer certificates. Example:
true
- certificate
Ids string[] (Updatable) Ids for Oracle Cloud Infrastructure certificates service certificates. Currently only a single Id may be passed. Example:
[ocid1.certificate.oc1.us-ashburn-1.amaaaaaaav3bgsaa5o2q7rh5nfmkkukfkogasqhk6af2opufhjlqg7m6jqzq]
- certificate
Name string (Updatable) A friendly name for the certificate bundle. It must be unique and it cannot be changed. Valid certificate bundle names include only alphanumeric characters, dashes, and underscores. Certificate bundle names cannot contain spaces. Avoid entering confidential information. Example:
example_certificate_bundle
- cipher
Suite stringName (Updatable) The name of the cipher suite to use for HTTPS or SSL connections.
- protocols string[]
(Updatable) A list of SSL protocols the load balancer must support for HTTPS or SSL connections.
- server
Order stringPreference (Updatable) When this attribute is set to ENABLED, the system gives preference to the server ciphers over the client ciphers.
- string[]
(Updatable) Ids for Oracle Cloud Infrastructure certificates service CA or CA bundles for the load balancer to trust. Example:
[ocid1.cabundle.oc1.us-ashburn-1.amaaaaaaav3bgsaagl4zzyqdop5i2vuwoqewdvauuw34llqa74otq2jdsfyq]
- verify
Depth number (Updatable) The maximum depth for peer certificate chain verification. Example:
3
- verify
Peer booleanCertificate (Updatable) Whether the load balancer listener should verify peer certificates. Example:
true
- certificate_
ids Sequence[str] (Updatable) Ids for Oracle Cloud Infrastructure certificates service certificates. Currently only a single Id may be passed. Example:
[ocid1.certificate.oc1.us-ashburn-1.amaaaaaaav3bgsaa5o2q7rh5nfmkkukfkogasqhk6af2opufhjlqg7m6jqzq]
- certificate_
name str (Updatable) A friendly name for the certificate bundle. It must be unique and it cannot be changed. Valid certificate bundle names include only alphanumeric characters, dashes, and underscores. Certificate bundle names cannot contain spaces. Avoid entering confidential information. Example:
example_certificate_bundle
- cipher_
suite_ strname (Updatable) The name of the cipher suite to use for HTTPS or SSL connections.
- protocols Sequence[str]
(Updatable) A list of SSL protocols the load balancer must support for HTTPS or SSL connections.
- server_
order_ strpreference (Updatable) When this attribute is set to ENABLED, the system gives preference to the server ciphers over the client ciphers.
- Sequence[str]
(Updatable) Ids for Oracle Cloud Infrastructure certificates service CA or CA bundles for the load balancer to trust. Example:
[ocid1.cabundle.oc1.us-ashburn-1.amaaaaaaav3bgsaagl4zzyqdop5i2vuwoqewdvauuw34llqa74otq2jdsfyq]
- verify_
depth int (Updatable) The maximum depth for peer certificate chain verification. Example:
3
- verify_
peer_ boolcertificate (Updatable) Whether the load balancer listener should verify peer certificates. Example:
true
- certificate
Ids List<String> (Updatable) Ids for Oracle Cloud Infrastructure certificates service certificates. Currently only a single Id may be passed. Example:
[ocid1.certificate.oc1.us-ashburn-1.amaaaaaaav3bgsaa5o2q7rh5nfmkkukfkogasqhk6af2opufhjlqg7m6jqzq]
- certificate
Name String (Updatable) A friendly name for the certificate bundle. It must be unique and it cannot be changed. Valid certificate bundle names include only alphanumeric characters, dashes, and underscores. Certificate bundle names cannot contain spaces. Avoid entering confidential information. Example:
example_certificate_bundle
- cipher
Suite StringName (Updatable) The name of the cipher suite to use for HTTPS or SSL connections.
- protocols List<String>
(Updatable) A list of SSL protocols the load balancer must support for HTTPS or SSL connections.
- server
Order StringPreference (Updatable) When this attribute is set to ENABLED, the system gives preference to the server ciphers over the client ciphers.
- List<String>
(Updatable) Ids for Oracle Cloud Infrastructure certificates service CA or CA bundles for the load balancer to trust. Example:
[ocid1.cabundle.oc1.us-ashburn-1.amaaaaaaav3bgsaagl4zzyqdop5i2vuwoqewdvauuw34llqa74otq2jdsfyq]
- verify
Depth Number (Updatable) The maximum depth for peer certificate chain verification. Example:
3
- verify
Peer BooleanCertificate (Updatable) Whether the load balancer listener should verify peer certificates. Example:
true
Import
Listeners can be imported using the id
, e.g.
$ pulumi import oci:LoadBalancer/listener:Listener test_listener "loadBalancers/{loadBalancerId}/listeners/{listenerName}"
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
oci
Terraform Provider.