Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. LoadBalancer
  5. getListenerRules
Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
pulumi/pulumi-oci

oci.LoadBalancer.getListenerRules

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
pulumi/pulumi-oci

    This data source provides the list of Listener Rules in Oracle Cloud Infrastructure Load Balancer service.

    Lists all of the rules from all of the rule sets associated with the specified listener. The response organizes the rules in the following order:

    • Access control rules
    • Allow method rules
    • Request header rules
    • Response header rules

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";

const testListenerRules = oci.LoadBalancer.getListenerRules({
    listenerName: testListener.name,
    loadBalancerId: testLoadBalancer.id,
});

    import pulumi
import pulumi_oci as oci

test_listener_rules = oci.LoadBalancer.get_listener_rules(listener_name=test_listener["name"],
    load_balancer_id=test_load_balancer["id"])

    package main

import (
	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/loadbalancer"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := loadbalancer.GetListenerRules(ctx, &loadbalancer.GetListenerRulesArgs{
			ListenerName:   testListener.Name,
			LoadBalancerId: testLoadBalancer.Id,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testListenerRules = Oci.LoadBalancer.GetListenerRules.Invoke(new()
    {
        ListenerName = testListener.Name,
        LoadBalancerId = testLoadBalancer.Id,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.LoadBalancer.LoadBalancerFunctions;
import com.pulumi.oci.LoadBalancer.inputs.GetListenerRulesArgs;
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) {
        final var testListenerRules = LoadBalancerFunctions.getListenerRules(GetListenerRulesArgs.builder()
            .listenerName(testListener.name())
            .loadBalancerId(testLoadBalancer.id())
            .build());

    }
}

    variables:
  testListenerRules:
    fn::invoke:
      function: oci:LoadBalancer:getListenerRules
      arguments:
        listenerName: ${testListener.name}
        loadBalancerId: ${testLoadBalancer.id}

    Using getListenerRules

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getListenerRules(args: GetListenerRulesArgs, opts?: InvokeOptions): Promise<GetListenerRulesResult>
function getListenerRulesOutput(args: GetListenerRulesOutputArgs, opts?: InvokeOptions): Output<GetListenerRulesResult>
    def get_listener_rules(filters: Optional[Sequence[GetListenerRulesFilter]] = None,
                       listener_name: Optional[str] = None,
                       load_balancer_id: Optional[str] = None,
                       opts: Optional[InvokeOptions] = None) -> GetListenerRulesResult
def get_listener_rules_output(filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetListenerRulesFilterArgs]]]] = None,
                       listener_name: Optional[pulumi.Input[str]] = None,
                       load_balancer_id: Optional[pulumi.Input[str]] = None,
                       opts: Optional[InvokeOptions] = None) -> Output[GetListenerRulesResult]
    func GetListenerRules(ctx *Context, args *GetListenerRulesArgs, opts ...InvokeOption) (*GetListenerRulesResult, error)
