1. Packages
  2. Ibm Provider
  3. API Docs
  4. LbVpx
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud

ibm.LbVpx

Explore with Pulumi AI

ibm logo
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud

    Create, delete, and update a VPX load balancers.

    Note

    IBM VPX load balancers consist of Citrix NetscalerVPX devices (virtual), which are currently priced on a per-month basis. Use caution when creating the resource because the cost for an entire month is incurred immediately upon creation. For more information, about pricing, see the estimating your cost.

    You can also use the following REST URL to get a listing of VPX choices along with version numbers, speed, and plan type:

    https://<userName>:<apiKey>@api.softlayer.com/rest/v3/SoftLayer_Product_Package/192/getItems.json?objectMask=id;capacity;description;units;keyName;prices.id;prices.categories.id;prices.categories.name
    

    Example Usage

    Review the IBM Cloud Classic Infrastructure documentation for more information.

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const testVpx = new ibm.LbVpx("testVpx", {
        datacenter: "dal06",
        ipCount: 2,
        plan: "Standard",
        privateSubnet: "10.107.180.0/26",
        privateVlanId: 1540786,
        publicSubnet: "23.246.226.248/29",
        publicVlanId: 1251234,
        speed: 10,
        version: "10.1",
    });
    
    import pulumi
    import pulumi_ibm as ibm
    
    test_vpx = ibm.LbVpx("testVpx",
        datacenter="dal06",
        ip_count=2,
        plan="Standard",
        private_subnet="10.107.180.0/26",
        private_vlan_id=1540786,
        public_subnet="23.246.226.248/29",
        public_vlan_id=1251234,
        speed=10,
        version="10.1")
    
    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 {
    		_, err := ibm.NewLbVpx(ctx, "testVpx", &ibm.LbVpxArgs{
    			Datacenter:    pulumi.String("dal06"),
    			IpCount:       pulumi.Float64(2),
    			Plan:          pulumi.String("Standard"),
    			PrivateSubnet: pulumi.String("10.107.180.0/26"),
    			PrivateVlanId: pulumi.Float64(1540786),
    			PublicSubnet:  pulumi.String("23.246.226.248/29"),
    			PublicVlanId:  pulumi.Float64(1251234),
    			Speed:         pulumi.Float64(10),
    			Version:       pulumi.String("10.1"),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ibm = Pulumi.Ibm;
    
    return await Deployment.RunAsync(() => 
    {
        var testVpx = new Ibm.LbVpx("testVpx", new()
        {
            Datacenter = "dal06",
            IpCount = 2,
            Plan = "Standard",
            PrivateSubnet = "10.107.180.0/26",
            PrivateVlanId = 1540786,
            PublicSubnet = "23.246.226.248/29",
            PublicVlanId = 1251234,
            Speed = 10,
            Version = "10.1",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.LbVpx;
    import com.pulumi.ibm.LbVpxArgs;
    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 testVpx = new LbVpx("testVpx", LbVpxArgs.builder()
                .datacenter("dal06")
                .ipCount(2)
                .plan("Standard")
                .privateSubnet("10.107.180.0/26")
                .privateVlanId(1540786)
                .publicSubnet("23.246.226.248/29")
                .publicVlanId(1251234)
                .speed(10)
                .version("10.1")
                .build());
    
        }
    }
    
    resources:
      testVpx:
        type: ibm:LbVpx
        properties:
          datacenter: dal06
          ipCount: 2
          plan: Standard
          privateSubnet: 10.107.180.0/26
          privateVlanId: 1.540786e+06
          publicSubnet: 23.246.226.248/29
          publicVlanId: 1.251234e+06
          speed: 10
          version: '10.1'
    

    Argument reference

    Review the argument references that you can specify for your resource.

    • datacenter- (Required, Forces new resource, String) The data center in which you want to provision the VPX load balancer. You can find accepted values in the data center documentation.
    • ip_count - (Required, Forces new resource, Integer) The number of static public IP addresses assigned to the VPX load balancer. Accepted values are 1,2, 4, 8, and 16.
    • plan- (Required, Forces new resource, String) The VPX load balancer plan. Accepted values are Standard and Platinum.
    • public_vlan_id - (Optional, Forces new resource, Integer) The public VLAN ID that is used for the public network interface of the VPX load balancer. You can find accepted values in the VLAN network by clicking the VLAN that you want to use and noting the ID in the resulting URL. You can also refer to a VLAN name by using a data source.
    • private_vlan_id - (Optional, Forces new resource, Integer) The private VLAN ID that is used for the private network interface of the VPX load balancer. You can find accepted values in the VLAN network by clicking the VLAN that you want to use and noting the ID in the resulting URL. You can also refer to a VLAN name by using a data source.
    • public_subnet - (Optional, Forces new resource, String)The public subnet that is used for the public network interface of the VPX load balancer. Accepted values are primary public networks. You can find accepted values in the subnet documentation.
    • private_subnet- (Optiona, Forces new resource, String) Public subnet that is used for the private network interface of the VPX load balancer. Accepted values are primary private networks. You can find accepted values in the subnet documentation.
    • speed - (Required, Forces new resource, Integer) The speed, expressed in Mbps. Accepted values are 10, 200, and 1000.
    • tags- (Optional, Array of Strings) Tags associated with the VPX load balancer instance. Note Tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.
    • version - (Required, Forces new resource, String)The VPX load balancer version. Accepted values are 10.1, 10.5, 11.0, 11.1 and 12.1.

    Create LbVpx Resource

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

    Constructor syntax

    new LbVpx(name: string, args: LbVpxArgs, opts?: CustomResourceOptions);
    @overload
    def LbVpx(resource_name: str,
              args: LbVpxArgs,
              opts: Optional[ResourceOptions] = None)
    
    @overload
    def LbVpx(resource_name: str,
              opts: Optional[ResourceOptions] = None,
              datacenter: Optional[str] = None,
              ip_count: Optional[float] = None,
              plan: Optional[str] = None,
              speed: Optional[float] = None,
              version: Optional[str] = None,
              lb_vpx_id: Optional[str] = None,
              private_subnet: Optional[str] = None,
              private_vlan_id: Optional[float] = None,
              public_subnet: Optional[str] = None,
              public_vlan_id: Optional[float] = None,
              tags: Optional[Sequence[str]] = None)
    func NewLbVpx(ctx *Context, name string, args LbVpxArgs, opts ...ResourceOption) (*LbVpx, error)
    public LbVpx(string name, LbVpxArgs args, CustomResourceOptions? opts = null)
    public LbVpx(String name, LbVpxArgs args)
    public LbVpx(String name, LbVpxArgs args, CustomResourceOptions options)
    
    type: ibm:LbVpx
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args LbVpxArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args LbVpxArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args LbVpxArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args LbVpxArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args LbVpxArgs
    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 lbVpxResource = new Ibm.LbVpx("lbVpxResource", new()
    {
        Datacenter = "string",
        IpCount = 0,
        Plan = "string",
        Speed = 0,
        Version = "string",
        LbVpxId = "string",
        PrivateSubnet = "string",
        PrivateVlanId = 0,
        PublicSubnet = "string",
        PublicVlanId = 0,
        Tags = new[]
        {
            "string",
        },
    });
    
    example, err := ibm.NewLbVpx(ctx, "lbVpxResource", &ibm.LbVpxArgs{
    	Datacenter:    pulumi.String("string"),
    	IpCount:       pulumi.Float64(0),
    	Plan:          pulumi.String("string"),
    	Speed:         pulumi.Float64(0),
    	Version:       pulumi.String("string"),
    	LbVpxId:       pulumi.String("string"),
    	PrivateSubnet: pulumi.String("string"),
    	PrivateVlanId: pulumi.Float64(0),
    	PublicSubnet:  pulumi.String("string"),
    	PublicVlanId:  pulumi.Float64(0),
    	Tags: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    })
    
    var lbVpxResource = new LbVpx("lbVpxResource", LbVpxArgs.builder()
        .datacenter("string")
        .ipCount(0)
        .plan("string")
        .speed(0)
        .version("string")
        .lbVpxId("string")
        .privateSubnet("string")
        .privateVlanId(0)
        .publicSubnet("string")
        .publicVlanId(0)
        .tags("string")
        .build());
    
    lb_vpx_resource = ibm.LbVpx("lbVpxResource",
        datacenter="string",
        ip_count=0,
        plan="string",
        speed=0,
        version="string",
        lb_vpx_id="string",
        private_subnet="string",
        private_vlan_id=0,
        public_subnet="string",
        public_vlan_id=0,
        tags=["string"])
    
    const lbVpxResource = new ibm.LbVpx("lbVpxResource", {
        datacenter: "string",
        ipCount: 0,
        plan: "string",
        speed: 0,
        version: "string",
        lbVpxId: "string",
        privateSubnet: "string",
        privateVlanId: 0,
        publicSubnet: "string",
        publicVlanId: 0,
        tags: ["string"],
    });
    
    type: ibm:LbVpx
    properties:
        datacenter: string
        ipCount: 0
        lbVpxId: string
        plan: string
        privateSubnet: string
        privateVlanId: 0
        publicSubnet: string
        publicVlanId: 0
        speed: 0
        tags:
            - string
        version: string
    

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

    Datacenter string
    Datacenter name
    IpCount double
    IP address count
    Plan string
    Plan info
    Speed double
    Speed value
    Version string
    version info
    LbVpxId string
    (String) The internal identifier of a VPX load balancer.
    PrivateSubnet string
    Private subnet
    PrivateVlanId double
    Private VLAN id
    PublicSubnet string
    Public subnet
    PublicVlanId double
    Piblic VLAN id
    Tags List<string>
    List of the tags
    Datacenter string
    Datacenter name
    IpCount float64
    IP address count
    Plan string
    Plan info
    Speed float64
    Speed value
    Version string
    version info
    LbVpxId string
    (String) The internal identifier of a VPX load balancer.
    PrivateSubnet string
    Private subnet
    PrivateVlanId float64
    Private VLAN id
    PublicSubnet string
    Public subnet
    PublicVlanId float64
    Piblic VLAN id
    Tags []string
    List of the tags
    datacenter String
    Datacenter name
    ipCount Double
    IP address count
    plan String
    Plan info
    speed Double
    Speed value
    version String
    version info
    lbVpxId String
    (String) The internal identifier of a VPX load balancer.
    privateSubnet String
    Private subnet
    privateVlanId Double
    Private VLAN id
    publicSubnet String
    Public subnet
    publicVlanId Double
    Piblic VLAN id
    tags List<String>
    List of the tags
    datacenter string
    Datacenter name
    ipCount number
    IP address count
    plan string
    Plan info
    speed number
    Speed value
    version string
    version info
    lbVpxId string
    (String) The internal identifier of a VPX load balancer.
    privateSubnet string
    Private subnet
    privateVlanId number
    Private VLAN id
    publicSubnet string
    Public subnet
    publicVlanId number
    Piblic VLAN id
    tags string[]
    List of the tags
    datacenter str
    Datacenter name
    ip_count float
    IP address count
    plan str
    Plan info
    speed float
    Speed value
    version str
    version info
    lb_vpx_id str
    (String) The internal identifier of a VPX load balancer.
    private_subnet str
    Private subnet
    private_vlan_id float
    Private VLAN id
    public_subnet str
    Public subnet
    public_vlan_id float
    Piblic VLAN id
    tags Sequence[str]
    List of the tags
    datacenter String
    Datacenter name
    ipCount Number
    IP address count
    plan String
    Plan info
    speed Number
    Speed value
    version String
    version info
    lbVpxId String
    (String) The internal identifier of a VPX load balancer.
    privateSubnet String
    Private subnet
    privateVlanId Number
    Private VLAN id
    publicSubnet String
    Public subnet
    publicVlanId Number
    Piblic VLAN id
    tags List<String>
    List of the tags

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    ManagementIpAddress string
    (String) The private address of the VPX console.
    Name string
    (String) The internal name of a VPX load balancer.
    Type string
    Type of the VPX
    VipPools List<string>
    (String) A list of virtual IP addresses for the VPX load balancer.
    Id string
    The provider-assigned unique ID for this managed resource.
    ManagementIpAddress string
    (String) The private address of the VPX console.
    Name string
    (String) The internal name of a VPX load balancer.
    Type string
    Type of the VPX
    VipPools []string
    (String) A list of virtual IP addresses for the VPX load balancer.
    id String
    The provider-assigned unique ID for this managed resource.
    managementIpAddress String
    (String) The private address of the VPX console.
    name String
    (String) The internal name of a VPX load balancer.
    type String
    Type of the VPX
    vipPools List<String>
    (String) A list of virtual IP addresses for the VPX load balancer.
    id string
    The provider-assigned unique ID for this managed resource.
    managementIpAddress string
    (String) The private address of the VPX console.
    name string
    (String) The internal name of a VPX load balancer.
    type string
    Type of the VPX
    vipPools string[]
    (String) A list of virtual IP addresses for the VPX load balancer.
    id str
    The provider-assigned unique ID for this managed resource.
    management_ip_address str
    (String) The private address of the VPX console.
    name str
    (String) The internal name of a VPX load balancer.
    type str
    Type of the VPX
    vip_pools Sequence[str]
    (String) A list of virtual IP addresses for the VPX load balancer.
    id String
    The provider-assigned unique ID for this managed resource.
    managementIpAddress String
    (String) The private address of the VPX console.
    name String
    (String) The internal name of a VPX load balancer.
    type String
    Type of the VPX
    vipPools List<String>
    (String) A list of virtual IP addresses for the VPX load balancer.

    Look up Existing LbVpx Resource

    Get an existing LbVpx 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?: LbVpxState, opts?: CustomResourceOptions): LbVpx
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            datacenter: Optional[str] = None,
            ip_count: Optional[float] = None,
            lb_vpx_id: Optional[str] = None,
            management_ip_address: Optional[str] = None,
            name: Optional[str] = None,
            plan: Optional[str] = None,
            private_subnet: Optional[str] = None,
            private_vlan_id: Optional[float] = None,
            public_subnet: Optional[str] = None,
            public_vlan_id: Optional[float] = None,
            speed: Optional[float] = None,
            tags: Optional[Sequence[str]] = None,
            type: Optional[str] = None,
            version: Optional[str] = None,
            vip_pools: Optional[Sequence[str]] = None) -> LbVpx
    func GetLbVpx(ctx *Context, name string, id IDInput, state *LbVpxState, opts ...ResourceOption) (*LbVpx, error)
    public static LbVpx Get(string name, Input<string> id, LbVpxState? state, CustomResourceOptions? opts = null)
    public static LbVpx get(String name, Output<String> id, LbVpxState state, CustomResourceOptions options)
    resources:  _:    type: ibm:LbVpx    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Datacenter string
    Datacenter name
    IpCount double
    IP address count
    LbVpxId string
    (String) The internal identifier of a VPX load balancer.
    ManagementIpAddress string
    (String) The private address of the VPX console.
    Name string
    (String) The internal name of a VPX load balancer.
    Plan string
    Plan info
    PrivateSubnet string
    Private subnet
    PrivateVlanId double
    Private VLAN id
    PublicSubnet string
    Public subnet
    PublicVlanId double
    Piblic VLAN id
    Speed double
    Speed value
    Tags List<string>
    List of the tags
    Type string
    Type of the VPX
    Version string
    version info
    VipPools List<string>
    (String) A list of virtual IP addresses for the VPX load balancer.
    Datacenter string
    Datacenter name
    IpCount float64
    IP address count
    LbVpxId string
    (String) The internal identifier of a VPX load balancer.
    ManagementIpAddress string
    (String) The private address of the VPX console.
    Name string
    (String) The internal name of a VPX load balancer.
    Plan string
    Plan info
    PrivateSubnet string
    Private subnet
    PrivateVlanId float64
    Private VLAN id
    PublicSubnet string
    Public subnet
    PublicVlanId float64
    Piblic VLAN id
    Speed float64
    Speed value
    Tags []string
    List of the tags
    Type string
    Type of the VPX
    Version string
    version info
    VipPools []string
    (String) A list of virtual IP addresses for the VPX load balancer.
    datacenter String
    Datacenter name
    ipCount Double
    IP address count
    lbVpxId String
    (String) The internal identifier of a VPX load balancer.
    managementIpAddress String
    (String) The private address of the VPX console.
    name String
    (String) The internal name of a VPX load balancer.
    plan String
    Plan info
    privateSubnet String
    Private subnet
    privateVlanId Double
    Private VLAN id
    publicSubnet String
    Public subnet
    publicVlanId Double
    Piblic VLAN id
    speed Double
    Speed value
    tags List<String>
    List of the tags
    type String
    Type of the VPX
    version String
    version info
    vipPools List<String>
    (String) A list of virtual IP addresses for the VPX load balancer.
    datacenter string
    Datacenter name
    ipCount number
    IP address count
    lbVpxId string
    (String) The internal identifier of a VPX load balancer.
    managementIpAddress string
    (String) The private address of the VPX console.
    name string
    (String) The internal name of a VPX load balancer.
    plan string
    Plan info
    privateSubnet string
    Private subnet
    privateVlanId number
    Private VLAN id
    publicSubnet string
    Public subnet
    publicVlanId number
    Piblic VLAN id
    speed number
    Speed value
    tags string[]
    List of the tags
    type string
    Type of the VPX
    version string
    version info
    vipPools string[]
    (String) A list of virtual IP addresses for the VPX load balancer.
    datacenter str
    Datacenter name
    ip_count float
    IP address count
    lb_vpx_id str
    (String) The internal identifier of a VPX load balancer.
    management_ip_address str
    (String) The private address of the VPX console.
    name str
    (String) The internal name of a VPX load balancer.
    plan str
    Plan info
    private_subnet str
    Private subnet
    private_vlan_id float
    Private VLAN id
    public_subnet str
    Public subnet
    public_vlan_id float
    Piblic VLAN id
    speed float
    Speed value
    tags Sequence[str]
    List of the tags
    type str
    Type of the VPX
    version str
    version info
    vip_pools Sequence[str]
    (String) A list of virtual IP addresses for the VPX load balancer.
    datacenter String
    Datacenter name
    ipCount Number
    IP address count
    lbVpxId String
    (String) The internal identifier of a VPX load balancer.
    managementIpAddress String
    (String) The private address of the VPX console.
    name String
    (String) The internal name of a VPX load balancer.
    plan String
    Plan info
    privateSubnet String
    Private subnet
    privateVlanId Number
    Private VLAN id
    publicSubnet String
    Public subnet
    publicVlanId Number
    Piblic VLAN id
    speed Number
    Speed value
    tags List<String>
    List of the tags
    type String
    Type of the VPX
    version String
    version info
    vipPools List<String>
    (String) A list of virtual IP addresses for the VPX load balancer.

    Package Details

    Repository
    ibm ibm-cloud/terraform-provider-ibm
    License
    Notes
    This Pulumi package is based on the ibm Terraform Provider.
    ibm logo
    ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud