Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Ibm Provider
  3. API Docs
  4. IsLbListenerPolicy
ibm 1.77.1 published on Monday, Apr 14, 2025 by ibm-cloud
ibm-cloud/terraform-provider-ibm

ibm.IsLbListenerPolicy

Explore with Pulumi AI

ibm 1.77.1 published on Monday, Apr 14, 2025 by ibm-cloud
ibm-cloud/terraform-provider-ibm

Create, update, or delete a load balancer listener policy. For more information, about VPC load balance listener policy, see monitoring application Load Balancer for VPC metrics.

Note: VPC infrastructure services are a regional specific based endpoint, by default targets to us-south. Please make sure to target right region in the provider block as shown in the provider.tf file, if VPC service is created in region other than us-south.

provider.tf

import * as pulumi from "@pulumi/pulumi";
Copy
import pulumi
Copy
package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;

return await Deployment.RunAsync(() => 
{
});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
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) {
    }
}
Copy
{}
Copy

Example Usage

Sample to create a load balancer listener policy for a redirect action.

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

const exampleIsLb = new ibm.IsLb("exampleIsLb", {subnets: [ibm_is_subnet.example.id]});
const exampleIsLbListener = new ibm.IsLbListener("exampleIsLbListener", {
    lb: exampleIsLb.isLbId,
    port: 9086,
    protocol: "http",
});
const exampleIsLbListenerPolicy = new ibm.IsLbListenerPolicy("exampleIsLbListenerPolicy", {
    lb: exampleIsLb.isLbId,
    listener: exampleIsLbListener.listenerId,
    action: "redirect",
    priority: 4,
    target: {
        httpStatusCode: 302,
        url: "https://www.example.com",
    },
});
Copy
import pulumi
import pulumi_ibm as ibm

example_is_lb = ibm.IsLb("exampleIsLb", subnets=[ibm_is_subnet["example"]["id"]])
example_is_lb_listener = ibm.IsLbListener("exampleIsLbListener",
    lb=example_is_lb.is_lb_id,
    port=9086,
    protocol="http")
example_is_lb_listener_policy = ibm.IsLbListenerPolicy("exampleIsLbListenerPolicy",
    lb=example_is_lb.is_lb_id,
    listener=example_is_lb_listener.listener_id,
    action="redirect",
    priority=4,
    target={
        "http_status_code": 302,
        "url": "https://www.example.com",
    })
Copy
package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleIsLb, err := ibm.NewIsLb(ctx, "exampleIsLb", &ibm.IsLbArgs{
			Subnets: pulumi.StringArray{
				ibm_is_subnet.Example.Id,
			},
		})
		if err != nil {
			return err
		}
		exampleIsLbListener, err := ibm.NewIsLbListener(ctx, "exampleIsLbListener", &ibm.IsLbListenerArgs{
			Lb:       exampleIsLb.IsLbId,
			Port:     pulumi.Float64(9086),
			Protocol: pulumi.String("http"),
		})
		if err != nil {
			return err
		}
		_, err = ibm.NewIsLbListenerPolicy(ctx, "exampleIsLbListenerPolicy", &ibm.IsLbListenerPolicyArgs{
			Lb:       exampleIsLb.IsLbId,
			Listener: exampleIsLbListener.ListenerId,
			Action:   pulumi.String("redirect"),
			Priority: pulumi.Float64(4),
			Target: &ibm.IsLbListenerPolicyTargetArgs{
				HttpStatusCode: pulumi.Float64(302),
				Url:            pulumi.String("https://www.example.com"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ibm = Pulumi.Ibm;

return await Deployment.RunAsync(() => 
{
    var exampleIsLb = new Ibm.IsLb("exampleIsLb", new()
    {
        Subnets = new[]
        {
            ibm_is_subnet.Example.Id,
        },
    });

    var exampleIsLbListener = new Ibm.IsLbListener("exampleIsLbListener", new()
    {
        Lb = exampleIsLb.IsLbId,
        Port = 9086,
        Protocol = "http",
    });

    var exampleIsLbListenerPolicy = new Ibm.IsLbListenerPolicy("exampleIsLbListenerPolicy", new()
    {
        Lb = exampleIsLb.IsLbId,
        Listener = exampleIsLbListener.ListenerId,
        Action = "redirect",
        Priority = 4,
        Target = new Ibm.Inputs.IsLbListenerPolicyTargetArgs
        {
            HttpStatusCode = 302,
            Url = "https://www.example.com",
        },
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.IsLb;
import com.pulumi.ibm.IsLbArgs;
import com.pulumi.ibm.IsLbListener;
import com.pulumi.ibm.IsLbListenerArgs;
import com.pulumi.ibm.IsLbListenerPolicy;
import com.pulumi.ibm.IsLbListenerPolicyArgs;
import com.pulumi.ibm.inputs.IsLbListenerPolicyTargetArgs;
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 exampleIsLb = new IsLb("exampleIsLb", IsLbArgs.builder()
            .subnets(ibm_is_subnet.example().id())
            .build());

        var exampleIsLbListener = new IsLbListener("exampleIsLbListener", IsLbListenerArgs.builder()
            .lb(exampleIsLb.isLbId())
            .port("9086")
            .protocol("http")
            .build());

        var exampleIsLbListenerPolicy = new IsLbListenerPolicy("exampleIsLbListenerPolicy", IsLbListenerPolicyArgs.builder()
            .lb(exampleIsLb.isLbId())
            .listener(exampleIsLbListener.listenerId())
            .action("redirect")
            .priority(4)
            .target(IsLbListenerPolicyTargetArgs.builder()
                .httpStatusCode(302)
                .url("https://www.example.com")
                .build())
            .build());

    }
}
Copy
resources:
  exampleIsLb:
    type: ibm:IsLb
    properties:
      subnets:
        - ${ibm_is_subnet.example.id}
  exampleIsLbListener:
    type: ibm:IsLbListener
    properties:
      lb: ${exampleIsLb.isLbId}
      port: '9086'
      protocol: http
  exampleIsLbListenerPolicy:
    type: ibm:IsLbListenerPolicy
    properties:
      lb: ${exampleIsLb.isLbId}
      listener: ${exampleIsLbListener.listenerId}
      action: redirect
      priority: 4
      target:
        httpStatusCode: 302
        url: https://www.example.com
Copy

Sample to create a load balancer listener policy for a redirect action with parameterized url.

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

const exampleIsLb = new ibm.IsLb("exampleIsLb", {subnets: [ibm_is_subnet.example.id]});
const exampleIsLbListener = new ibm.IsLbListener("exampleIsLbListener", {
    lb: exampleIsLb.isLbId,
    port: 9086,
    protocol: "http",
});
const exampleIsLbListenerPolicy = new ibm.IsLbListenerPolicy("exampleIsLbListenerPolicy", {
    lb: exampleIsLb.isLbId,
    listener: exampleIsLbListener.listenerId,
    action: "redirect",
    priority: 4,
    target: {
        httpStatusCode: 302,
        url: "https://{host}:8080/{port}/{host}/{path}",
    },
});
Copy
import pulumi
import pulumi_ibm as ibm

example_is_lb = ibm.IsLb("exampleIsLb", subnets=[ibm_is_subnet["example"]["id"]])
example_is_lb_listener = ibm.IsLbListener("exampleIsLbListener",
    lb=example_is_lb.is_lb_id,
    port=9086,
    protocol="http")
example_is_lb_listener_policy = ibm.IsLbListenerPolicy("exampleIsLbListenerPolicy",
    lb=example_is_lb.is_lb_id,
    listener=example_is_lb_listener.listener_id,
    action="redirect",
    priority=4,
    target={
        "http_status_code": 302,
        "url": "https://{host}:8080/{port}/{host}/{path}",
    })
Copy
package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleIsLb, err := ibm.NewIsLb(ctx, "exampleIsLb", &ibm.IsLbArgs{
			Subnets: pulumi.StringArray{
				ibm_is_subnet.Example.Id,
			},
		})
		if err != nil {
			return err
		}
		exampleIsLbListener, err := ibm.NewIsLbListener(ctx, "exampleIsLbListener", &ibm.IsLbListenerArgs{
			Lb:       exampleIsLb.IsLbId,
			Port:     pulumi.Float64(9086),
			Protocol: pulumi.String("http"),
		})
		if err != nil {
			return err
		}
		_, err = ibm.NewIsLbListenerPolicy(ctx, "exampleIsLbListenerPolicy", &ibm.IsLbListenerPolicyArgs{
			Lb:       exampleIsLb.IsLbId,
			Listener: exampleIsLbListener.ListenerId,
			Action:   pulumi.String("redirect"),
			Priority: pulumi.Float64(4),
			Target: &ibm.IsLbListenerPolicyTargetArgs{
				HttpStatusCode: pulumi.Float64(302),
				Url:            pulumi.String("https://{host}:8080/{port}/{host}/{path}"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ibm = Pulumi.Ibm;

return await Deployment.RunAsync(() => 
{
    var exampleIsLb = new Ibm.IsLb("exampleIsLb", new()
    {
        Subnets = new[]
        {
            ibm_is_subnet.Example.Id,
        },
    });

    var exampleIsLbListener = new Ibm.IsLbListener("exampleIsLbListener", new()
    {
        Lb = exampleIsLb.IsLbId,
        Port = 9086,
        Protocol = "http",
    });

    var exampleIsLbListenerPolicy = new Ibm.IsLbListenerPolicy("exampleIsLbListenerPolicy", new()
    {
        Lb = exampleIsLb.IsLbId,
        Listener = exampleIsLbListener.ListenerId,
        Action = "redirect",
        Priority = 4,
        Target = new Ibm.Inputs.IsLbListenerPolicyTargetArgs
        {
            HttpStatusCode = 302,
            Url = "https://{host}:8080/{port}/{host}/{path}",
        },
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.IsLb;
import com.pulumi.ibm.IsLbArgs;
import com.pulumi.ibm.IsLbListener;
import com.pulumi.ibm.IsLbListenerArgs;
import com.pulumi.ibm.IsLbListenerPolicy;
import com.pulumi.ibm.IsLbListenerPolicyArgs;
import com.pulumi.ibm.inputs.IsLbListenerPolicyTargetArgs;
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 exampleIsLb = new IsLb("exampleIsLb", IsLbArgs.builder()
            .subnets(ibm_is_subnet.example().id())
            .build());

        var exampleIsLbListener = new IsLbListener("exampleIsLbListener", IsLbListenerArgs.builder()
            .lb(exampleIsLb.isLbId())
            .port("9086")
            .protocol("http")
            .build());

        var exampleIsLbListenerPolicy = new IsLbListenerPolicy("exampleIsLbListenerPolicy", IsLbListenerPolicyArgs.builder()
            .lb(exampleIsLb.isLbId())
            .listener(exampleIsLbListener.listenerId())
            .action("redirect")
            .priority(4)
            .target(IsLbListenerPolicyTargetArgs.builder()
                .httpStatusCode(302)
                .url("https://{host}:8080/{port}/{host}/{path}")
                .build())
            .build());

    }
}
Copy
resources:
  exampleIsLb:
    type: ibm:IsLb
    properties:
      subnets:
        - ${ibm_is_subnet.example.id}
  exampleIsLbListener:
    type: ibm:IsLbListener
    properties:
      lb: ${exampleIsLb.isLbId}
      port: '9086'
      protocol: http
  exampleIsLbListenerPolicy:
    type: ibm:IsLbListenerPolicy
    properties:
      lb: ${exampleIsLb.isLbId}
      listener: ${exampleIsLbListener.listenerId}
      action: redirect
      priority: 4
      target:
        httpStatusCode: 302
        url: https://{host}:8080/{port}/{host}/{path}
Copy

Sample to create a load balancer listener policy for a https_redirect action.

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

const exampleIsLb = new ibm.IsLb("exampleIsLb", {subnets: [ibm_is_subnet.example.id]});
const exampleHttpSource = new ibm.IsLbListener("exampleHttpSource", {
    lb: exampleIsLb.isLbId,
    port: 9080,
    protocol: "http",
});
const exampleHttpsTarget = new ibm.IsLbListener("exampleHttpsTarget", {
    lb: exampleIsLb.isLbId,
    port: 9086,
    protocol: "https",
    certificateInstance: "crn:v1:staging:public:cloudcerts:us-south:a2d1bace7b46e4815a81e52c6ffeba5cf:af925157-b125-4db2-b642-adacb8b9c7f5:certificate:c81627a1bf6f766379cc4b98fd2a44ed",
});
const exampleIsLbListenerPolicy = new ibm.IsLbListenerPolicy("exampleIsLbListenerPolicy", {
    lb: exampleIsLb.isLbId,
    listener: exampleHttpSource.listenerId,
    action: "https_redirect",
    priority: 2,
    target: {
        httpStatusCode: 302,
        listener: {
            id: exampleHttpsTarget.listenerId,
        },
        uri: "/example?doc=get",
    },
    rules: [{
        condition: "contains",
        type: "header",
        field: "1",
        value: "2",
    }],
});
Copy
import pulumi
import pulumi_ibm as ibm

example_is_lb = ibm.IsLb("exampleIsLb", subnets=[ibm_is_subnet["example"]["id"]])
example_http_source = ibm.IsLbListener("exampleHttpSource",
    lb=example_is_lb.is_lb_id,
    port=9080,
    protocol="http")
example_https_target = ibm.IsLbListener("exampleHttpsTarget",
    lb=example_is_lb.is_lb_id,
    port=9086,
    protocol="https",
    certificate_instance="crn:v1:staging:public:cloudcerts:us-south:a2d1bace7b46e4815a81e52c6ffeba5cf:af925157-b125-4db2-b642-adacb8b9c7f5:certificate:c81627a1bf6f766379cc4b98fd2a44ed")
example_is_lb_listener_policy = ibm.IsLbListenerPolicy("exampleIsLbListenerPolicy",
    lb=example_is_lb.is_lb_id,
    listener=example_http_source.listener_id,
    action="https_redirect",
    priority=2,
    target={
        "http_status_code": 302,
        "listener": {
            "id": example_https_target.listener_id,
        },
        "uri": "/example?doc=get",
    },
    rules=[{
        "condition": "contains",
        "type": "header",
        "field": "1",
        "value": "2",
    }])
Copy
package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleIsLb, err := ibm.NewIsLb(ctx, "exampleIsLb", &ibm.IsLbArgs{
			Subnets: pulumi.StringArray{
				ibm_is_subnet.Example.Id,
			},
		})
		if err != nil {
			return err
		}
		exampleHttpSource, err := ibm.NewIsLbListener(ctx, "exampleHttpSource", &ibm.IsLbListenerArgs{
			Lb:       exampleIsLb.IsLbId,
			Port:     pulumi.Float64(9080),
			Protocol: pulumi.String("http"),
		})
		if err != nil {
			return err
		}
		exampleHttpsTarget, err := ibm.NewIsLbListener(ctx, "exampleHttpsTarget", &ibm.IsLbListenerArgs{
			Lb:                  exampleIsLb.IsLbId,
			Port:                pulumi.Float64(9086),
			Protocol:            pulumi.String("https"),
			CertificateInstance: pulumi.String("crn:v1:staging:public:cloudcerts:us-south:a2d1bace7b46e4815a81e52c6ffeba5cf:af925157-b125-4db2-b642-adacb8b9c7f5:certificate:c81627a1bf6f766379cc4b98fd2a44ed"),
		})
		if err != nil {
			return err
		}
		_, err = ibm.NewIsLbListenerPolicy(ctx, "exampleIsLbListenerPolicy", &ibm.IsLbListenerPolicyArgs{
			Lb:       exampleIsLb.IsLbId,
			Listener: exampleHttpSource.ListenerId,
			Action:   pulumi.String("https_redirect"),
			Priority: pulumi.Float64(2),
			Target: &ibm.IsLbListenerPolicyTargetArgs{
				HttpStatusCode: pulumi.Float64(302),
				Listener: &ibm.IsLbListenerPolicyTargetListenerArgs{
					Id: exampleHttpsTarget.ListenerId,
				},
				Uri: pulumi.String("/example?doc=get"),
			},
			Rules: ibm.IsLbListenerPolicyRuleTypeArray{
				&ibm.IsLbListenerPolicyRuleTypeArgs{
					Condition: pulumi.String("contains"),
					Type:      pulumi.String("header"),
					Field:     pulumi.String("1"),
					Value:     pulumi.String("2"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ibm = Pulumi.Ibm;

return await Deployment.RunAsync(() => 
{
    var exampleIsLb = new Ibm.IsLb("exampleIsLb", new()
    {
        Subnets = new[]
        {
            ibm_is_subnet.Example.Id,
        },
    });

    var exampleHttpSource = new Ibm.IsLbListener("exampleHttpSource", new()
    {
        Lb = exampleIsLb.IsLbId,
        Port = 9080,
        Protocol = "http",
    });

    var exampleHttpsTarget = new Ibm.IsLbListener("exampleHttpsTarget", new()
    {
        Lb = exampleIsLb.IsLbId,
        Port = 9086,
        Protocol = "https",
        CertificateInstance = "crn:v1:staging:public:cloudcerts:us-south:a2d1bace7b46e4815a81e52c6ffeba5cf:af925157-b125-4db2-b642-adacb8b9c7f5:certificate:c81627a1bf6f766379cc4b98fd2a44ed",
    });

    var exampleIsLbListenerPolicy = new Ibm.IsLbListenerPolicy("exampleIsLbListenerPolicy", new()
    {
        Lb = exampleIsLb.IsLbId,
        Listener = exampleHttpSource.ListenerId,
        Action = "https_redirect",
        Priority = 2,
        Target = new Ibm.Inputs.IsLbListenerPolicyTargetArgs
        {
            HttpStatusCode = 302,
            Listener = new Ibm.Inputs.IsLbListenerPolicyTargetListenerArgs
            {
                Id = exampleHttpsTarget.ListenerId,
            },
            Uri = "/example?doc=get",
        },
        Rules = new[]
        {
            new Ibm.Inputs.IsLbListenerPolicyRuleArgs
            {
                Condition = "contains",
                Type = "header",
                Field = "1",
                Value = "2",
            },
        },
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.IsLb;
import com.pulumi.ibm.IsLbArgs;
import com.pulumi.ibm.IsLbListener;
import com.pulumi.ibm.IsLbListenerArgs;
import com.pulumi.ibm.IsLbListenerPolicy;
import com.pulumi.ibm.IsLbListenerPolicyArgs;
import com.pulumi.ibm.inputs.IsLbListenerPolicyTargetArgs;
import com.pulumi.ibm.inputs.IsLbListenerPolicyTargetListenerArgs;
import com.pulumi.ibm.inputs.IsLbListenerPolicyRuleArgs;
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 exampleIsLb = new IsLb("exampleIsLb", IsLbArgs.builder()
            .subnets(ibm_is_subnet.example().id())
            .build());

        var exampleHttpSource = new IsLbListener("exampleHttpSource", IsLbListenerArgs.builder()
            .lb(exampleIsLb.isLbId())
            .port("9080")
            .protocol("http")
            .build());

        var exampleHttpsTarget = new IsLbListener("exampleHttpsTarget", IsLbListenerArgs.builder()
            .lb(exampleIsLb.isLbId())
            .port("9086")
            .protocol("https")
            .certificateInstance("crn:v1:staging:public:cloudcerts:us-south:a2d1bace7b46e4815a81e52c6ffeba5cf:af925157-b125-4db2-b642-adacb8b9c7f5:certificate:c81627a1bf6f766379cc4b98fd2a44ed")
            .build());

        var exampleIsLbListenerPolicy = new IsLbListenerPolicy("exampleIsLbListenerPolicy", IsLbListenerPolicyArgs.builder()
            .lb(exampleIsLb.isLbId())
            .listener(exampleHttpSource.listenerId())
            .action("https_redirect")
            .priority(2)
            .target(IsLbListenerPolicyTargetArgs.builder()
                .httpStatusCode(302)
                .listener(IsLbListenerPolicyTargetListenerArgs.builder()
                    .id(exampleHttpsTarget.listenerId())
                    .build())
                .uri("/example?doc=get")
                .build())
            .rules(IsLbListenerPolicyRuleArgs.builder()
                .condition("contains")
                .type("header")
                .field("1")
                .value("2")
                .build())
            .build());

    }
}
Copy
resources:
  exampleIsLb:
    type: ibm:IsLb
    properties:
      subnets:
        - ${ibm_is_subnet.example.id}
  exampleHttpSource:
    type: ibm:IsLbListener
    properties:
      lb: ${exampleIsLb.isLbId}
      port: '9080'
      protocol: http
  exampleHttpsTarget:
    type: ibm:IsLbListener
    properties:
      lb: ${exampleIsLb.isLbId}
      port: '9086'
      protocol: https
      certificateInstance: crn:v1:staging:public:cloudcerts:us-south:a2d1bace7b46e4815a81e52c6ffeba5cf:af925157-b125-4db2-b642-adacb8b9c7f5:certificate:c81627a1bf6f766379cc4b98fd2a44ed
  exampleIsLbListenerPolicy:
    type: ibm:IsLbListenerPolicy
    properties:
      lb: ${exampleIsLb.isLbId}
      listener: ${exampleHttpSource.listenerId}
      action: https_redirect
      priority: 2
      target:
        httpStatusCode: 302
        listener:
          id: ${exampleHttpsTarget.listenerId}
        uri: /example?doc=get
      rules:
        - condition: contains
          type: header
          field: '1'
          value: '2'
Copy

Creating a load balancer listener policy for a forward action.

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

const exampleIsLb = new ibm.IsLb("exampleIsLb", {subnets: [ibm_is_subnet.example.id]});
const exampleIsLbListener = new ibm.IsLbListener("exampleIsLbListener", {
    lb: exampleIsLb.isLbId,
    port: 9086,
    protocol: "http",
});
const exampleIsLbPool = new ibm.IsLbPool("exampleIsLbPool", {
    lb: exampleIsLb.isLbId,
    algorithm: "round_robin",
    protocol: "http",
    healthDelay: 60,
    healthRetries: 5,
    healthTimeout: 30,
    healthType: "http",
});
const exampleIsLbListenerPolicy = new ibm.IsLbListenerPolicy("exampleIsLbListenerPolicy", {
    lb: exampleIsLb.isLbId,
    listener: exampleIsLbListener.listenerId,
    action: "forward",
    priority: 3,
    target: {
        id: exampleIsLbPool.poolId,
    },
});
Copy
import pulumi
import pulumi_ibm as ibm

example_is_lb = ibm.IsLb("exampleIsLb", subnets=[ibm_is_subnet["example"]["id"]])
example_is_lb_listener = ibm.IsLbListener("exampleIsLbListener",
    lb=example_is_lb.is_lb_id,
    port=9086,
    protocol="http")
example_is_lb_pool = ibm.IsLbPool("exampleIsLbPool",
    lb=example_is_lb.is_lb_id,
    algorithm="round_robin",
    protocol="http",
    health_delay=60,
    health_retries=5,
    health_timeout=30,
    health_type="http")
example_is_lb_listener_policy = ibm.IsLbListenerPolicy("exampleIsLbListenerPolicy",
    lb=example_is_lb.is_lb_id,
    listener=example_is_lb_listener.listener_id,
    action="forward",
    priority=3,
    target={
        "id": example_is_lb_pool.pool_id,
    })
Copy
package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleIsLb, err := ibm.NewIsLb(ctx, "exampleIsLb", &ibm.IsLbArgs{
			Subnets: pulumi.StringArray{
				ibm_is_subnet.Example.Id,
			},
		})
		if err != nil {
			return err
		}
		exampleIsLbListener, err := ibm.NewIsLbListener(ctx, "exampleIsLbListener", &ibm.IsLbListenerArgs{
			Lb:       exampleIsLb.IsLbId,
			Port:     pulumi.Float64(9086),
			Protocol: pulumi.String("http"),
		})
		if err != nil {
			return err
		}
		exampleIsLbPool, err := ibm.NewIsLbPool(ctx, "exampleIsLbPool", &ibm.IsLbPoolArgs{
			Lb:            exampleIsLb.IsLbId,
			Algorithm:     pulumi.String("round_robin"),
			Protocol:      pulumi.String("http"),
			HealthDelay:   pulumi.Float64(60),
			HealthRetries: pulumi.Float64(5),
			HealthTimeout: pulumi.Float64(30),
			HealthType:    pulumi.String("http"),
		})
		if err != nil {
			return err
		}
		_, err = ibm.NewIsLbListenerPolicy(ctx, "exampleIsLbListenerPolicy", &ibm.IsLbListenerPolicyArgs{
			Lb:       exampleIsLb.IsLbId,
			Listener: exampleIsLbListener.ListenerId,
			Action:   pulumi.String("forward"),
			Priority: pulumi.Float64(3),
			Target: &ibm.IsLbListenerPolicyTargetArgs{
				Id: exampleIsLbPool.PoolId,
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ibm = Pulumi.Ibm;

return await Deployment.RunAsync(() => 
{
    var exampleIsLb = new Ibm.IsLb("exampleIsLb", new()
    {
        Subnets = new[]
        {
            ibm_is_subnet.Example.Id,
        },
    });

    var exampleIsLbListener = new Ibm.IsLbListener("exampleIsLbListener", new()
    {
        Lb = exampleIsLb.IsLbId,
        Port = 9086,
        Protocol = "http",
    });

    var exampleIsLbPool = new Ibm.IsLbPool("exampleIsLbPool", new()
    {
        Lb = exampleIsLb.IsLbId,
        Algorithm = "round_robin",
        Protocol = "http",
        HealthDelay = 60,
        HealthRetries = 5,
        HealthTimeout = 30,
        HealthType = "http",
    });

    var exampleIsLbListenerPolicy = new Ibm.IsLbListenerPolicy("exampleIsLbListenerPolicy", new()
    {
        Lb = exampleIsLb.IsLbId,
        Listener = exampleIsLbListener.ListenerId,
        Action = "forward",
        Priority = 3,
        Target = new Ibm.Inputs.IsLbListenerPolicyTargetArgs
        {
            Id = exampleIsLbPool.PoolId,
        },
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.IsLb;
import com.pulumi.ibm.IsLbArgs;
import com.pulumi.ibm.IsLbListener;
import com.pulumi.ibm.IsLbListenerArgs;
import com.pulumi.ibm.IsLbPool;
import com.pulumi.ibm.IsLbPoolArgs;
import com.pulumi.ibm.IsLbListenerPolicy;
import com.pulumi.ibm.IsLbListenerPolicyArgs;
import com.pulumi.ibm.inputs.IsLbListenerPolicyTargetArgs;
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 exampleIsLb = new IsLb("exampleIsLb", IsLbArgs.builder()
            .subnets(ibm_is_subnet.example().id())
            .build());

        var exampleIsLbListener = new IsLbListener("exampleIsLbListener", IsLbListenerArgs.builder()
            .lb(exampleIsLb.isLbId())
            .port("9086")
            .protocol("http")
            .build());

        var exampleIsLbPool = new IsLbPool("exampleIsLbPool", IsLbPoolArgs.builder()
            .lb(exampleIsLb.isLbId())
            .algorithm("round_robin")
            .protocol("http")
            .healthDelay(60)
            .healthRetries(5)
            .healthTimeout(30)
            .healthType("http")
            .build());

        var exampleIsLbListenerPolicy = new IsLbListenerPolicy("exampleIsLbListenerPolicy", IsLbListenerPolicyArgs.builder()
            .lb(exampleIsLb.isLbId())
            .listener(exampleIsLbListener.listenerId())
            .action("forward")
            .priority(3)
            .target(IsLbListenerPolicyTargetArgs.builder()
                .id(exampleIsLbPool.poolId())
                .build())
            .build());

    }
}
Copy
resources:
  exampleIsLb:
    type: ibm:IsLb
    properties:
      subnets:
        - ${ibm_is_subnet.example.id}
  exampleIsLbListener:
    type: ibm:IsLbListener
    properties:
      lb: ${exampleIsLb.isLbId}
      port: '9086'
      protocol: http
  exampleIsLbPool:
    type: ibm:IsLbPool
    properties:
      lb: ${exampleIsLb.isLbId}
      algorithm: round_robin
      protocol: http
      healthDelay: 60
      healthRetries: 5
      healthTimeout: 30
      healthType: http
  exampleIsLbListenerPolicy:
    type: ibm:IsLbListenerPolicy
    properties:
      lb: ${exampleIsLb.isLbId}
      listener: ${exampleIsLbListener.listenerId}
      action: forward
      priority: 3
      target:
        id: ${exampleIsLbPool.poolId}
Copy

Create IsLbListenerPolicy Resource

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

Constructor syntax

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

@overload
def IsLbListenerPolicy(resource_name: str,
                       opts: Optional[ResourceOptions] = None,
                       priority: Optional[float] = None,
                       action: Optional[str] = None,
                       lb: Optional[str] = None,
                       listener: Optional[str] = None,
                       rules: Optional[Sequence[IsLbListenerPolicyRuleArgs]] = None,
                       name: Optional[str] = None,
                       is_lb_listener_policy_id: Optional[str] = None,
                       target: Optional[IsLbListenerPolicyTargetArgs] = None,
                       target_http_status_code: Optional[float] = None,
                       target_https_redirect_listener: Optional[str] = None,
                       target_https_redirect_status_code: Optional[float] = None,
                       target_https_redirect_uri: Optional[str] = None,
                       target_id: Optional[str] = None,
                       target_url: Optional[str] = None,
                       timeouts: Optional[IsLbListenerPolicyTimeoutsArgs] = None)
func NewIsLbListenerPolicy(ctx *Context, name string, args IsLbListenerPolicyArgs, opts ...ResourceOption) (*IsLbListenerPolicy, error)
public IsLbListenerPolicy(string name, IsLbListenerPolicyArgs args, CustomResourceOptions? opts = null)
public IsLbListenerPolicy(String name, IsLbListenerPolicyArgs args)
public IsLbListenerPolicy(String name, IsLbListenerPolicyArgs args, CustomResourceOptions options)

type: ibm:IsLbListenerPolicy
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args This property is required. IsLbListenerPolicyArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args This property is required. IsLbListenerPolicyArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args This property is required. IsLbListenerPolicyArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args This property is required. IsLbListenerPolicyArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. IsLbListenerPolicyArgs
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 isLbListenerPolicyResource = new Ibm.IsLbListenerPolicy("isLbListenerPolicyResource", new()
{
    Priority = 0,
    Action = "string",
    Lb = "string",
    Listener = "string",
    Rules = new[]
    {
        new Ibm.Inputs.IsLbListenerPolicyRuleArgs
        {
            Condition = "string",
            Type = "string",
            Value = "string",
            Field = "string",
            RuleId = "string",
        },
    },
    Name = "string",
    IsLbListenerPolicyId = "string",
    Target = new Ibm.Inputs.IsLbListenerPolicyTargetArgs
    {
        Deleteds = new[]
        {
            new Ibm.Inputs.IsLbListenerPolicyTargetDeletedArgs
            {
                MoreInfo = "string",
            },
        },
        Href = "string",
        HttpStatusCode = 0,
        Id = "string",
        Listener = new Ibm.Inputs.IsLbListenerPolicyTargetListenerArgs
        {
            Id = "string",
            Deleteds = new[]
            {
                new Ibm.Inputs.IsLbListenerPolicyTargetListenerDeletedArgs
                {
                    MoreInfo = "string",
                },
            },
            Href = "string",
        },
        Name = "string",
        Uri = "string",
        Url = "string",
    },
    Timeouts = new Ibm.Inputs.IsLbListenerPolicyTimeoutsArgs
    {
        Create = "string",
        Delete = "string",
        Update = "string",
    },
});
Copy
example, err := ibm.NewIsLbListenerPolicy(ctx, "isLbListenerPolicyResource", &ibm.IsLbListenerPolicyArgs{
Priority: pulumi.Float64(0),
Action: pulumi.String("string"),
Lb: pulumi.String("string"),
Listener: pulumi.String("string"),
Rules: .IsLbListenerPolicyRuleTypeArray{
&.IsLbListenerPolicyRuleTypeArgs{
Condition: pulumi.String("string"),
Type: pulumi.String("string"),
Value: pulumi.String("string"),
Field: pulumi.String("string"),
RuleId: pulumi.String("string"),
},
},
Name: pulumi.String("string"),
IsLbListenerPolicyId: pulumi.String("string"),
Target: &.IsLbListenerPolicyTargetArgs{
Deleteds: .IsLbListenerPolicyTargetDeletedArray{
&.IsLbListenerPolicyTargetDeletedArgs{
MoreInfo: pulumi.String("string"),
},
},
Href: pulumi.String("string"),
HttpStatusCode: pulumi.Float64(0),
Id: pulumi.String("string"),
Listener: &.IsLbListenerPolicyTargetListenerArgs{
Id: pulumi.String("string"),
Deleteds: .IsLbListenerPolicyTargetListenerDeletedArray{
&.IsLbListenerPolicyTargetListenerDeletedArgs{
MoreInfo: pulumi.String("string"),
},
},
Href: pulumi.String("string"),
},
Name: pulumi.String("string"),
Uri: pulumi.String("string"),
Url: pulumi.String("string"),
},
Timeouts: &.IsLbListenerPolicyTimeoutsArgs{
Create: pulumi.String("string"),
Delete: pulumi.String("string"),
Update: pulumi.String("string"),
},
})
Copy
var isLbListenerPolicyResource = new IsLbListenerPolicy("isLbListenerPolicyResource", IsLbListenerPolicyArgs.builder()
    .priority(0)
    .action("string")
    .lb("string")
    .listener("string")
    .rules(IsLbListenerPolicyRuleArgs.builder()
        .condition("string")
        .type("string")
        .value("string")
        .field("string")
        .ruleId("string")
        .build())
    .name("string")
    .isLbListenerPolicyId("string")
    .target(IsLbListenerPolicyTargetArgs.builder()
        .deleteds(IsLbListenerPolicyTargetDeletedArgs.builder()
            .moreInfo("string")
            .build())
        .href("string")
        .httpStatusCode(0)
        .id("string")
        .listener(IsLbListenerPolicyTargetListenerArgs.builder()
            .id("string")
            .deleteds(IsLbListenerPolicyTargetListenerDeletedArgs.builder()
                .moreInfo("string")
                .build())
            .href("string")
            .build())
        .name("string")
        .uri("string")
        .url("string")
        .build())
    .timeouts(IsLbListenerPolicyTimeoutsArgs.builder()
        .create("string")
        .delete("string")
        .update("string")
        .build())
    .build());
Copy
is_lb_listener_policy_resource = ibm.IsLbListenerPolicy("isLbListenerPolicyResource",
    priority=0,
    action="string",
    lb="string",
    listener="string",
    rules=[{
        "condition": "string",
        "type": "string",
        "value": "string",
        "field": "string",
        "rule_id": "string",
    }],
    name="string",
    is_lb_listener_policy_id="string",
    target={
        "deleteds": [{
            "more_info": "string",
        }],
        "href": "string",
        "http_status_code": 0,
        "id": "string",
        "listener": {
            "id": "string",
            "deleteds": [{
                "more_info": "string",
            }],
            "href": "string",
        },
        "name": "string",
        "uri": "string",
        "url": "string",
    },
    timeouts={
        "create": "string",
        "delete": "string",
        "update": "string",
    })
Copy
const isLbListenerPolicyResource = new ibm.IsLbListenerPolicy("isLbListenerPolicyResource", {
    priority: 0,
    action: "string",
    lb: "string",
    listener: "string",
    rules: [{
        condition: "string",
        type: "string",
        value: "string",
        field: "string",
        ruleId: "string",
    }],
    name: "string",
    isLbListenerPolicyId: "string",
    target: {
        deleteds: [{
            moreInfo: "string",
        }],
        href: "string",
        httpStatusCode: 0,
        id: "string",
        listener: {
            id: "string",
            deleteds: [{
                moreInfo: "string",
            }],
            href: "string",
        },
        name: "string",
        uri: "string",
        url: "string",
    },
    timeouts: {
        create: "string",
        "delete": "string",
        update: "string",
    },
});
Copy
type: ibm:IsLbListenerPolicy
properties:
    action: string
    isLbListenerPolicyId: string
    lb: string
    listener: string
    name: string
    priority: 0
    rules:
        - condition: string
          field: string
          ruleId: string
          type: string
          value: string
    target:
        deleteds:
            - moreInfo: string
        href: string
        httpStatusCode: 0
        id: string
        listener:
            deleteds:
                - moreInfo: string
            href: string
            id: string
        name: string
        uri: string
        url: string
    timeouts:
        create: string
        delete: string
        update: string
Copy

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

Action This property is required. string
The action that you want to specify for your policy. Supported values are forward, redirect, reject, and https_redirect.
Lb This property is required. string
The ID of the load balancer for which you want to create a load balancer listener policy.
Listener This property is required. string
The ID of the load balancer listener.
Priority This property is required. double
The priority of the load balancer policy. Low values indicate a high priority. The value must be between 1 and 10.Yes.
IsLbListenerPolicyId string
(String) The ID of the load balancer listener policy. The ID is composed of <lb_ID>/<listener_ID>/<policy_ID>.
Name string
The name for the load balancer policy. Names must be unique within a load balancer listener.
Rules List<IsLbListenerPolicyRule>

A list of rules that you want to apply to your load balancer policy. Note that rules can be created only. You cannot update the rules for a load balancer policy.

Nested scheme for rules:

Target IsLbListenerPolicyTarget
If action is forward, the response is a LoadBalancerPoolReference- If action is redirect, the response is a LoadBalancerListenerPolicyRedirectURL- If action is https_redirect, the response is a LoadBalancerListenerHTTPSRedirect. Nested schema for target:
TargetHttpStatusCode double
When action is set to redirect, specify the HTTP response code that must be returned in the redirect response. Supported values are 301, 302, 303, 307, and 308.

Deprecated: Deprecated

TargetHttpsRedirectListener string
When action is set to https_redirect, specify the ID of the listener that will be set as http redirect target.

Deprecated: Deprecated

TargetHttpsRedirectStatusCode double
When action is set to https_redirect, specify the HTTP status code to be returned in the redirect response. Supported values are 301, 302, 303, 307, 308.

Deprecated: Deprecated

TargetHttpsRedirectUri string

When action is set to https_redirect, specify the target URI where traffic will be redirected.

Note: target_id, target_http_status_code, target_url, target_https_redirect_listener, target_https_redirect_status_code, target_https_redirect_uri are deprecated and will be removed soon. Please use target instead.

Deprecated: Deprecated

TargetId string
When action is set to forward, specify the ID of the load balancer pool that the load balancer forwards network traffic to.

Deprecated: Deprecated

TargetUrl string
When action is set to redirect, specify the URL that is used in the redirect response.

Deprecated: Deprecated

Timeouts IsLbListenerPolicyTimeouts
Action This property is required. string
The action that you want to specify for your policy. Supported values are forward, redirect, reject, and https_redirect.
Lb This property is required. string
The ID of the load balancer for which you want to create a load balancer listener policy.
Listener This property is required. string
The ID of the load balancer listener.
Priority This property is required. float64
The priority of the load balancer policy. Low values indicate a high priority. The value must be between 1 and 10.Yes.
IsLbListenerPolicyId string
(String) The ID of the load balancer listener policy. The ID is composed of <lb_ID>/<listener_ID>/<policy_ID>.
Name string
The name for the load balancer policy. Names must be unique within a load balancer listener.
Rules []IsLbListenerPolicyRuleTypeArgs

A list of rules that you want to apply to your load balancer policy. Note that rules can be created only. You cannot update the rules for a load balancer policy.

Nested scheme for rules:

Target IsLbListenerPolicyTargetArgs
If action is forward, the response is a LoadBalancerPoolReference- If action is redirect, the response is a LoadBalancerListenerPolicyRedirectURL- If action is https_redirect, the response is a LoadBalancerListenerHTTPSRedirect. Nested schema for target:
TargetHttpStatusCode float64
When action is set to redirect, specify the HTTP response code that must be returned in the redirect response. Supported values are 301, 302, 303, 307, and 308.

Deprecated: Deprecated

TargetHttpsRedirectListener string
When action is set to https_redirect, specify the ID of the listener that will be set as http redirect target.

Deprecated: Deprecated

TargetHttpsRedirectStatusCode float64
When action is set to https_redirect, specify the HTTP status code to be returned in the redirect response. Supported values are 301, 302, 303, 307, 308.

Deprecated: Deprecated

TargetHttpsRedirectUri string

When action is set to https_redirect, specify the target URI where traffic will be redirected.

Note: target_id, target_http_status_code, target_url, target_https_redirect_listener, target_https_redirect_status_code, target_https_redirect_uri are deprecated and will be removed soon. Please use target instead.

Deprecated: Deprecated

TargetId string
When action is set to forward, specify the ID of the load balancer pool that the load balancer forwards network traffic to.

Deprecated: Deprecated

TargetUrl string
When action is set to redirect, specify the URL that is used in the redirect response.

Deprecated: Deprecated

Timeouts IsLbListenerPolicyTimeoutsArgs
action This property is required. String
The action that you want to specify for your policy. Supported values are forward, redirect, reject, and https_redirect.
lb This property is required. String
The ID of the load balancer for which you want to create a load balancer listener policy.
listener This property is required. String
The ID of the load balancer listener.
priority This property is required. Double
The priority of the load balancer policy. Low values indicate a high priority. The value must be between 1 and 10.Yes.
isLbListenerPolicyId String
(String) The ID of the load balancer listener policy. The ID is composed of <lb_ID>/<listener_ID>/<policy_ID>.
name String
The name for the load balancer policy. Names must be unique within a load balancer listener.
rules List<IsLbListenerPolicyRule>

A list of rules that you want to apply to your load balancer policy. Note that rules can be created only. You cannot update the rules for a load balancer policy.

Nested scheme for rules:

target IsLbListenerPolicyTarget
If action is forward, the response is a LoadBalancerPoolReference- If action is redirect, the response is a LoadBalancerListenerPolicyRedirectURL- If action is https_redirect, the response is a LoadBalancerListenerHTTPSRedirect. Nested schema for target:
targetHttpStatusCode Double
When action is set to redirect, specify the HTTP response code that must be returned in the redirect response. Supported values are 301, 302, 303, 307, and 308.

Deprecated: Deprecated

targetHttpsRedirectListener String
When action is set to https_redirect, specify the ID of the listener that will be set as http redirect target.

Deprecated: Deprecated

targetHttpsRedirectStatusCode Double
When action is set to https_redirect, specify the HTTP status code to be returned in the redirect response. Supported values are 301, 302, 303, 307, 308.

Deprecated: Deprecated

targetHttpsRedirectUri String

When action is set to https_redirect, specify the target URI where traffic will be redirected.

Note: target_id, target_http_status_code, target_url, target_https_redirect_listener, target_https_redirect_status_code, target_https_redirect_uri are deprecated and will be removed soon. Please use target instead.

Deprecated: Deprecated

targetId String
When action is set to forward, specify the ID of the load balancer pool that the load balancer forwards network traffic to.

Deprecated: Deprecated

targetUrl String
When action is set to redirect, specify the URL that is used in the redirect response.

Deprecated: Deprecated

timeouts IsLbListenerPolicyTimeouts
action This property is required. string
The action that you want to specify for your policy. Supported values are forward, redirect, reject, and https_redirect.
lb This property is required. string
The ID of the load balancer for which you want to create a load balancer listener policy.
listener This property is required. string
The ID of the load balancer listener.
priority This property is required. number
The priority of the load balancer policy. Low values indicate a high priority. The value must be between 1 and 10.Yes.
isLbListenerPolicyId string
(String) The ID of the load balancer listener policy. The ID is composed of <lb_ID>/<listener_ID>/<policy_ID>.
name string
The name for the load balancer policy. Names must be unique within a load balancer listener.
rules IsLbListenerPolicyRule[]

A list of rules that you want to apply to your load balancer policy. Note that rules can be created only. You cannot update the rules for a load balancer policy.

Nested scheme for rules:

target IsLbListenerPolicyTarget
If action is forward, the response is a LoadBalancerPoolReference- If action is redirect, the response is a LoadBalancerListenerPolicyRedirectURL- If action is https_redirect, the response is a LoadBalancerListenerHTTPSRedirect. Nested schema for target:
targetHttpStatusCode number
When action is set to redirect, specify the HTTP response code that must be returned in the redirect response. Supported values are 301, 302, 303, 307, and 308.

Deprecated: Deprecated

targetHttpsRedirectListener string
When action is set to https_redirect, specify the ID of the listener that will be set as http redirect target.

Deprecated: Deprecated

targetHttpsRedirectStatusCode number
When action is set to https_redirect, specify the HTTP status code to be returned in the redirect response. Supported values are 301, 302, 303, 307, 308.

Deprecated: Deprecated

targetHttpsRedirectUri string

When action is set to https_redirect, specify the target URI where traffic will be redirected.

Note: target_id, target_http_status_code, target_url, target_https_redirect_listener, target_https_redirect_status_code, target_https_redirect_uri are deprecated and will be removed soon. Please use target instead.

Deprecated: Deprecated

targetId string
When action is set to forward, specify the ID of the load balancer pool that the load balancer forwards network traffic to.

Deprecated: Deprecated

targetUrl string
When action is set to redirect, specify the URL that is used in the redirect response.

Deprecated: Deprecated

timeouts IsLbListenerPolicyTimeouts
action This property is required. str
The action that you want to specify for your policy. Supported values are forward, redirect, reject, and https_redirect.
lb This property is required. str
The ID of the load balancer for which you want to create a load balancer listener policy.
listener This property is required. str
The ID of the load balancer listener.
priority This property is required. float
The priority of the load balancer policy. Low values indicate a high priority. The value must be between 1 and 10.Yes.
is_lb_listener_policy_id str
(String) The ID of the load balancer listener policy. The ID is composed of <lb_ID>/<listener_ID>/<policy_ID>.
name str
The name for the load balancer policy. Names must be unique within a load balancer listener.
rules Sequence[IsLbListenerPolicyRuleArgs]

A list of rules that you want to apply to your load balancer policy. Note that rules can be created only. You cannot update the rules for a load balancer policy.

Nested scheme for rules:

target IsLbListenerPolicyTargetArgs
If action is forward, the response is a LoadBalancerPoolReference- If action is redirect, the response is a LoadBalancerListenerPolicyRedirectURL- If action is https_redirect, the response is a LoadBalancerListenerHTTPSRedirect. Nested schema for target:
target_http_status_code float
When action is set to redirect, specify the HTTP response code that must be returned in the redirect response. Supported values are 301, 302, 303, 307, and 308.

Deprecated: Deprecated

target_https_redirect_listener str
When action is set to https_redirect, specify the ID of the listener that will be set as http redirect target.

Deprecated: Deprecated

target_https_redirect_status_code float
When action is set to https_redirect, specify the HTTP status code to be returned in the redirect response. Supported values are 301, 302, 303, 307, 308.

Deprecated: Deprecated

target_https_redirect_uri str

When action is set to https_redirect, specify the target URI where traffic will be redirected.

Note: target_id, target_http_status_code, target_url, target_https_redirect_listener, target_https_redirect_status_code, target_https_redirect_uri are deprecated and will be removed soon. Please use target instead.

Deprecated: Deprecated

target_id str
When action is set to forward, specify the ID of the load balancer pool that the load balancer forwards network traffic to.

Deprecated: Deprecated

target_url str
When action is set to redirect, specify the URL that is used in the redirect response.

Deprecated: Deprecated

timeouts IsLbListenerPolicyTimeoutsArgs
action This property is required. String
The action that you want to specify for your policy. Supported values are forward, redirect, reject, and https_redirect.
lb This property is required. String
The ID of the load balancer for which you want to create a load balancer listener policy.
listener This property is required. String
The ID of the load balancer listener.
priority This property is required. Number
The priority of the load balancer policy. Low values indicate a high priority. The value must be between 1 and 10.Yes.
isLbListenerPolicyId String
(String) The ID of the load balancer listener policy. The ID is composed of <lb_ID>/<listener_ID>/<policy_ID>.
name String
The name for the load balancer policy. Names must be unique within a load balancer listener.
rules List<Property Map>

A list of rules that you want to apply to your load balancer policy. Note that rules can be created only. You cannot update the rules for a load balancer policy.

Nested scheme for rules:

target Property Map
If action is forward, the response is a LoadBalancerPoolReference- If action is redirect, the response is a LoadBalancerListenerPolicyRedirectURL- If action is https_redirect, the response is a LoadBalancerListenerHTTPSRedirect. Nested schema for target:
targetHttpStatusCode Number
When action is set to redirect, specify the HTTP response code that must be returned in the redirect response. Supported values are 301, 302, 303, 307, and 308.

Deprecated: Deprecated

targetHttpsRedirectListener String
When action is set to https_redirect, specify the ID of the listener that will be set as http redirect target.

Deprecated: Deprecated

targetHttpsRedirectStatusCode Number
When action is set to https_redirect, specify the HTTP status code to be returned in the redirect response. Supported values are 301, 302, 303, 307, 308.

Deprecated: Deprecated

targetHttpsRedirectUri String

When action is set to https_redirect, specify the target URI where traffic will be redirected.

Note: target_id, target_http_status_code, target_url, target_https_redirect_listener, target_https_redirect_status_code, target_https_redirect_uri are deprecated and will be removed soon. Please use target instead.

Deprecated: Deprecated

targetId String
When action is set to forward, specify the ID of the load balancer pool that the load balancer forwards network traffic to.

Deprecated: Deprecated

targetUrl String
When action is set to redirect, specify the URL that is used in the redirect response.

Deprecated: Deprecated

timeouts Property Map

Outputs

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

Id string
The provider-assigned unique ID for this managed resource.
PolicyId string
(String) The ID of the load balancer listener policy.
ProvisioningStatus string
Listner Policy status
RelatedCrn string
The crn of the LB resource
Id string
The provider-assigned unique ID for this managed resource.
PolicyId string
(String) The ID of the load balancer listener policy.
ProvisioningStatus string
Listner Policy status
RelatedCrn string
The crn of the LB resource
id String
The provider-assigned unique ID for this managed resource.
policyId String
(String) The ID of the load balancer listener policy.
provisioningStatus String
Listner Policy status
relatedCrn String
The crn of the LB resource
id string
The provider-assigned unique ID for this managed resource.
policyId string
(String) The ID of the load balancer listener policy.
provisioningStatus string
Listner Policy status
relatedCrn string
The crn of the LB resource
id str
The provider-assigned unique ID for this managed resource.
policy_id str
(String) The ID of the load balancer listener policy.
provisioning_status str
Listner Policy status
related_crn str
The crn of the LB resource
id String
The provider-assigned unique ID for this managed resource.
policyId String
(String) The ID of the load balancer listener policy.
provisioningStatus String
Listner Policy status
relatedCrn String
The crn of the LB resource

Look up Existing IsLbListenerPolicy Resource

Get an existing IsLbListenerPolicy 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?: IsLbListenerPolicyState, opts?: CustomResourceOptions): IsLbListenerPolicy
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        action: Optional[str] = None,
        is_lb_listener_policy_id: Optional[str] = None,
        lb: Optional[str] = None,
        listener: Optional[str] = None,
        name: Optional[str] = None,
        policy_id: Optional[str] = None,
        priority: Optional[float] = None,
        provisioning_status: Optional[str] = None,
        related_crn: Optional[str] = None,
        rules: Optional[Sequence[IsLbListenerPolicyRuleArgs]] = None,
        target: Optional[IsLbListenerPolicyTargetArgs] = None,
        target_http_status_code: Optional[float] = None,
        target_https_redirect_listener: Optional[str] = None,
        target_https_redirect_status_code: Optional[float] = None,
        target_https_redirect_uri: Optional[str] = None,
        target_id: Optional[str] = None,
        target_url: Optional[str] = None,
        timeouts: Optional[IsLbListenerPolicyTimeoutsArgs] = None) -> IsLbListenerPolicy
func GetIsLbListenerPolicy(ctx *Context, name string, id IDInput, state *IsLbListenerPolicyState, opts ...ResourceOption) (*IsLbListenerPolicy, error)
public static IsLbListenerPolicy Get(string name, Input<string> id, IsLbListenerPolicyState? state, CustomResourceOptions? opts = null)
public static IsLbListenerPolicy get(String name, Output<String> id, IsLbListenerPolicyState state, CustomResourceOptions options)
resources:  _:    type: ibm:IsLbListenerPolicy    get:      id: ${id}
name This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
name This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
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:
Action string
The action that you want to specify for your policy. Supported values are forward, redirect, reject, and https_redirect.
IsLbListenerPolicyId string
(String) The ID of the load balancer listener policy. The ID is composed of <lb_ID>/<listener_ID>/<policy_ID>.
Lb string
The ID of the load balancer for which you want to create a load balancer listener policy.
Listener string
The ID of the load balancer listener.
Name string
The name for the load balancer policy. Names must be unique within a load balancer listener.
PolicyId string
(String) The ID of the load balancer listener policy.
Priority double
The priority of the load balancer policy. Low values indicate a high priority. The value must be between 1 and 10.Yes.
ProvisioningStatus string
Listner Policy status
RelatedCrn string
The crn of the LB resource
Rules List<IsLbListenerPolicyRule>

A list of rules that you want to apply to your load balancer policy. Note that rules can be created only. You cannot update the rules for a load balancer policy.

Nested scheme for rules:

Target IsLbListenerPolicyTarget
If action is forward, the response is a LoadBalancerPoolReference- If action is redirect, the response is a LoadBalancerListenerPolicyRedirectURL- If action is https_redirect, the response is a LoadBalancerListenerHTTPSRedirect. Nested schema for target:
TargetHttpStatusCode double
When action is set to redirect, specify the HTTP response code that must be returned in the redirect response. Supported values are 301, 302, 303, 307, and 308.

Deprecated: Deprecated

TargetHttpsRedirectListener string
When action is set to https_redirect, specify the ID of the listener that will be set as http redirect target.

Deprecated: Deprecated

TargetHttpsRedirectStatusCode double
When action is set to https_redirect, specify the HTTP status code to be returned in the redirect response. Supported values are 301, 302, 303, 307, 308.

Deprecated: Deprecated

TargetHttpsRedirectUri string

When action is set to https_redirect, specify the target URI where traffic will be redirected.

Note: target_id, target_http_status_code, target_url, target_https_redirect_listener, target_https_redirect_status_code, target_https_redirect_uri are deprecated and will be removed soon. Please use target instead.

Deprecated: Deprecated

TargetId string
When action is set to forward, specify the ID of the load balancer pool that the load balancer forwards network traffic to.

Deprecated: Deprecated

TargetUrl string
When action is set to redirect, specify the URL that is used in the redirect response.

Deprecated: Deprecated

Timeouts IsLbListenerPolicyTimeouts
Action string
The action that you want to specify for your policy. Supported values are forward, redirect, reject, and https_redirect.
IsLbListenerPolicyId string
(String) The ID of the load balancer listener policy. The ID is composed of <lb_ID>/<listener_ID>/<policy_ID>.
Lb string
The ID of the load balancer for which you want to create a load balancer listener policy.
Listener string
The ID of the load balancer listener.
Name string
The name for the load balancer policy. Names must be unique within a load balancer listener.
PolicyId string
(String) The ID of the load balancer listener policy.
Priority float64
The priority of the load balancer policy. Low values indicate a high priority. The value must be between 1 and 10.Yes.
ProvisioningStatus string
Listner Policy status
RelatedCrn string
The crn of the LB resource
Rules []IsLbListenerPolicyRuleTypeArgs

A list of rules that you want to apply to your load balancer policy. Note that rules can be created only. You cannot update the rules for a load balancer policy.

Nested scheme for rules:

Target IsLbListenerPolicyTargetArgs
If action is forward, the response is a LoadBalancerPoolReference- If action is redirect, the response is a LoadBalancerListenerPolicyRedirectURL- If action is https_redirect, the response is a LoadBalancerListenerHTTPSRedirect. Nested schema for target:
TargetHttpStatusCode float64
When action is set to redirect, specify the HTTP response code that must be returned in the redirect response. Supported values are 301, 302, 303, 307, and 308.

Deprecated: Deprecated

TargetHttpsRedirectListener string
When action is set to https_redirect, specify the ID of the listener that will be set as http redirect target.

Deprecated: Deprecated

TargetHttpsRedirectStatusCode float64
When action is set to https_redirect, specify the HTTP status code to be returned in the redirect response. Supported values are 301, 302, 303, 307, 308.

Deprecated: Deprecated

TargetHttpsRedirectUri string

When action is set to https_redirect, specify the target URI where traffic will be redirected.

Note: target_id, target_http_status_code, target_url, target_https_redirect_listener, target_https_redirect_status_code, target_https_redirect_uri are deprecated and will be removed soon. Please use target instead.

Deprecated: Deprecated

TargetId string
When action is set to forward, specify the ID of the load balancer pool that the load balancer forwards network traffic to.

Deprecated: Deprecated

TargetUrl string
When action is set to redirect, specify the URL that is used in the redirect response.

Deprecated: Deprecated

Timeouts IsLbListenerPolicyTimeoutsArgs
action String
The action that you want to specify for your policy. Supported values are forward, redirect, reject, and https_redirect.
isLbListenerPolicyId String
(String) The ID of the load balancer listener policy. The ID is composed of <lb_ID>/<listener_ID>/<policy_ID>.
lb String
The ID of the load balancer for which you want to create a load balancer listener policy.
listener String
The ID of the load balancer listener.
name String
The name for the load balancer policy. Names must be unique within a load balancer listener.
policyId String
(String) The ID of the load balancer listener policy.
priority Double
The priority of the load balancer policy. Low values indicate a high priority. The value must be between 1 and 10.Yes.
provisioningStatus String
Listner Policy status
relatedCrn String
The crn of the LB resource
rules List<IsLbListenerPolicyRule>

A list of rules that you want to apply to your load balancer policy. Note that rules can be created only. You cannot update the rules for a load balancer policy.

Nested scheme for rules:

target IsLbListenerPolicyTarget
If action is forward, the response is a LoadBalancerPoolReference- If action is redirect, the response is a LoadBalancerListenerPolicyRedirectURL- If action is https_redirect, the response is a LoadBalancerListenerHTTPSRedirect. Nested schema for target:
targetHttpStatusCode Double
When action is set to redirect, specify the HTTP response code that must be returned in the redirect response. Supported values are 301, 302, 303, 307, and 308.

Deprecated: Deprecated

targetHttpsRedirectListener String
When action is set to https_redirect, specify the ID of the listener that will be set as http redirect target.

Deprecated: Deprecated

targetHttpsRedirectStatusCode Double
When action is set to https_redirect, specify the HTTP status code to be returned in the redirect response. Supported values are 301, 302, 303, 307, 308.

Deprecated: Deprecated

targetHttpsRedirectUri String

When action is set to https_redirect, specify the target URI where traffic will be redirected.

Note: target_id, target_http_status_code, target_url, target_https_redirect_listener, target_https_redirect_status_code, target_https_redirect_uri are deprecated and will be removed soon. Please use target instead.

Deprecated: Deprecated

targetId String
When action is set to forward, specify the ID of the load balancer pool that the load balancer forwards network traffic to.

Deprecated: Deprecated

targetUrl String
When action is set to redirect, specify the URL that is used in the redirect response.

Deprecated: Deprecated

timeouts IsLbListenerPolicyTimeouts
action string
The action that you want to specify for your policy. Supported values are forward, redirect, reject, and https_redirect.
isLbListenerPolicyId string
(String) The ID of the load balancer listener policy. The ID is composed of <lb_ID>/<listener_ID>/<policy_ID>.
lb string
The ID of the load balancer for which you want to create a load balancer listener policy.
listener string
The ID of the load balancer listener.
name string
The name for the load balancer policy. Names must be unique within a load balancer listener.
policyId string
(String) The ID of the load balancer listener policy.
priority number
The priority of the load balancer policy. Low values indicate a high priority. The value must be between 1 and 10.Yes.
provisioningStatus string
Listner Policy status
relatedCrn string
The crn of the LB resource
rules IsLbListenerPolicyRule[]

A list of rules that you want to apply to your load balancer policy. Note that rules can be created only. You cannot update the rules for a load balancer policy.

Nested scheme for rules:

target IsLbListenerPolicyTarget
If action is forward, the response is a LoadBalancerPoolReference- If action is redirect, the response is a LoadBalancerListenerPolicyRedirectURL- If action is https_redirect, the response is a LoadBalancerListenerHTTPSRedirect. Nested schema for target:
targetHttpStatusCode number
When action is set to redirect, specify the HTTP response code that must be returned in the redirect response. Supported values are 301, 302, 303, 307, and 308.

Deprecated: Deprecated

targetHttpsRedirectListener string
When action is set to https_redirect, specify the ID of the listener that will be set as http redirect target.

Deprecated: Deprecated

targetHttpsRedirectStatusCode number
When action is set to https_redirect, specify the HTTP status code to be returned in the redirect response. Supported values are 301, 302, 303, 307, 308.

Deprecated: Deprecated

targetHttpsRedirectUri string

When action is set to https_redirect, specify the target URI where traffic will be redirected.

Note: target_id, target_http_status_code, target_url, target_https_redirect_listener, target_https_redirect_status_code, target_https_redirect_uri are deprecated and will be removed soon. Please use target instead.

Deprecated: Deprecated

targetId string
When action is set to forward, specify the ID of the load balancer pool that the load balancer forwards network traffic to.

Deprecated: Deprecated

targetUrl string
When action is set to redirect, specify the URL that is used in the redirect response.

Deprecated: Deprecated

timeouts IsLbListenerPolicyTimeouts
action str
The action that you want to specify for your policy. Supported values are forward, redirect, reject, and https_redirect.
is_lb_listener_policy_id str
(String) The ID of the load balancer listener policy. The ID is composed of <lb_ID>/<listener_ID>/<policy_ID>.
lb str
The ID of the load balancer for which you want to create a load balancer listener policy.
listener str
The ID of the load balancer listener.
name str
The name for the load balancer policy. Names must be unique within a load balancer listener.
policy_id str
(String) The ID of the load balancer listener policy.
priority float
The priority of the load balancer policy. Low values indicate a high priority. The value must be between 1 and 10.Yes.
provisioning_status str
Listner Policy status
related_crn str
The crn of the LB resource
rules Sequence[IsLbListenerPolicyRuleArgs]

A list of rules that you want to apply to your load balancer policy. Note that rules can be created only. You cannot update the rules for a load balancer policy.

Nested scheme for rules:

target IsLbListenerPolicyTargetArgs
If action is forward, the response is a LoadBalancerPoolReference- If action is redirect, the response is a LoadBalancerListenerPolicyRedirectURL- If action is https_redirect, the response is a LoadBalancerListenerHTTPSRedirect. Nested schema for target:
target_http_status_code float
When action is set to redirect, specify the HTTP response code that must be returned in the redirect response. Supported values are 301, 302, 303, 307, and 308.

Deprecated: Deprecated

target_https_redirect_listener str
When action is set to https_redirect, specify the ID of the listener that will be set as http redirect target.

Deprecated: Deprecated

target_https_redirect_status_code float
When action is set to https_redirect, specify the HTTP status code to be returned in the redirect response. Supported values are 301, 302, 303, 307, 308.

Deprecated: Deprecated

target_https_redirect_uri str

When action is set to https_redirect, specify the target URI where traffic will be redirected.

Note: target_id, target_http_status_code, target_url, target_https_redirect_listener, target_https_redirect_status_code, target_https_redirect_uri are deprecated and will be removed soon. Please use target instead.

Deprecated: Deprecated

target_id str
When action is set to forward, specify the ID of the load balancer pool that the load balancer forwards network traffic to.

Deprecated: Deprecated

target_url str
When action is set to redirect, specify the URL that is used in the redirect response.

Deprecated: Deprecated

timeouts IsLbListenerPolicyTimeoutsArgs
action String
The action that you want to specify for your policy. Supported values are forward, redirect, reject, and https_redirect.
isLbListenerPolicyId String
(String) The ID of the load balancer listener policy. The ID is composed of <lb_ID>/<listener_ID>/<policy_ID>.
lb String
The ID of the load balancer for which you want to create a load balancer listener policy.
listener String
The ID of the load balancer listener.
name String
The name for the load balancer policy. Names must be unique within a load balancer listener.
policyId String
(String) The ID of the load balancer listener policy.
priority Number
The priority of the load balancer policy. Low values indicate a high priority. The value must be between 1 and 10.Yes.
provisioningStatus String
Listner Policy status
relatedCrn String
The crn of the LB resource
rules List<Property Map>

A list of rules that you want to apply to your load balancer policy. Note that rules can be created only. You cannot update the rules for a load balancer policy.

Nested scheme for rules:

target Property Map
If action is forward, the response is a LoadBalancerPoolReference- If action is redirect, the response is a LoadBalancerListenerPolicyRedirectURL- If action is https_redirect, the response is a LoadBalancerListenerHTTPSRedirect. Nested schema for target:
targetHttpStatusCode Number
When action is set to redirect, specify the HTTP response code that must be returned in the redirect response. Supported values are 301, 302, 303, 307, and 308.

Deprecated: Deprecated

targetHttpsRedirectListener String
When action is set to https_redirect, specify the ID of the listener that will be set as http redirect target.

Deprecated: Deprecated

targetHttpsRedirectStatusCode Number
When action is set to https_redirect, specify the HTTP status code to be returned in the redirect response. Supported values are 301, 302, 303, 307, 308.

Deprecated: Deprecated

targetHttpsRedirectUri String

When action is set to https_redirect, specify the target URI where traffic will be redirected.

Note: target_id, target_http_status_code, target_url, target_https_redirect_listener, target_https_redirect_status_code, target_https_redirect_uri are deprecated and will be removed soon. Please use target instead.

Deprecated: Deprecated

targetId String
When action is set to forward, specify the ID of the load balancer pool that the load balancer forwards network traffic to.

Deprecated: Deprecated

targetUrl String
When action is set to redirect, specify the URL that is used in the redirect response.

Deprecated: Deprecated

timeouts Property Map

Supporting Types

IsLbListenerPolicyRule
, IsLbListenerPolicyRuleArgs

Condition This property is required. string
The condition that you want to apply to your rule. Supported values are contains, equals, and matches_regex.
Type This property is required. string
The data type where you want to apply the rule condition. Supported values are header, hostname, and path.
Value This property is required. string
The value that must be found in the HTTP header, hostname or path to apply the load balancer listener rule. The value that you define can be between 1 and 128 characters long.
Field string
If you selected header as the data type where you want to apply the rule condition, enter the name of the HTTP header that you want to check. The name of the header can be between 1 and 128 characters long.
RuleId string
Rule ID
Condition This property is required. string
The condition that you want to apply to your rule. Supported values are contains, equals, and matches_regex.
Type This property is required. string
The data type where you want to apply the rule condition. Supported values are header, hostname, and path.
Value This property is required. string
The value that must be found in the HTTP header, hostname or path to apply the load balancer listener rule. The value that you define can be between 1 and 128 characters long.
Field string
If you selected header as the data type where you want to apply the rule condition, enter the name of the HTTP header that you want to check. The name of the header can be between 1 and 128 characters long.
RuleId string
Rule ID
condition This property is required. String
The condition that you want to apply to your rule. Supported values are contains, equals, and matches_regex.
type This property is required. String
The data type where you want to apply the rule condition. Supported values are header, hostname, and path.
value This property is required. String
The value that must be found in the HTTP header, hostname or path to apply the load balancer listener rule. The value that you define can be between 1 and 128 characters long.
field String
If you selected header as the data type where you want to apply the rule condition, enter the name of the HTTP header that you want to check. The name of the header can be between 1 and 128 characters long.
ruleId String
Rule ID
condition This property is required. string
The condition that you want to apply to your rule. Supported values are contains, equals, and matches_regex.
type This property is required. string
The data type where you want to apply the rule condition. Supported values are header, hostname, and path.
value This property is required. string
The value that must be found in the HTTP header, hostname or path to apply the load balancer listener rule. The value that you define can be between 1 and 128 characters long.
field string
If you selected header as the data type where you want to apply the rule condition, enter the name of the HTTP header that you want to check. The name of the header can be between 1 and 128 characters long.
ruleId string
Rule ID
condition This property is required. str
The condition that you want to apply to your rule. Supported values are contains, equals, and matches_regex.
type This property is required. str
The data type where you want to apply the rule condition. Supported values are header, hostname, and path.
value This property is required. str
The value that must be found in the HTTP header, hostname or path to apply the load balancer listener rule. The value that you define can be between 1 and 128 characters long.
field str
If you selected header as the data type where you want to apply the rule condition, enter the name of the HTTP header that you want to check. The name of the header can be between 1 and 128 characters long.
rule_id str
Rule ID
condition This property is required. String
The condition that you want to apply to your rule. Supported values are contains, equals, and matches_regex.
type This property is required. String
The data type where you want to apply the rule condition. Supported values are header, hostname, and path.
value This property is required. String
The value that must be found in the HTTP header, hostname or path to apply the load balancer listener rule. The value that you define can be between 1 and 128 characters long.
field String
If you selected header as the data type where you want to apply the rule condition, enter the name of the HTTP header that you want to check. The name of the header can be between 1 and 128 characters long.
ruleId String
Rule ID

IsLbListenerPolicyTarget
, IsLbListenerPolicyTargetArgs

Deleteds List<IsLbListenerPolicyTargetDeleted>
If present, this property indicates the referenced resource has been deleted, and providessome supplementary information. Nested schema for deleted:
Href string
The pool's canonical URL.
HttpStatusCode double
The HTTP status code for this redirect. Allowable values are: 301, 302, 303, 307, 308.
Id string
The unique identifier for this load balancer pool.
Listener IsLbListenerPolicyTargetListener
Nested schema for listener:
Name string
The name for this load balancer pool. The name is unique across all pools for the load balancer.
Uri string
The redirect relative target URI.
Url string

The redirect target URL. The URL supports RFC 6570 level 1 expressions for the following variables which expand to values from the originally requested URL (or the indicated defaults if the request did not include them):

• protocol • host • port (default: 80 for HTTP requests, 443 for HTTPS requests) • path (default: '/') • query (default: '')

Note: When action is forward, target.id should specify which pool the load balancer forwards the traffic to. When action is redirect, target.url should specify the url and target.http_status_code to specify the code used in the redirect response. When action is https_redirect, target.listener.id should specify the ID of the listener, target.http_status_code to specify the code used in the redirect response and target.uri to specify the target URI where traffic will be redirected. Network load balancer does not support ibm.IsLbListenerPolicy.

Deleteds []IsLbListenerPolicyTargetDeleted
If present, this property indicates the referenced resource has been deleted, and providessome supplementary information. Nested schema for deleted:
Href string
The pool's canonical URL.
HttpStatusCode float64
The HTTP status code for this redirect. Allowable values are: 301, 302, 303, 307, 308.
Id string
The unique identifier for this load balancer pool.
Listener IsLbListenerPolicyTargetListener
Nested schema for listener:
Name string
The name for this load balancer pool. The name is unique across all pools for the load balancer.
Uri string
The redirect relative target URI.
Url string

The redirect target URL. The URL supports RFC 6570 level 1 expressions for the following variables which expand to values from the originally requested URL (or the indicated defaults if the request did not include them):

• protocol • host • port (default: 80 for HTTP requests, 443 for HTTPS requests) • path (default: '/') • query (default: '')

Note: When action is forward, target.id should specify which pool the load balancer forwards the traffic to. When action is redirect, target.url should specify the url and target.http_status_code to specify the code used in the redirect response. When action is https_redirect, target.listener.id should specify the ID of the listener, target.http_status_code to specify the code used in the redirect response and target.uri to specify the target URI where traffic will be redirected. Network load balancer does not support ibm.IsLbListenerPolicy.

deleteds List<IsLbListenerPolicyTargetDeleted>
If present, this property indicates the referenced resource has been deleted, and providessome supplementary information. Nested schema for deleted:
href String
The pool's canonical URL.
httpStatusCode Double
The HTTP status code for this redirect. Allowable values are: 301, 302, 303, 307, 308.
id String
The unique identifier for this load balancer pool.
listener IsLbListenerPolicyTargetListener
Nested schema for listener:
name String
The name for this load balancer pool. The name is unique across all pools for the load balancer.
uri String
The redirect relative target URI.
url String

The redirect target URL. The URL supports RFC 6570 level 1 expressions for the following variables which expand to values from the originally requested URL (or the indicated defaults if the request did not include them):

• protocol • host • port (default: 80 for HTTP requests, 443 for HTTPS requests) • path (default: '/') • query (default: '')

Note: When action is forward, target.id should specify which pool the load balancer forwards the traffic to. When action is redirect, target.url should specify the url and target.http_status_code to specify the code used in the redirect response. When action is https_redirect, target.listener.id should specify the ID of the listener, target.http_status_code to specify the code used in the redirect response and target.uri to specify the target URI where traffic will be redirected. Network load balancer does not support ibm.IsLbListenerPolicy.

deleteds IsLbListenerPolicyTargetDeleted[]
If present, this property indicates the referenced resource has been deleted, and providessome supplementary information. Nested schema for deleted:
href string
The pool's canonical URL.
httpStatusCode number
The HTTP status code for this redirect. Allowable values are: 301, 302, 303, 307, 308.
id string
The unique identifier for this load balancer pool.
listener IsLbListenerPolicyTargetListener
Nested schema for listener:
name string
The name for this load balancer pool. The name is unique across all pools for the load balancer.
uri string
The redirect relative target URI.
url string

The redirect target URL. The URL supports RFC 6570 level 1 expressions for the following variables which expand to values from the originally requested URL (or the indicated defaults if the request did not include them):

• protocol • host • port (default: 80 for HTTP requests, 443 for HTTPS requests) • path (default: '/') • query (default: '')

Note: When action is forward, target.id should specify which pool the load balancer forwards the traffic to. When action is redirect, target.url should specify the url and target.http_status_code to specify the code used in the redirect response. When action is https_redirect, target.listener.id should specify the ID of the listener, target.http_status_code to specify the code used in the redirect response and target.uri to specify the target URI where traffic will be redirected. Network load balancer does not support ibm.IsLbListenerPolicy.

deleteds Sequence[IsLbListenerPolicyTargetDeleted]
If present, this property indicates the referenced resource has been deleted, and providessome supplementary information. Nested schema for deleted:
href str
The pool's canonical URL.
http_status_code float
The HTTP status code for this redirect. Allowable values are: 301, 302, 303, 307, 308.
id str
The unique identifier for this load balancer pool.
listener IsLbListenerPolicyTargetListener
Nested schema for listener:
name str
The name for this load balancer pool. The name is unique across all pools for the load balancer.
uri str
The redirect relative target URI.
url str

The redirect target URL. The URL supports RFC 6570 level 1 expressions for the following variables which expand to values from the originally requested URL (or the indicated defaults if the request did not include them):

• protocol • host • port (default: 80 for HTTP requests, 443 for HTTPS requests) • path (default: '/') • query (default: '')

Note: When action is forward, target.id should specify which pool the load balancer forwards the traffic to. When action is redirect, target.url should specify the url and target.http_status_code to specify the code used in the redirect response. When action is https_redirect, target.listener.id should specify the ID of the listener, target.http_status_code to specify the code used in the redirect response and target.uri to specify the target URI where traffic will be redirected. Network load balancer does not support ibm.IsLbListenerPolicy.

deleteds List<Property Map>
If present, this property indicates the referenced resource has been deleted, and providessome supplementary information. Nested schema for deleted:
href String
The pool's canonical URL.
httpStatusCode Number
The HTTP status code for this redirect. Allowable values are: 301, 302, 303, 307, 308.
id String
The unique identifier for this load balancer pool.
listener Property Map
Nested schema for listener:
name String
The name for this load balancer pool. The name is unique across all pools for the load balancer.
uri String
The redirect relative target URI.
url String

The redirect target URL. The URL supports RFC 6570 level 1 expressions for the following variables which expand to values from the originally requested URL (or the indicated defaults if the request did not include them):

• protocol • host • port (default: 80 for HTTP requests, 443 for HTTPS requests) • path (default: '/') • query (default: '')

Note: When action is forward, target.id should specify which pool the load balancer forwards the traffic to. When action is redirect, target.url should specify the url and target.http_status_code to specify the code used in the redirect response. When action is https_redirect, target.listener.id should specify the ID of the listener, target.http_status_code to specify the code used in the redirect response and target.uri to specify the target URI where traffic will be redirected. Network load balancer does not support ibm.IsLbListenerPolicy.

IsLbListenerPolicyTargetDeleted
, IsLbListenerPolicyTargetDeletedArgs

MoreInfo This property is required. string
Link to documentation about deleted resources.
MoreInfo This property is required. string
Link to documentation about deleted resources.
moreInfo This property is required. String
Link to documentation about deleted resources.
moreInfo This property is required. string
Link to documentation about deleted resources.
more_info This property is required. str
Link to documentation about deleted resources.
moreInfo This property is required. String
Link to documentation about deleted resources.

IsLbListenerPolicyTargetListener
, IsLbListenerPolicyTargetListenerArgs

Id This property is required. string
The unique identifier for this load balancer listener.
Deleteds List<IsLbListenerPolicyTargetListenerDeleted>
If present, this property indicates the referenced resource has been deleted, and providessome supplementary information. Nested schema for deleted:
Href string
The listener's canonical URL.
Id This property is required. string
The unique identifier for this load balancer listener.
Deleteds []IsLbListenerPolicyTargetListenerDeleted
If present, this property indicates the referenced resource has been deleted, and providessome supplementary information. Nested schema for deleted:
Href string
The listener's canonical URL.
id This property is required. String
The unique identifier for this load balancer listener.
deleteds List<IsLbListenerPolicyTargetListenerDeleted>
If present, this property indicates the referenced resource has been deleted, and providessome supplementary information. Nested schema for deleted:
href String
The listener's canonical URL.
id This property is required. string
The unique identifier for this load balancer listener.
deleteds IsLbListenerPolicyTargetListenerDeleted[]
If present, this property indicates the referenced resource has been deleted, and providessome supplementary information. Nested schema for deleted:
href string
The listener's canonical URL.
id This property is required. str
The unique identifier for this load balancer listener.
deleteds Sequence[IsLbListenerPolicyTargetListenerDeleted]
If present, this property indicates the referenced resource has been deleted, and providessome supplementary information. Nested schema for deleted:
href str
The listener's canonical URL.
id This property is required. String
The unique identifier for this load balancer listener.
deleteds List<Property Map>
If present, this property indicates the referenced resource has been deleted, and providessome supplementary information. Nested schema for deleted:
href String
The listener's canonical URL.

IsLbListenerPolicyTargetListenerDeleted
, IsLbListenerPolicyTargetListenerDeletedArgs

MoreInfo This property is required. string
Link to documentation about deleted resources.
MoreInfo This property is required. string
Link to documentation about deleted resources.
moreInfo This property is required. String
Link to documentation about deleted resources.
moreInfo This property is required. string
Link to documentation about deleted resources.
more_info This property is required. str
Link to documentation about deleted resources.
moreInfo This property is required. String
Link to documentation about deleted resources.

IsLbListenerPolicyTimeouts
, IsLbListenerPolicyTimeoutsArgs

Create string
Delete string
Update string
Create string
Delete string
Update string
create String
delete String
update String
create string
delete string
update string
create str
delete str
update str
create String
delete String
update String

Import

The resource can be imported by using the ID. The ID is composed of <lb_ID>/<listener_ID>/<policy_ID>.

Synatx

$ pulumi import ibm:index/isLbListenerPolicy:IsLbListenerPolicy example <lb_ID>/<listener_ID>/<policy_ID>
Copy

Example

$ pulumi import ibm:index/isLbListenerPolicy:IsLbListenerPolicy example c1e3d5d3-8836-4328-b473-a90e0c9ba941/3ea13dc7-25b4-4c62-8cc7-0f7e092e7a8f/2161a3fb-123c-4a33-9a3d-b3154ef42009
Copy

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

Package Details

Repository
ibm ibm-cloud/terraform-provider-ibm
License
Notes
This Pulumi package is based on the ibm Terraform Provider.
ibm 1.77.1 published on Monday, Apr 14, 2025 by ibm-cloud
ibm-cloud/terraform-provider-ibm