func GetListenerRulesOutput(ctx *Context, args *GetListenerRulesOutputArgs, opts ...InvokeOption) GetListenerRulesResultOutput

    > Note: This function is named GetListenerRules in the Go SDK.

    public static class GetListenerRules 
{
    public static Task<GetListenerRulesResult> InvokeAsync(GetListenerRulesArgs args, InvokeOptions? opts = null)
    public static Output<GetListenerRulesResult> Invoke(GetListenerRulesInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetListenerRulesResult> getListenerRules(GetListenerRulesArgs args, InvokeOptions options)
public static Output<GetListenerRulesResult> getListenerRules(GetListenerRulesArgs args, InvokeOptions options)

    fn::invoke:
  function: oci:LoadBalancer/getListenerRules:getListenerRules
  arguments:
    # arguments dictionary

    The following arguments are supported:

    ListenerName string
    The name of the listener the rules are associated with. Example: example_listener
    LoadBalancerId string
    The OCID of the load balancer associated with the listener.
    Filters List<GetListenerRulesFilter>
    ListenerName string
    The name of the listener the rules are associated with. Example: example_listener
    LoadBalancerId string
    The OCID of the load balancer associated with the listener.
    Filters []GetListenerRulesFilter
    listenerName String
    The name of the listener the rules are associated with. Example: example_listener
    loadBalancerId String
    The OCID of the load balancer associated with the listener.
    filters List<GetListenerRulesFilter>
    listenerName string
    The name of the listener the rules are associated with. Example: example_listener
    loadBalancerId string
    The OCID of the load balancer associated with the listener.
    filters GetListenerRulesFilter[]
    listener_name str
    The name of the listener the rules are associated with. Example: example_listener
    load_balancer_id str
    The OCID of the load balancer associated with the listener.
    filters Sequence[GetListenerRulesFilter]
    listenerName String
    The name of the listener the rules are associated with. Example: example_listener
    loadBalancerId String
    The OCID of the load balancer associated with the listener.
    filters List<Property Map>

    getListenerRules Result

    The following output properties are available:

    Id string
    The provider-assigned unique ID for this managed resource.
    ListenerName string
    ListenerRules List<GetListenerRulesListenerRule>
    The list of listener_rules.
    LoadBalancerId string
    Filters List<GetListenerRulesFilter>
    Id string
    The provider-assigned unique ID for this managed resource.
    ListenerName string
    ListenerRules []GetListenerRulesListenerRule
    The list of listener_rules.
    LoadBalancerId string
    Filters []GetListenerRulesFilter
    id String
    The provider-assigned unique ID for this managed resource.
    listenerName String
    listenerRules List<GetListenerRulesListenerRule>
    The list of listener_rules.
    loadBalancerId String
    filters List<GetListenerRulesFilter>
    id string
    The provider-assigned unique ID for this managed resource.
    listenerName string
    listenerRules GetListenerRulesListenerRule[]
    The list of listener_rules.
    loadBalancerId string
    filters GetListenerRulesFilter[]
    id str
    The provider-assigned unique ID for this managed resource.
    listener_name str
    listener_rules Sequence[GetListenerRulesListenerRule]
    The list of listener_rules.
    load_balancer_id str
    filters Sequence[GetListenerRulesFilter]
    id String
    The provider-assigned unique ID for this managed resource.
    listenerName String
    listenerRules List<Property Map>
    The list of listener_rules.
    loadBalancerId String
    filters List<Property Map>

    Supporting Types

    GetListenerRulesFilter

    Name string
    The name of the rule set that the rule belongs to.
    Values List<string>
    Regex bool
    Name string
    The name of the rule set that the rule belongs to.
    Values []string
    Regex bool
    name String
    The name of the rule set that the rule belongs to.
    values List<String>
    regex Boolean
    name string
    The name of the rule set that the rule belongs to.
    values string[]
    regex boolean
    name str
    The name of the rule set that the rule belongs to.
    values Sequence[str]
    regex bool
    name String
    The name of the rule set that the rule belongs to.
    values List<String>
    regex Boolean

    GetListenerRulesListenerRule

    Name string
    The name of the rule set that the rule belongs to.
    Rules List<GetListenerRulesListenerRuleRule>
    A rule object that applies to the listener.
    State string
    Name string
    The name of the rule set that the rule belongs to.
    Rules []GetListenerRulesListenerRuleRule
    A rule object that applies to the listener.
    State string
    name String
    The name of the rule set that the rule belongs to.
    rules List<GetListenerRulesListenerRuleRule>
    A rule object that applies to the listener.
    state String
    name string
    The name of the rule set that the rule belongs to.
    rules GetListenerRulesListenerRuleRule[]
    A rule object that applies to the listener.
    state string
    name str
    The name of the rule set that the rule belongs to.
    rules Sequence[GetListenerRulesListenerRuleRule]
    A rule object that applies to the listener.
    state str
    name String
    The name of the rule set that the rule belongs to.
    rules List<Property Map>
    A rule object that applies to the listener.
    state String

    GetListenerRulesListenerRuleRule

    Action string
    The action can be one of these values: ADD_HTTP_REQUEST_HEADER, ADD_HTTP_RESPONSE_HEADER, ALLOW, CONTROL_ACCESS_USING_HTTP_METHODS, EXTEND_HTTP_REQUEST_HEADER_VALUE, EXTEND_HTTP_RESPONSE_HEADER_VALUE, HTTP_HEADER, IP_BASED_MAX_CONNECTIONS, REDIRECT, REMOVE_HTTP_REQUEST_HEADER, REMOVE_HTTP_RESPONSE_HEADER
    AllowedMethods List<string>
    The list of HTTP methods allowed for this listener.
    AreInvalidCharactersAllowed bool
    Indicates whether or not invalid characters in client header fields will be allowed. Valid names are composed of English letters, digits, hyphens and underscores. If "true", invalid characters are allowed in the HTTP header. If "false", invalid characters are not allowed in the HTTP header
    Conditions List<GetListenerRulesListenerRuleRuleCondition>
    DefaultMaxConnections int
    The maximum number of connections that the any IP can make to a listener unless the IP is mentioned in maxConnections. If no defaultMaxConnections is specified the default is unlimited.
    Description string
    A brief description of the access control rule. Avoid entering confidential information.
    Header string
    A header name that conforms to RFC 7230. Example: example_header_name
    HttpLargeHeaderSizeInKb int
    The maximum size of each buffer used for reading http client request header. This value indicates the maximum size allowed for each buffer. The allowed values for buffer size are 8, 16, 32 and 64.
    IpMaxConnections List<GetListenerRulesListenerRuleRuleIpMaxConnection>
    An array of IPs that have a maxConnection setting different than the default and what that maxConnection setting is
    Prefix string
    A string to prepend to the header value. The resulting header value must still conform to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    RedirectUris List<GetListenerRulesListenerRuleRuleRedirectUri>
    An object that defines the redirect URI applied to the original request. The object property values compose the redirect URI.
    ResponseCode int
    The HTTP status code to return when the incoming request is redirected.
    StatusCode int
    The HTTP status code to return when the requested HTTP method is not in the list of allowed methods. The associated status line returned with the code is mapped from the standard HTTP specification. The default value is 405 (Method Not Allowed). Example: 403
    Suffix string
    A string to append to the header value. The resulting header value must still conform to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    Value string
    A header value that conforms to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    Action string
    The action can be one of these values: ADD_HTTP_REQUEST_HEADER, ADD_HTTP_RESPONSE_HEADER, ALLOW, CONTROL_ACCESS_USING_HTTP_METHODS, EXTEND_HTTP_REQUEST_HEADER_VALUE, EXTEND_HTTP_RESPONSE_HEADER_VALUE, HTTP_HEADER, IP_BASED_MAX_CONNECTIONS, REDIRECT, REMOVE_HTTP_REQUEST_HEADER, REMOVE_HTTP_RESPONSE_HEADER
    AllowedMethods []string
    The list of HTTP methods allowed for this listener.
    AreInvalidCharactersAllowed bool
    Indicates whether or not invalid characters in client header fields will be allowed. Valid names are composed of English letters, digits, hyphens and underscores. If "true", invalid characters are allowed in the HTTP header. If "false", invalid characters are not allowed in the HTTP header
    Conditions []GetListenerRulesListenerRuleRuleCondition
    DefaultMaxConnections int
    The maximum number of connections that the any IP can make to a listener unless the IP is mentioned in maxConnections. If no defaultMaxConnections is specified the default is unlimited.
    Description string
    A brief description of the access control rule. Avoid entering confidential information.
    Header string
    A header name that conforms to RFC 7230. Example: example_header_name
    HttpLargeHeaderSizeInKb int
    The maximum size of each buffer used for reading http client request header. This value indicates the maximum size allowed for each buffer. The allowed values for buffer size are 8, 16, 32 and 64.
    IpMaxConnections []GetListenerRulesListenerRuleRuleIpMaxConnection
    An array of IPs that have a maxConnection setting different than the default and what that maxConnection setting is
    Prefix string
    A string to prepend to the header value. The resulting header value must still conform to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    RedirectUris []GetListenerRulesListenerRuleRuleRedirectUri
    An object that defines the redirect URI applied to the original request. The object property values compose the redirect URI.
    ResponseCode int
    The HTTP status code to return when the incoming request is redirected.
    StatusCode int
    The HTTP status code to return when the requested HTTP method is not in the list of allowed methods. The associated status line returned with the code is mapped from the standard HTTP specification. The default value is 405 (Method Not Allowed). Example: 403
    Suffix string
    A string to append to the header value. The resulting header value must still conform to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    Value string
    A header value that conforms to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    action String
    The action can be one of these values: ADD_HTTP_REQUEST_HEADER, ADD_HTTP_RESPONSE_HEADER, ALLOW, CONTROL_ACCESS_USING_HTTP_METHODS, EXTEND_HTTP_REQUEST_HEADER_VALUE, EXTEND_HTTP_RESPONSE_HEADER_VALUE, HTTP_HEADER, IP_BASED_MAX_CONNECTIONS, REDIRECT, REMOVE_HTTP_REQUEST_HEADER, REMOVE_HTTP_RESPONSE_HEADER
    allowedMethods List<String>
    The list of HTTP methods allowed for this listener.
    areInvalidCharactersAllowed Boolean
    Indicates whether or not invalid characters in client header fields will be allowed. Valid names are composed of English letters, digits, hyphens and underscores. If "true", invalid characters are allowed in the HTTP header. If "false", invalid characters are not allowed in the HTTP header
    conditions List<GetListenerRulesListenerRuleRuleCondition>
    defaultMaxConnections Integer
    The maximum number of connections that the any IP can make to a listener unless the IP is mentioned in maxConnections. If no defaultMaxConnections is specified the default is unlimited.
    description String
    A brief description of the access control rule. Avoid entering confidential information.
    header String
    A header name that conforms to RFC 7230. Example: example_header_name
    httpLargeHeaderSizeInKb Integer
    The maximum size of each buffer used for reading http client request header. This value indicates the maximum size allowed for each buffer. The allowed values for buffer size are 8, 16, 32 and 64.
    ipMaxConnections List<GetListenerRulesListenerRuleRuleIpMaxConnection>
    An array of IPs that have a maxConnection setting different than the default and what that maxConnection setting is
    prefix String
    A string to prepend to the header value. The resulting header value must still conform to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    redirectUris List<GetListenerRulesListenerRuleRuleRedirectUri>
    An object that defines the redirect URI applied to the original request. The object property values compose the redirect URI.
    responseCode Integer
    The HTTP status code to return when the incoming request is redirected.
    statusCode Integer
    The HTTP status code to return when the requested HTTP method is not in the list of allowed methods. The associated status line returned with the code is mapped from the standard HTTP specification. The default value is 405 (Method Not Allowed). Example: 403
    suffix String
    A string to append to the header value. The resulting header value must still conform to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    value String
    A header value that conforms to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    action string
    The action can be one of these values: ADD_HTTP_REQUEST_HEADER, ADD_HTTP_RESPONSE_HEADER, ALLOW, CONTROL_ACCESS_USING_HTTP_METHODS, EXTEND_HTTP_REQUEST_HEADER_VALUE, EXTEND_HTTP_RESPONSE_HEADER_VALUE, HTTP_HEADER, IP_BASED_MAX_CONNECTIONS, REDIRECT, REMOVE_HTTP_REQUEST_HEADER, REMOVE_HTTP_RESPONSE_HEADER
    allowedMethods string[]
    The list of HTTP methods allowed for this listener.
    areInvalidCharactersAllowed boolean
    Indicates whether or not invalid characters in client header fields will be allowed. Valid names are composed of English letters, digits, hyphens and underscores. If "true", invalid characters are allowed in the HTTP header. If "false", invalid characters are not allowed in the HTTP header
    conditions GetListenerRulesListenerRuleRuleCondition[]
    defaultMaxConnections number
    The maximum number of connections that the any IP can make to a listener unless the IP is mentioned in maxConnections. If no defaultMaxConnections is specified the default is unlimited.
    description string
    A brief description of the access control rule. Avoid entering confidential information.
    header string
    A header name that conforms to RFC 7230. Example: example_header_name
    httpLargeHeaderSizeInKb number
    The maximum size of each buffer used for reading http client request header. This value indicates the maximum size allowed for each buffer. The allowed values for buffer size are 8, 16, 32 and 64.
    ipMaxConnections GetListenerRulesListenerRuleRuleIpMaxConnection[]
    An array of IPs that have a maxConnection setting different than the default and what that maxConnection setting is
    prefix string
    A string to prepend to the header value. The resulting header value must still conform to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    redirectUris GetListenerRulesListenerRuleRuleRedirectUri[]
    An object that defines the redirect URI applied to the original request. The object property values compose the redirect URI.
    responseCode number
    The HTTP status code to return when the incoming request is redirected.
    statusCode number
    The HTTP status code to return when the requested HTTP method is not in the list of allowed methods. The associated status line returned with the code is mapped from the standard HTTP specification. The default value is 405 (Method Not Allowed). Example: 403
    suffix string
    A string to append to the header value. The resulting header value must still conform to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    value string
    A header value that conforms to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    action str
    The action can be one of these values: ADD_HTTP_REQUEST_HEADER, ADD_HTTP_RESPONSE_HEADER, ALLOW, CONTROL_ACCESS_USING_HTTP_METHODS, EXTEND_HTTP_REQUEST_HEADER_VALUE, EXTEND_HTTP_RESPONSE_HEADER_VALUE, HTTP_HEADER, IP_BASED_MAX_CONNECTIONS, REDIRECT, REMOVE_HTTP_REQUEST_HEADER, REMOVE_HTTP_RESPONSE_HEADER
    allowed_methods Sequence[str]
    The list of HTTP methods allowed for this listener.
    are_invalid_characters_allowed bool
    Indicates whether or not invalid characters in client header fields will be allowed. Valid names are composed of English letters, digits, hyphens and underscores. If "true", invalid characters are allowed in the HTTP header. If "false", invalid characters are not allowed in the HTTP header
    conditions Sequence[GetListenerRulesListenerRuleRuleCondition]
    default_max_connections int
    The maximum number of connections that the any IP can make to a listener unless the IP is mentioned in maxConnections. If no defaultMaxConnections is specified the default is unlimited.
    description str
    A brief description of the access control rule. Avoid entering confidential information.
    header str
    A header name that conforms to RFC 7230. Example: example_header_name
    http_large_header_size_in_kb int
    The maximum size of each buffer used for reading http client request header. This value indicates the maximum size allowed for each buffer. The allowed values for buffer size are 8, 16, 32 and 64.
    ip_max_connections Sequence[GetListenerRulesListenerRuleRuleIpMaxConnection]
    An array of IPs that have a maxConnection setting different than the default and what that maxConnection setting is
    prefix str
    A string to prepend to the header value. The resulting header value must still conform to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    redirect_uris Sequence[GetListenerRulesListenerRuleRuleRedirectUri]
    An object that defines the redirect URI applied to the original request. The object property values compose the redirect URI.
    response_code int
    The HTTP status code to return when the incoming request is redirected.
    status_code int
    The HTTP status code to return when the requested HTTP method is not in the list of allowed methods. The associated status line returned with the code is mapped from the standard HTTP specification. The default value is 405 (Method Not Allowed). Example: 403
    suffix str
    A string to append to the header value. The resulting header value must still conform to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    value str
    A header value that conforms to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    action String
    The action can be one of these values: ADD_HTTP_REQUEST_HEADER, ADD_HTTP_RESPONSE_HEADER, ALLOW, CONTROL_ACCESS_USING_HTTP_METHODS, EXTEND_HTTP_REQUEST_HEADER_VALUE, EXTEND_HTTP_RESPONSE_HEADER_VALUE, HTTP_HEADER, IP_BASED_MAX_CONNECTIONS, REDIRECT, REMOVE_HTTP_REQUEST_HEADER, REMOVE_HTTP_RESPONSE_HEADER
    allowedMethods List<String>
    The list of HTTP methods allowed for this listener.
    areInvalidCharactersAllowed Boolean
    Indicates whether or not invalid characters in client header fields will be allowed. Valid names are composed of English letters, digits, hyphens and underscores. If "true", invalid characters are allowed in the HTTP header. If "false", invalid characters are not allowed in the HTTP header
    conditions List<Property Map>
    defaultMaxConnections Number
    The maximum number of connections that the any IP can make to a listener unless the IP is mentioned in maxConnections. If no defaultMaxConnections is specified the default is unlimited.
    description String
    A brief description of the access control rule. Avoid entering confidential information.
    header String
    A header name that conforms to RFC 7230. Example: example_header_name
    httpLargeHeaderSizeInKb Number
    The maximum size of each buffer used for reading http client request header. This value indicates the maximum size allowed for each buffer. The allowed values for buffer size are 8, 16, 32 and 64.
    ipMaxConnections List<Property Map>
    An array of IPs that have a maxConnection setting different than the default and what that maxConnection setting is
    prefix String
    A string to prepend to the header value. The resulting header value must still conform to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    redirectUris List<Property Map>
    An object that defines the redirect URI applied to the original request. The object property values compose the redirect URI.
    responseCode Number
    The HTTP status code to return when the incoming request is redirected.
    statusCode Number
    The HTTP status code to return when the requested HTTP method is not in the list of allowed methods. The associated status line returned with the code is mapped from the standard HTTP specification. The default value is 405 (Method Not Allowed). Example: 403
    suffix String
    A string to append to the header value. The resulting header value must still conform to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.
    value String
    A header value that conforms to RFC 7230. With the following exceptions:

    • value cannot contain $
    • value cannot contain patterns like {variable_name}. They are reserved for future extensions. Currently, such values are invalid.

    GetListenerRulesListenerRuleRuleCondition

    AttributeName string
    The attribute_name can be one of these values: PATH, SOURCE_IP_ADDRESS, SOURCE_VCN_ID, SOURCE_VCN_IP_ADDRESS
    AttributeValue string
    The OCID of the originating VCN that an incoming packet must match.
    Operator string
    A string that specifies how to compare the PathMatchCondition object's attributeValue string to the incoming URI.

    • EXACT_MATCH - The incoming URI path must exactly and completely match the attributeValue string.
    • FORCE_LONGEST_PREFIX_MATCH - The system looks for the attributeValue string with the best, longest match of the beginning portion of the incoming URI path.
    • PREFIX_MATCH - The beginning portion of the incoming URI path must exactly match the attributeValue string.
    • SUFFIX_MATCH - The ending portion of the incoming URI path must exactly match the attributeValue string.
    AttributeName string
    The attribute_name can be one of these values: PATH, SOURCE_IP_ADDRESS, SOURCE_VCN_ID, SOURCE_VCN_IP_ADDRESS
    AttributeValue string
    The OCID of the originating VCN that an incoming packet must match.
    Operator string
    A string that specifies how to compare the PathMatchCondition object's attributeValue string to the incoming URI.

    • EXACT_MATCH - The incoming URI path must exactly and completely match the attributeValue string.
    • FORCE_LONGEST_PREFIX_MATCH - The system looks for the attributeValue string with the best, longest match of the beginning portion of the incoming URI path.
    • PREFIX_MATCH - The beginning portion of the incoming URI path must exactly match the attributeValue string.
    • SUFFIX_MATCH - The ending portion of the incoming URI path must exactly match the attributeValue string.
    attributeName String
    The attribute_name can be one of these values: PATH, SOURCE_IP_ADDRESS, SOURCE_VCN_ID, SOURCE_VCN_IP_ADDRESS
    attributeValue String
    The OCID of the originating VCN that an incoming packet must match.
    operator String
    A string that specifies how to compare the PathMatchCondition object's attributeValue string to the incoming URI.

    • EXACT_MATCH - The incoming URI path must exactly and completely match the attributeValue string.
    • FORCE_LONGEST_PREFIX_MATCH - The system looks for the attributeValue string with the best, longest match of the beginning portion of the incoming URI path.
    • PREFIX_MATCH - The beginning portion of the incoming URI path must exactly match the attributeValue string.
    • SUFFIX_MATCH - The ending portion of the incoming URI path must exactly match the attributeValue string.
    attributeName string
    The attribute_name can be one of these values: PATH, SOURCE_IP_ADDRESS, SOURCE_VCN_ID, SOURCE_VCN_IP_ADDRESS
    attributeValue string
    The OCID of the originating VCN that an incoming packet must match.
    operator string
    A string that specifies how to compare the PathMatchCondition object's attributeValue string to the incoming URI.

    • EXACT_MATCH - The incoming URI path must exactly and completely match the attributeValue string.
    • FORCE_LONGEST_PREFIX_MATCH - The system looks for the attributeValue string with the best, longest match of the beginning portion of the incoming URI path.
    • PREFIX_MATCH - The beginning portion of the incoming URI path must exactly match the attributeValue string.
    • SUFFIX_MATCH - The ending portion of the incoming URI path must exactly match the attributeValue string.
    attribute_name str
    The attribute_name can be one of these values: PATH, SOURCE_IP_ADDRESS, SOURCE_VCN_ID, SOURCE_VCN_IP_ADDRESS
    attribute_value str
    The OCID of the originating VCN that an incoming packet must match.
    operator str
    A string that specifies how to compare the PathMatchCondition object's attributeValue string to the incoming URI.

    • EXACT_MATCH - The incoming URI path must exactly and completely match the attributeValue string.
    • FORCE_LONGEST_PREFIX_MATCH - The system looks for the attributeValue string with the best, longest match of the beginning portion of the incoming URI path.
    • PREFIX_MATCH - The beginning portion of the incoming URI path must exactly match the attributeValue string.
    • SUFFIX_MATCH - The ending portion of the incoming URI path must exactly match the attributeValue string.
    attributeName String
    The attribute_name can be one of these values: PATH, SOURCE_IP_ADDRESS, SOURCE_VCN_ID, SOURCE_VCN_IP_ADDRESS
    attributeValue String
    The OCID of the originating VCN that an incoming packet must match.
    operator String
    A string that specifies how to compare the PathMatchCondition object's attributeValue string to the incoming URI.

    • EXACT_MATCH - The incoming URI path must exactly and completely match the attributeValue string.
    • FORCE_LONGEST_PREFIX_MATCH - The system looks for the attributeValue string with the best, longest match of the beginning portion of the incoming URI path.
    • PREFIX_MATCH - The beginning portion of the incoming URI path must exactly match the attributeValue string.
    • SUFFIX_MATCH - The ending portion of the incoming URI path must exactly match the attributeValue string.

    GetListenerRulesListenerRuleRuleIpMaxConnection

    IpAddresses List<string>
    Each element in the list should be valid IPv4 or IPv6 CIDR Block address. Example: '["129.213.176.0/24", "150.136.187.0/24", "2002::1234:abcd:ffff:c0a8:101/64"]'
    MaxConnections int
    The maximum number of simultaneous connections that the specified IPs can make to the Listener. IPs without a maxConnections setting can make either defaultMaxConnections simultaneous connections to a listener or, if no defaultMaxConnections is specified, an unlimited number of simultaneous connections to a listener.
    IpAddresses []string
    Each element in the list should be valid IPv4 or IPv6 CIDR Block address. Example: '["129.213.176.0/24", "150.136.187.0/24", "2002::1234:abcd:ffff:c0a8:101/64"]'
    MaxConnections int
    The maximum number of simultaneous connections that the specified IPs can make to the Listener. IPs without a maxConnections setting can make either defaultMaxConnections simultaneous connections to a listener or, if no defaultMaxConnections is specified, an unlimited number of simultaneous connections to a listener.
    ipAddresses List<String>
    Each element in the list should be valid IPv4 or IPv6 CIDR Block address. Example: '["129.213.176.0/24", "150.136.187.0/24", "2002::1234:abcd:ffff:c0a8:101/64"]'
    maxConnections Integer
    The maximum number of simultaneous connections that the specified IPs can make to the Listener. IPs without a maxConnections setting can make either defaultMaxConnections simultaneous connections to a listener or, if no defaultMaxConnections is specified, an unlimited number of simultaneous connections to a listener.
    ipAddresses string[]
    Each element in the list should be valid IPv4 or IPv6 CIDR Block address. Example: '["129.213.176.0/24", "150.136.187.0/24", "2002::1234:abcd:ffff:c0a8:101/64"]'
    maxConnections number
    The maximum number of simultaneous connections that the specified IPs can make to the Listener. IPs without a maxConnections setting can make either defaultMaxConnections simultaneous connections to a listener or, if no defaultMaxConnections is specified, an unlimited number of simultaneous connections to a listener.
    ip_addresses Sequence[str]
    Each element in the list should be valid IPv4 or IPv6 CIDR Block address. Example: '["129.213.176.0/24", "150.136.187.0/24", "2002::1234:abcd:ffff:c0a8:101/64"]'
    max_connections int
    The maximum number of simultaneous connections that the specified IPs can make to the Listener. IPs without a maxConnections setting can make either defaultMaxConnections simultaneous connections to a listener or, if no defaultMaxConnections is specified, an unlimited number of simultaneous connections to a listener.
    ipAddresses List<String>
    Each element in the list should be valid IPv4 or IPv6 CIDR Block address. Example: '["129.213.176.0/24", "150.136.187.0/24", "2002::1234:abcd:ffff:c0a8:101/64"]'
    maxConnections Number
    The maximum number of simultaneous connections that the specified IPs can make to the Listener. IPs without a maxConnections setting can make either defaultMaxConnections simultaneous connections to a listener or, if no defaultMaxConnections is specified, an unlimited number of simultaneous connections to a listener.

    GetListenerRulesListenerRuleRuleRedirectUri

    Host string
    The valid domain name (hostname) or IP address to use in the redirect URI.
    Path string
    The HTTP URI path to use in the redirect URI.
    Port int
    The communication port to use in the redirect URI.
    Protocol string
    The HTTP protocol to use in the redirect URI.
    Query string
    The query string to use in the redirect URI.
    Host string
    The valid domain name (hostname) or IP address to use in the redirect URI.
    Path string
    The HTTP URI path to use in the redirect URI.
    Port int
    The communication port to use in the redirect URI.
    Protocol string
    The HTTP protocol to use in the redirect URI.
    Query string
    The query string to use in the redirect URI.
    host String
    The valid domain name (hostname) or IP address to use in the redirect URI.
    path String
    The HTTP URI path to use in the redirect URI.
    port Integer
    The communication port to use in the redirect URI.
    protocol String
    The HTTP protocol to use in the redirect URI.
    query String
    The query string to use in the redirect URI.
    host string
    The valid domain name (hostname) or IP address to use in the redirect URI.
    path string
    The HTTP URI path to use in the redirect URI.
    port number
    The communication port to use in the redirect URI.
    protocol string
    The HTTP protocol to use in the redirect URI.
    query string
    The query string to use in the redirect URI.
    host str
    The valid domain name (hostname) or IP address to use in the redirect URI.
    path str
    The HTTP URI path to use in the redirect URI.
    port int
    The communication port to use in the redirect URI.
    protocol str
    The HTTP protocol to use in the redirect URI.
    query str
    The query string to use in the redirect URI.
    host String
    The valid domain name (hostname) or IP address to use in the redirect URI.
    path String
    The HTTP URI path to use in the redirect URI.
    port Number
    The communication port to use in the redirect URI.
    protocol String
    The HTTP protocol to use in the redirect URI.
    query String
    The query string to use in the redirect URI.

    Package Details

    Repository
    oci pulumi/pulumi-oci
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the oci Terraform Provider.
    oci logo
    Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
    pulumi/pulumi-oci