oci.LoadBalancer.LoadBalancer
Explore with Pulumi AI
This resource provides the Load Balancer resource in Oracle Cloud Infrastructure Load Balancer service.
Creates a new load balancer in the specified compartment. For general information about load balancers, see Overview of the Load Balancing Service.
For the purposes of access control, you must provide the OCID of the compartment where you want the load balancer to reside. Notice that the load balancer doesn’t have to be in the same compartment as the VCN or backend set. If you’re not sure which compartment to use, put the load balancer in the same compartment as the VCN. For information about access control and compartments, see Overview of the IAM Service.
You must specify a display name for the load balancer. It does not have to be unique, and you can change it.
For information about Availability Domains, see
Regions and Availability Domains.
To get a list of Availability Domains, use the ListAvailabilityDomains
operation
in the Identity and Access Management Service API.
All Oracle Cloud Infrastructure resources, including load balancers, get an Oracle-assigned, unique ID called an Oracle Cloud Identifier (OCID). When you create a resource, you can find its OCID in the response. You can also retrieve a resource’s OCID by using a List API operation on that resource type, or by viewing the resource in the Console. Fore more information, see Resource Identifiers.
When you create a load balancer, the system assigns an IP address. To get the IP address, use the GetLoadBalancer operation.
Supported Aliases
oci_load_balancer
Example Usage
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;
return await Deployment.RunAsync(() =>
{
var testLoadBalancer = new Oci.LoadBalancer.LoadBalancer("testLoadBalancer", new()
{
CompartmentId = @var.Compartment_id,
DisplayName = @var.Load_balancer_display_name,
Shape = @var.Load_balancer_shape,
SubnetIds = @var.Load_balancer_subnet_ids,
DefinedTags =
{
{ "Operations.CostCenter", "42" },
},
FreeformTags =
{
{ "Department", "Finance" },
},
IpMode = @var.Load_balancer_ip_mode,
IsPrivate = @var.Load_balancer_is_private,
NetworkSecurityGroupIds = @var.Load_balancer_network_security_group_ids,
ReservedIps = new[]
{
new Oci.LoadBalancer.Inputs.LoadBalancerReservedIpArgs
{
Id = @var.Load_balancer_reserved_ips_id,
},
},
ShapeDetails = new Oci.LoadBalancer.Inputs.LoadBalancerShapeDetailsArgs
{
MaximumBandwidthInMbps = @var.Load_balancer_shape_details_maximum_bandwidth_in_mbps,
MinimumBandwidthInMbps = @var.Load_balancer_shape_details_minimum_bandwidth_in_mbps,
},
});
});
package main
import (
"github.com/pulumi/pulumi-oci/sdk/go/oci/LoadBalancer"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := LoadBalancer.NewLoadBalancer(ctx, "testLoadBalancer", &LoadBalancer.LoadBalancerArgs{
CompartmentId: pulumi.Any(_var.Compartment_id),
DisplayName: pulumi.Any(_var.Load_balancer_display_name),
Shape: pulumi.Any(_var.Load_balancer_shape),
SubnetIds: pulumi.Any(_var.Load_balancer_subnet_ids),
DefinedTags: pulumi.AnyMap{
"Operations.CostCenter": pulumi.Any("42"),
},
FreeformTags: pulumi.AnyMap{
"Department": pulumi.Any("Finance"),
},
IpMode: pulumi.Any(_var.Load_balancer_ip_mode),
IsPrivate: pulumi.Any(_var.Load_balancer_is_private),
NetworkSecurityGroupIds: pulumi.Any(_var.Load_balancer_network_security_group_ids),
ReservedIps: loadbalancer.LoadBalancerReservedIpArray{
&loadbalancer.LoadBalancerReservedIpArgs{
Id: pulumi.Any(_var.Load_balancer_reserved_ips_id),
},
},
ShapeDetails: &loadbalancer.LoadBalancerShapeDetailsArgs{
MaximumBandwidthInMbps: pulumi.Any(_var.Load_balancer_shape_details_maximum_bandwidth_in_mbps),
MinimumBandwidthInMbps: pulumi.Any(_var.Load_balancer_shape_details_minimum_bandwidth_in_mbps),
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.LoadBalancer.LoadBalancer;
import com.pulumi.oci.LoadBalancer.LoadBalancerArgs;
import com.pulumi.oci.LoadBalancer.inputs.LoadBalancerReservedIpArgs;
import com.pulumi.oci.LoadBalancer.inputs.LoadBalancerShapeDetailsArgs;
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 testLoadBalancer = new LoadBalancer("testLoadBalancer", LoadBalancerArgs.builder()
.compartmentId(var_.compartment_id())
.displayName(var_.load_balancer_display_name())
.shape(var_.load_balancer_shape())
.subnetIds(var_.load_balancer_subnet_ids())
.definedTags(Map.of("Operations.CostCenter", "42"))
.freeformTags(Map.of("Department", "Finance"))
.ipMode(var_.load_balancer_ip_mode())
.isPrivate(var_.load_balancer_is_private())
.networkSecurityGroupIds(var_.load_balancer_network_security_group_ids())
.reservedIps(LoadBalancerReservedIpArgs.builder()
.id(var_.load_balancer_reserved_ips_id())
.build())
.shapeDetails(LoadBalancerShapeDetailsArgs.builder()
.maximumBandwidthInMbps(var_.load_balancer_shape_details_maximum_bandwidth_in_mbps())
.minimumBandwidthInMbps(var_.load_balancer_shape_details_minimum_bandwidth_in_mbps())
.build())
.build());
}
}
import pulumi
import pulumi_oci as oci
test_load_balancer = oci.load_balancer.LoadBalancer("testLoadBalancer",
compartment_id=var["compartment_id"],
display_name=var["load_balancer_display_name"],
shape=var["load_balancer_shape"],
subnet_ids=var["load_balancer_subnet_ids"],
defined_tags={
"Operations.CostCenter": "42",
},
freeform_tags={
"Department": "Finance",
},
ip_mode=var["load_balancer_ip_mode"],
is_private=var["load_balancer_is_private"],
network_security_group_ids=var["load_balancer_network_security_group_ids"],
reserved_ips=[oci.load_balancer.LoadBalancerReservedIpArgs(
id=var["load_balancer_reserved_ips_id"],
)],
shape_details=oci.load_balancer.LoadBalancerShapeDetailsArgs(
maximum_bandwidth_in_mbps=var["load_balancer_shape_details_maximum_bandwidth_in_mbps"],
minimum_bandwidth_in_mbps=var["load_balancer_shape_details_minimum_bandwidth_in_mbps"],
))
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testLoadBalancer = new oci.loadbalancer.LoadBalancer("testLoadBalancer", {
compartmentId: _var.compartment_id,
displayName: _var.load_balancer_display_name,
shape: _var.load_balancer_shape,
subnetIds: _var.load_balancer_subnet_ids,
definedTags: {
"Operations.CostCenter": "42",
},
freeformTags: {
Department: "Finance",
},
ipMode: _var.load_balancer_ip_mode,
isPrivate: _var.load_balancer_is_private,
networkSecurityGroupIds: _var.load_balancer_network_security_group_ids,
reservedIps: [{
id: _var.load_balancer_reserved_ips_id,
}],
shapeDetails: {
maximumBandwidthInMbps: _var.load_balancer_shape_details_maximum_bandwidth_in_mbps,
minimumBandwidthInMbps: _var.load_balancer_shape_details_minimum_bandwidth_in_mbps,
},
});
resources:
testLoadBalancer:
type: oci:LoadBalancer:LoadBalancer
properties:
#Required
compartmentId: ${var.compartment_id}
displayName: ${var.load_balancer_display_name}
shape: ${var.load_balancer_shape}
subnetIds: ${var.load_balancer_subnet_ids}
#Optional
definedTags:
Operations.CostCenter: '42'
freeformTags:
Department: Finance
ipMode: ${var.load_balancer_ip_mode}
isPrivate: ${var.load_balancer_is_private}
networkSecurityGroupIds: ${var.load_balancer_network_security_group_ids}
reservedIps:
- id: ${var.load_balancer_reserved_ips_id}
shapeDetails:
maximumBandwidthInMbps: ${var.load_balancer_shape_details_maximum_bandwidth_in_mbps}
minimumBandwidthInMbps: ${var.load_balancer_shape_details_minimum_bandwidth_in_mbps}
Create LoadBalancer Resource
new LoadBalancer(name: string, args: LoadBalancerArgs, opts?: CustomResourceOptions);
@overload
def LoadBalancer(resource_name: str,
opts: Optional[ResourceOptions] = None,
compartment_id: Optional[str] = None,
defined_tags: Optional[Mapping[str, Any]] = None,
display_name: Optional[str] = None,
freeform_tags: Optional[Mapping[str, Any]] = None,
ip_mode: Optional[str] = None,
is_private: Optional[bool] = None,
network_security_group_ids: Optional[Sequence[str]] = None,
reserved_ips: Optional[Sequence[_loadbalancer.LoadBalancerReservedIpArgs]] = None,
shape: Optional[str] = None,
shape_details: Optional[_loadbalancer.LoadBalancerShapeDetailsArgs] = None,
subnet_ids: Optional[Sequence[str]] = None)
@overload
def LoadBalancer(resource_name: str,
args: LoadBalancerArgs,
opts: Optional[ResourceOptions] = None)
func NewLoadBalancer(ctx *Context, name string, args LoadBalancerArgs, opts ...ResourceOption) (*LoadBalancer, error)
public LoadBalancer(string name, LoadBalancerArgs args, CustomResourceOptions? opts = null)
public LoadBalancer(String name, LoadBalancerArgs args)
public LoadBalancer(String name, LoadBalancerArgs args, CustomResourceOptions options)
type: oci:LoadBalancer:LoadBalancer
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args LoadBalancerArgs
- 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 LoadBalancerArgs
- 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 LoadBalancerArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args LoadBalancerArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args LoadBalancerArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
LoadBalancer Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The LoadBalancer resource accepts the following input properties:
- Compartment
Id string (Updatable) The OCID of the compartment in which to create the load balancer.
- Display
Name string (Updatable) A user-friendly name. It does not have to be unique, and it is changeable. Avoid entering confidential information. Example:
example_load_balancer
- Shape string
(Updatable) A template that determines the total pre-provisioned bandwidth (ingress plus egress). To get a list of available shapes, use the ListShapes operation. Example:
flexible
NOTE: Starting May 2023, Fixed shapes - 10Mbps, 100Mbps, 400Mbps, 8000Mbps would be deprecated and only shape allowed would beFlexible
*Note: When updating shape for a load balancer, all existing connections to the load balancer will be reset during the update process. Also10Mbps-Micro
shape cannot be updated to any other shape nor can any other shape be updated to10Mbps-Micro
.- Subnet
Ids List<string> An array of subnet OCIDs.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Dictionary<string, object>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- Dictionary<string, object>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- Ip
Mode string IPv6 is currently supported only in the Government Cloud. Whether the load balancer has an IPv4 or IPv6 IP address.
If "IPV4", the service assigns an IPv4 address and the load balancer supports IPv4 traffic.
If "IPV6", the service assigns an IPv6 address and the load balancer supports IPv6 traffic.
Example: "ipMode":"IPV6"
- Is
Private bool Whether the load balancer has a VCN-local (private) IP address.
If "true", the service assigns a private IP address to the load balancer.
If "false", the service assigns a public IP address to the load balancer.
A public load balancer is accessible from the internet, depending on your VCN's security list rules. For more information about public and private load balancers, see How Load Balancing Works.
Example:
true
- Network
Security List<string>Group Ids (Updatable) An array of NSG OCIDs associated with this load balancer.
During the load balancer's creation, the service adds the new load balancer to the specified NSGs.
The benefits of using NSGs with the load balancer include:
- NSGs define network security rules to govern ingress and egress traffic for the load balancer.
- The network security rules of other resources can reference the NSGs associated with the load balancer to ensure access.
Example:
["ocid1.nsg.oc1.phx.unique_ID"]
- Reserved
Ips List<LoadBalancer Reserved Ip> An array of reserved Ips. Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- Shape
Details LoadBalancer Shape Details (Updatable) The configuration details to create load balancer using Flexible shape. This is required only if shapeName is
Flexible
.
- Compartment
Id string (Updatable) The OCID of the compartment in which to create the load balancer.
- Display
Name string (Updatable) A user-friendly name. It does not have to be unique, and it is changeable. Avoid entering confidential information. Example:
example_load_balancer
- Shape string
(Updatable) A template that determines the total pre-provisioned bandwidth (ingress plus egress). To get a list of available shapes, use the ListShapes operation. Example:
flexible
NOTE: Starting May 2023, Fixed shapes - 10Mbps, 100Mbps, 400Mbps, 8000Mbps would be deprecated and only shape allowed would beFlexible
*Note: When updating shape for a load balancer, all existing connections to the load balancer will be reset during the update process. Also10Mbps-Micro
shape cannot be updated to any other shape nor can any other shape be updated to10Mbps-Micro
.- Subnet
Ids []string An array of subnet OCIDs.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- map[string]interface{}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- map[string]interface{}
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- Ip
Mode string IPv6 is currently supported only in the Government Cloud. Whether the load balancer has an IPv4 or IPv6 IP address.
If "IPV4", the service assigns an IPv4 address and the load balancer supports IPv4 traffic.
If "IPV6", the service assigns an IPv6 address and the load balancer supports IPv6 traffic.
Example: "ipMode":"IPV6"
- Is
Private bool Whether the load balancer has a VCN-local (private) IP address.
If "true", the service assigns a private IP address to the load balancer.
If "false", the service assigns a public IP address to the load balancer.
A public load balancer is accessible from the internet, depending on your VCN's security list rules. For more information about public and private load balancers, see How Load Balancing Works.
Example:
true
- Network
Security []stringGroup Ids (Updatable) An array of NSG OCIDs associated with this load balancer.
During the load balancer's creation, the service adds the new load balancer to the specified NSGs.
The benefits of using NSGs with the load balancer include:
- NSGs define network security rules to govern ingress and egress traffic for the load balancer.
- The network security rules of other resources can reference the NSGs associated with the load balancer to ensure access.
Example:
["ocid1.nsg.oc1.phx.unique_ID"]
- Reserved
Ips []LoadBalancer Reserved Ip Args An array of reserved Ips. Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- Shape
Details LoadBalancer Shape Details Args (Updatable) The configuration details to create load balancer using Flexible shape. This is required only if shapeName is
Flexible
.
- compartment
Id String (Updatable) The OCID of the compartment in which to create the load balancer.
- display
Name String (Updatable) A user-friendly name. It does not have to be unique, and it is changeable. Avoid entering confidential information. Example:
example_load_balancer
- shape String
(Updatable) A template that determines the total pre-provisioned bandwidth (ingress plus egress). To get a list of available shapes, use the ListShapes operation. Example:
flexible
NOTE: Starting May 2023, Fixed shapes - 10Mbps, 100Mbps, 400Mbps, 8000Mbps would be deprecated and only shape allowed would beFlexible
*Note: When updating shape for a load balancer, all existing connections to the load balancer will be reset during the update process. Also10Mbps-Micro
shape cannot be updated to any other shape nor can any other shape be updated to10Mbps-Micro
.- subnet
Ids List<String> An array of subnet OCIDs.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Map<String,Object>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- Map<String,Object>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- ip
Mode String IPv6 is currently supported only in the Government Cloud. Whether the load balancer has an IPv4 or IPv6 IP address.
If "IPV4", the service assigns an IPv4 address and the load balancer supports IPv4 traffic.
If "IPV6", the service assigns an IPv6 address and the load balancer supports IPv6 traffic.
Example: "ipMode":"IPV6"
- is
Private Boolean Whether the load balancer has a VCN-local (private) IP address.
If "true", the service assigns a private IP address to the load balancer.
If "false", the service assigns a public IP address to the load balancer.
A public load balancer is accessible from the internet, depending on your VCN's security list rules. For more information about public and private load balancers, see How Load Balancing Works.
Example:
true
- network
Security List<String>Group Ids (Updatable) An array of NSG OCIDs associated with this load balancer.
During the load balancer's creation, the service adds the new load balancer to the specified NSGs.
The benefits of using NSGs with the load balancer include:
- NSGs define network security rules to govern ingress and egress traffic for the load balancer.
- The network security rules of other resources can reference the NSGs associated with the load balancer to ensure access.
Example:
["ocid1.nsg.oc1.phx.unique_ID"]
- reserved
Ips List<ReservedIp> An array of reserved Ips. Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- shape
Details ShapeDetails (Updatable) The configuration details to create load balancer using Flexible shape. This is required only if shapeName is
Flexible
.
- compartment
Id string (Updatable) The OCID of the compartment in which to create the load balancer.
- display
Name string (Updatable) A user-friendly name. It does not have to be unique, and it is changeable. Avoid entering confidential information. Example:
example_load_balancer
- shape string
(Updatable) A template that determines the total pre-provisioned bandwidth (ingress plus egress). To get a list of available shapes, use the ListShapes operation. Example:
flexible
NOTE: Starting May 2023, Fixed shapes - 10Mbps, 100Mbps, 400Mbps, 8000Mbps would be deprecated and only shape allowed would beFlexible
*Note: When updating shape for a load balancer, all existing connections to the load balancer will be reset during the update process. Also10Mbps-Micro
shape cannot be updated to any other shape nor can any other shape be updated to10Mbps-Micro
.- subnet
Ids string[] An array of subnet OCIDs.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- {[key: string]: any}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- {[key: string]: any}
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- ip
Mode string IPv6 is currently supported only in the Government Cloud. Whether the load balancer has an IPv4 or IPv6 IP address.
If "IPV4", the service assigns an IPv4 address and the load balancer supports IPv4 traffic.
If "IPV6", the service assigns an IPv6 address and the load balancer supports IPv6 traffic.
Example: "ipMode":"IPV6"
- is
Private boolean Whether the load balancer has a VCN-local (private) IP address.
If "true", the service assigns a private IP address to the load balancer.
If "false", the service assigns a public IP address to the load balancer.
A public load balancer is accessible from the internet, depending on your VCN's security list rules. For more information about public and private load balancers, see How Load Balancing Works.
Example:
true
- network
Security string[]Group Ids (Updatable) An array of NSG OCIDs associated with this load balancer.
During the load balancer's creation, the service adds the new load balancer to the specified NSGs.
The benefits of using NSGs with the load balancer include:
- NSGs define network security rules to govern ingress and egress traffic for the load balancer.
- The network security rules of other resources can reference the NSGs associated with the load balancer to ensure access.
Example:
["ocid1.nsg.oc1.phx.unique_ID"]
- reserved
Ips LoadBalancer Reserved Ip[] An array of reserved Ips. Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- shape
Details LoadBalancer Shape Details (Updatable) The configuration details to create load balancer using Flexible shape. This is required only if shapeName is
Flexible
.
- compartment_
id str (Updatable) The OCID of the compartment in which to create the load balancer.
- display_
name str (Updatable) A user-friendly name. It does not have to be unique, and it is changeable. Avoid entering confidential information. Example:
example_load_balancer
- shape str
(Updatable) A template that determines the total pre-provisioned bandwidth (ingress plus egress). To get a list of available shapes, use the ListShapes operation. Example:
flexible
NOTE: Starting May 2023, Fixed shapes - 10Mbps, 100Mbps, 400Mbps, 8000Mbps would be deprecated and only shape allowed would beFlexible
*Note: When updating shape for a load balancer, all existing connections to the load balancer will be reset during the update process. Also10Mbps-Micro
shape cannot be updated to any other shape nor can any other shape be updated to10Mbps-Micro
.- subnet_
ids Sequence[str] An array of subnet OCIDs.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Mapping[str, Any]
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- Mapping[str, Any]
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- ip_
mode str IPv6 is currently supported only in the Government Cloud. Whether the load balancer has an IPv4 or IPv6 IP address.
If "IPV4", the service assigns an IPv4 address and the load balancer supports IPv4 traffic.
If "IPV6", the service assigns an IPv6 address and the load balancer supports IPv6 traffic.
Example: "ipMode":"IPV6"
- is_
private bool Whether the load balancer has a VCN-local (private) IP address.
If "true", the service assigns a private IP address to the load balancer.
If "false", the service assigns a public IP address to the load balancer.
A public load balancer is accessible from the internet, depending on your VCN's security list rules. For more information about public and private load balancers, see How Load Balancing Works.
Example:
true
- network_
security_ Sequence[str]group_ ids (Updatable) An array of NSG OCIDs associated with this load balancer.
During the load balancer's creation, the service adds the new load balancer to the specified NSGs.
The benefits of using NSGs with the load balancer include:
- NSGs define network security rules to govern ingress and egress traffic for the load balancer.
- The network security rules of other resources can reference the NSGs associated with the load balancer to ensure access.
Example:
["ocid1.nsg.oc1.phx.unique_ID"]
- reserved_
ips LoadBalancer Reserved Ip Args] An array of reserved Ips. Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- shape_
details LoadBalancer Shape Details Args (Updatable) The configuration details to create load balancer using Flexible shape. This is required only if shapeName is
Flexible
.
- compartment
Id String (Updatable) The OCID of the compartment in which to create the load balancer.
- display
Name String (Updatable) A user-friendly name. It does not have to be unique, and it is changeable. Avoid entering confidential information. Example:
example_load_balancer
- shape String
(Updatable) A template that determines the total pre-provisioned bandwidth (ingress plus egress). To get a list of available shapes, use the ListShapes operation. Example:
flexible
NOTE: Starting May 2023, Fixed shapes - 10Mbps, 100Mbps, 400Mbps, 8000Mbps would be deprecated and only shape allowed would beFlexible
*Note: When updating shape for a load balancer, all existing connections to the load balancer will be reset during the update process. Also10Mbps-Micro
shape cannot be updated to any other shape nor can any other shape be updated to10Mbps-Micro
.- subnet
Ids List<String> An array of subnet OCIDs.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Map<Any>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- Map<Any>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- ip
Mode String IPv6 is currently supported only in the Government Cloud. Whether the load balancer has an IPv4 or IPv6 IP address.
If "IPV4", the service assigns an IPv4 address and the load balancer supports IPv4 traffic.
If "IPV6", the service assigns an IPv6 address and the load balancer supports IPv6 traffic.
Example: "ipMode":"IPV6"
- is
Private Boolean Whether the load balancer has a VCN-local (private) IP address.
If "true", the service assigns a private IP address to the load balancer.
If "false", the service assigns a public IP address to the load balancer.
A public load balancer is accessible from the internet, depending on your VCN's security list rules. For more information about public and private load balancers, see How Load Balancing Works.
Example:
true
- network
Security List<String>Group Ids (Updatable) An array of NSG OCIDs associated with this load balancer.
During the load balancer's creation, the service adds the new load balancer to the specified NSGs.
The benefits of using NSGs with the load balancer include:
- NSGs define network security rules to govern ingress and egress traffic for the load balancer.
- The network security rules of other resources can reference the NSGs associated with the load balancer to ensure access.
Example:
["ocid1.nsg.oc1.phx.unique_ID"]
- reserved
Ips List<Property Map> An array of reserved Ips. Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- shape
Details Property Map (Updatable) The configuration details to create load balancer using Flexible shape. This is required only if shapeName is
Flexible
.
Outputs
All input properties are implicitly available as output properties. Additionally, the LoadBalancer resource produces the following output properties:
- Id string
The provider-assigned unique ID for this managed resource.
- Ip
Address List<LoadDetails Balancer Ip Address Detail> An array of IP addresses.
- Ip
Addresses List<string> An array of IP addresses. Deprecated: use ip_address_details instead
The 'ip_addresses' field has been deprecated. Please use 'ip_address_details' instead.
- State string
The current state of the load balancer.
- Dictionary<string, object>
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example:
{"orcl-cloud.free-tier-retained": "true"}
- Time
Created string The date and time the load balancer was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- Id string
The provider-assigned unique ID for this managed resource.
- Ip
Address []LoadDetails Balancer Ip Address Detail An array of IP addresses.
- Ip
Addresses []string An array of IP addresses. Deprecated: use ip_address_details instead
The 'ip_addresses' field has been deprecated. Please use 'ip_address_details' instead.
- State string
The current state of the load balancer.
- map[string]interface{}
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example:
{"orcl-cloud.free-tier-retained": "true"}
- Time
Created string The date and time the load balancer was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- id String
The provider-assigned unique ID for this managed resource.
- ip
Address List<IpDetails Address Detail> An array of IP addresses.
- ip
Addresses List<String> An array of IP addresses. Deprecated: use ip_address_details instead
The 'ip_addresses' field has been deprecated. Please use 'ip_address_details' instead.
- state String
The current state of the load balancer.
- Map<String,Object>
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created String The date and time the load balancer was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- id string
The provider-assigned unique ID for this managed resource.
- ip
Address LoadDetails Balancer Ip Address Detail[] An array of IP addresses.
- ip
Addresses string[] An array of IP addresses. Deprecated: use ip_address_details instead
The 'ip_addresses' field has been deprecated. Please use 'ip_address_details' instead.
- state string
The current state of the load balancer.
- {[key: string]: any}
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created string The date and time the load balancer was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- id str
The provider-assigned unique ID for this managed resource.
- ip_
address_ Loaddetails Balancer Ip Address Detail] An array of IP addresses.
- ip_
addresses Sequence[str] An array of IP addresses. Deprecated: use ip_address_details instead
The 'ip_addresses' field has been deprecated. Please use 'ip_address_details' instead.
- state str
The current state of the load balancer.
- Mapping[str, Any]
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time_
created str The date and time the load balancer was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- id String
The provider-assigned unique ID for this managed resource.
- ip
Address List<Property Map>Details An array of IP addresses.
- ip
Addresses List<String> An array of IP addresses. Deprecated: use ip_address_details instead
The 'ip_addresses' field has been deprecated. Please use 'ip_address_details' instead.
- state String
The current state of the load balancer.
- Map<Any>
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created String The date and time the load balancer was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
Look up Existing LoadBalancer Resource
Get an existing LoadBalancer 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?: LoadBalancerState, opts?: CustomResourceOptions): LoadBalancer
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
compartment_id: Optional[str] = None,
defined_tags: Optional[Mapping[str, Any]] = None,
display_name: Optional[str] = None,
freeform_tags: Optional[Mapping[str, Any]] = None,
ip_address_details: Optional[Sequence[_loadbalancer.LoadBalancerIpAddressDetailArgs]] = None,
ip_addresses: Optional[Sequence[str]] = None,
ip_mode: Optional[str] = None,
is_private: Optional[bool] = None,
network_security_group_ids: Optional[Sequence[str]] = None,
reserved_ips: Optional[Sequence[_loadbalancer.LoadBalancerReservedIpArgs]] = None,
shape: Optional[str] = None,
shape_details: Optional[_loadbalancer.LoadBalancerShapeDetailsArgs] = None,
state: Optional[str] = None,
subnet_ids: Optional[Sequence[str]] = None,
system_tags: Optional[Mapping[str, Any]] = None,
time_created: Optional[str] = None) -> LoadBalancer
func GetLoadBalancer(ctx *Context, name string, id IDInput, state *LoadBalancerState, opts ...ResourceOption) (*LoadBalancer, error)
public static LoadBalancer Get(string name, Input<string> id, LoadBalancerState? state, CustomResourceOptions? opts = null)
public static LoadBalancer get(String name, Output<String> id, LoadBalancerState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Compartment
Id string (Updatable) The OCID of the compartment in which to create the load balancer.
- Dictionary<string, object>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- Display
Name string (Updatable) A user-friendly name. It does not have to be unique, and it is changeable. Avoid entering confidential information. Example:
example_load_balancer
- Dictionary<string, object>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- Ip
Address List<LoadDetails Balancer Ip Address Detail> An array of IP addresses.
- Ip
Addresses List<string> An array of IP addresses. Deprecated: use ip_address_details instead
The 'ip_addresses' field has been deprecated. Please use 'ip_address_details' instead.
- Ip
Mode string IPv6 is currently supported only in the Government Cloud. Whether the load balancer has an IPv4 or IPv6 IP address.
If "IPV4", the service assigns an IPv4 address and the load balancer supports IPv4 traffic.
If "IPV6", the service assigns an IPv6 address and the load balancer supports IPv6 traffic.
Example: "ipMode":"IPV6"
- Is
Private bool Whether the load balancer has a VCN-local (private) IP address.
If "true", the service assigns a private IP address to the load balancer.
If "false", the service assigns a public IP address to the load balancer.
A public load balancer is accessible from the internet, depending on your VCN's security list rules. For more information about public and private load balancers, see How Load Balancing Works.
Example:
true
- Network
Security List<string>Group Ids (Updatable) An array of NSG OCIDs associated with this load balancer.
During the load balancer's creation, the service adds the new load balancer to the specified NSGs.
The benefits of using NSGs with the load balancer include:
- NSGs define network security rules to govern ingress and egress traffic for the load balancer.
- The network security rules of other resources can reference the NSGs associated with the load balancer to ensure access.
Example:
["ocid1.nsg.oc1.phx.unique_ID"]
- Reserved
Ips List<LoadBalancer Reserved Ip> An array of reserved Ips. Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- Shape string
(Updatable) A template that determines the total pre-provisioned bandwidth (ingress plus egress). To get a list of available shapes, use the ListShapes operation. Example:
flexible
NOTE: Starting May 2023, Fixed shapes - 10Mbps, 100Mbps, 400Mbps, 8000Mbps would be deprecated and only shape allowed would beFlexible
*Note: When updating shape for a load balancer, all existing connections to the load balancer will be reset during the update process. Also10Mbps-Micro
shape cannot be updated to any other shape nor can any other shape be updated to10Mbps-Micro
.- Shape
Details LoadBalancer Shape Details (Updatable) The configuration details to create load balancer using Flexible shape. This is required only if shapeName is
Flexible
.- State string
The current state of the load balancer.
- Subnet
Ids List<string> An array of subnet OCIDs.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Dictionary<string, object>
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example:
{"orcl-cloud.free-tier-retained": "true"}
- Time
Created string The date and time the load balancer was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- Compartment
Id string (Updatable) The OCID of the compartment in which to create the load balancer.
- map[string]interface{}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- Display
Name string (Updatable) A user-friendly name. It does not have to be unique, and it is changeable. Avoid entering confidential information. Example:
example_load_balancer
- map[string]interface{}
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- Ip
Address []LoadDetails Balancer Ip Address Detail Args An array of IP addresses.
- Ip
Addresses []string An array of IP addresses. Deprecated: use ip_address_details instead
The 'ip_addresses' field has been deprecated. Please use 'ip_address_details' instead.
- Ip
Mode string IPv6 is currently supported only in the Government Cloud. Whether the load balancer has an IPv4 or IPv6 IP address.
If "IPV4", the service assigns an IPv4 address and the load balancer supports IPv4 traffic.
If "IPV6", the service assigns an IPv6 address and the load balancer supports IPv6 traffic.
Example: "ipMode":"IPV6"
- Is
Private bool Whether the load balancer has a VCN-local (private) IP address.
If "true", the service assigns a private IP address to the load balancer.
If "false", the service assigns a public IP address to the load balancer.
A public load balancer is accessible from the internet, depending on your VCN's security list rules. For more information about public and private load balancers, see How Load Balancing Works.
Example:
true
- Network
Security []stringGroup Ids (Updatable) An array of NSG OCIDs associated with this load balancer.
During the load balancer's creation, the service adds the new load balancer to the specified NSGs.
The benefits of using NSGs with the load balancer include:
- NSGs define network security rules to govern ingress and egress traffic for the load balancer.
- The network security rules of other resources can reference the NSGs associated with the load balancer to ensure access.
Example:
["ocid1.nsg.oc1.phx.unique_ID"]
- Reserved
Ips []LoadBalancer Reserved Ip Args An array of reserved Ips. Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- Shape string
(Updatable) A template that determines the total pre-provisioned bandwidth (ingress plus egress). To get a list of available shapes, use the ListShapes operation. Example:
flexible
NOTE: Starting May 2023, Fixed shapes - 10Mbps, 100Mbps, 400Mbps, 8000Mbps would be deprecated and only shape allowed would beFlexible
*Note: When updating shape for a load balancer, all existing connections to the load balancer will be reset during the update process. Also10Mbps-Micro
shape cannot be updated to any other shape nor can any other shape be updated to10Mbps-Micro
.- Shape
Details LoadBalancer Shape Details Args (Updatable) The configuration details to create load balancer using Flexible shape. This is required only if shapeName is
Flexible
.- State string
The current state of the load balancer.
- Subnet
Ids []string An array of subnet OCIDs.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- map[string]interface{}
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example:
{"orcl-cloud.free-tier-retained": "true"}
- Time
Created string The date and time the load balancer was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- compartment
Id String (Updatable) The OCID of the compartment in which to create the load balancer.
- Map<String,Object>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- display
Name String (Updatable) A user-friendly name. It does not have to be unique, and it is changeable. Avoid entering confidential information. Example:
example_load_balancer
- Map<String,Object>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- ip
Address List<IpDetails Address Detail> An array of IP addresses.
- ip
Addresses List<String> An array of IP addresses. Deprecated: use ip_address_details instead
The 'ip_addresses' field has been deprecated. Please use 'ip_address_details' instead.
- ip
Mode String IPv6 is currently supported only in the Government Cloud. Whether the load balancer has an IPv4 or IPv6 IP address.
If "IPV4", the service assigns an IPv4 address and the load balancer supports IPv4 traffic.
If "IPV6", the service assigns an IPv6 address and the load balancer supports IPv6 traffic.
Example: "ipMode":"IPV6"
- is
Private Boolean Whether the load balancer has a VCN-local (private) IP address.
If "true", the service assigns a private IP address to the load balancer.
If "false", the service assigns a public IP address to the load balancer.
A public load balancer is accessible from the internet, depending on your VCN's security list rules. For more information about public and private load balancers, see How Load Balancing Works.
Example:
true
- network
Security List<String>Group Ids (Updatable) An array of NSG OCIDs associated with this load balancer.
During the load balancer's creation, the service adds the new load balancer to the specified NSGs.
The benefits of using NSGs with the load balancer include:
- NSGs define network security rules to govern ingress and egress traffic for the load balancer.
- The network security rules of other resources can reference the NSGs associated with the load balancer to ensure access.
Example:
["ocid1.nsg.oc1.phx.unique_ID"]
- reserved
Ips List<ReservedIp> An array of reserved Ips. Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- shape String
(Updatable) A template that determines the total pre-provisioned bandwidth (ingress plus egress). To get a list of available shapes, use the ListShapes operation. Example:
flexible
NOTE: Starting May 2023, Fixed shapes - 10Mbps, 100Mbps, 400Mbps, 8000Mbps would be deprecated and only shape allowed would beFlexible
*Note: When updating shape for a load balancer, all existing connections to the load balancer will be reset during the update process. Also10Mbps-Micro
shape cannot be updated to any other shape nor can any other shape be updated to10Mbps-Micro
.- shape
Details ShapeDetails (Updatable) The configuration details to create load balancer using Flexible shape. This is required only if shapeName is
Flexible
.- state String
The current state of the load balancer.
- subnet
Ids List<String> An array of subnet OCIDs.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Map<String,Object>
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created String The date and time the load balancer was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- compartment
Id string (Updatable) The OCID of the compartment in which to create the load balancer.
- {[key: string]: any}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- display
Name string (Updatable) A user-friendly name. It does not have to be unique, and it is changeable. Avoid entering confidential information. Example:
example_load_balancer
- {[key: string]: any}
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- ip
Address LoadDetails Balancer Ip Address Detail[] An array of IP addresses.
- ip
Addresses string[] An array of IP addresses. Deprecated: use ip_address_details instead
The 'ip_addresses' field has been deprecated. Please use 'ip_address_details' instead.
- ip
Mode string IPv6 is currently supported only in the Government Cloud. Whether the load balancer has an IPv4 or IPv6 IP address.
If "IPV4", the service assigns an IPv4 address and the load balancer supports IPv4 traffic.
If "IPV6", the service assigns an IPv6 address and the load balancer supports IPv6 traffic.
Example: "ipMode":"IPV6"
- is
Private boolean Whether the load balancer has a VCN-local (private) IP address.
If "true", the service assigns a private IP address to the load balancer.
If "false", the service assigns a public IP address to the load balancer.
A public load balancer is accessible from the internet, depending on your VCN's security list rules. For more information about public and private load balancers, see How Load Balancing Works.
Example:
true
- network
Security string[]Group Ids (Updatable) An array of NSG OCIDs associated with this load balancer.
During the load balancer's creation, the service adds the new load balancer to the specified NSGs.
The benefits of using NSGs with the load balancer include:
- NSGs define network security rules to govern ingress and egress traffic for the load balancer.
- The network security rules of other resources can reference the NSGs associated with the load balancer to ensure access.
Example:
["ocid1.nsg.oc1.phx.unique_ID"]
- reserved
Ips LoadBalancer Reserved Ip[] An array of reserved Ips. Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- shape string
(Updatable) A template that determines the total pre-provisioned bandwidth (ingress plus egress). To get a list of available shapes, use the ListShapes operation. Example:
flexible
NOTE: Starting May 2023, Fixed shapes - 10Mbps, 100Mbps, 400Mbps, 8000Mbps would be deprecated and only shape allowed would beFlexible
*Note: When updating shape for a load balancer, all existing connections to the load balancer will be reset during the update process. Also10Mbps-Micro
shape cannot be updated to any other shape nor can any other shape be updated to10Mbps-Micro
.- shape
Details LoadBalancer Shape Details (Updatable) The configuration details to create load balancer using Flexible shape. This is required only if shapeName is
Flexible
.- state string
The current state of the load balancer.
- subnet
Ids string[] An array of subnet OCIDs.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- {[key: string]: any}
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created string The date and time the load balancer was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- compartment_
id str (Updatable) The OCID of the compartment in which to create the load balancer.
- Mapping[str, Any]
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- display_
name str (Updatable) A user-friendly name. It does not have to be unique, and it is changeable. Avoid entering confidential information. Example:
example_load_balancer
- Mapping[str, Any]
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- ip_
address_ Loaddetails Balancer Ip Address Detail Args] An array of IP addresses.
- ip_
addresses Sequence[str] An array of IP addresses. Deprecated: use ip_address_details instead
The 'ip_addresses' field has been deprecated. Please use 'ip_address_details' instead.
- ip_
mode str IPv6 is currently supported only in the Government Cloud. Whether the load balancer has an IPv4 or IPv6 IP address.
If "IPV4", the service assigns an IPv4 address and the load balancer supports IPv4 traffic.
If "IPV6", the service assigns an IPv6 address and the load balancer supports IPv6 traffic.
Example: "ipMode":"IPV6"
- is_
private bool Whether the load balancer has a VCN-local (private) IP address.
If "true", the service assigns a private IP address to the load balancer.
If "false", the service assigns a public IP address to the load balancer.
A public load balancer is accessible from the internet, depending on your VCN's security list rules. For more information about public and private load balancers, see How Load Balancing Works.
Example:
true
- network_
security_ Sequence[str]group_ ids (Updatable) An array of NSG OCIDs associated with this load balancer.
During the load balancer's creation, the service adds the new load balancer to the specified NSGs.
The benefits of using NSGs with the load balancer include:
- NSGs define network security rules to govern ingress and egress traffic for the load balancer.
- The network security rules of other resources can reference the NSGs associated with the load balancer to ensure access.
Example:
["ocid1.nsg.oc1.phx.unique_ID"]
- reserved_
ips LoadBalancer Reserved Ip Args] An array of reserved Ips. Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- shape str
(Updatable) A template that determines the total pre-provisioned bandwidth (ingress plus egress). To get a list of available shapes, use the ListShapes operation. Example:
flexible
NOTE: Starting May 2023, Fixed shapes - 10Mbps, 100Mbps, 400Mbps, 8000Mbps would be deprecated and only shape allowed would beFlexible
*Note: When updating shape for a load balancer, all existing connections to the load balancer will be reset during the update process. Also10Mbps-Micro
shape cannot be updated to any other shape nor can any other shape be updated to10Mbps-Micro
.- shape_
details LoadBalancer Shape Details Args (Updatable) The configuration details to create load balancer using Flexible shape. This is required only if shapeName is
Flexible
.- state str
The current state of the load balancer.
- subnet_
ids Sequence[str] An array of subnet OCIDs.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Mapping[str, Any]
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time_
created str The date and time the load balancer was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- compartment
Id String (Updatable) The OCID of the compartment in which to create the load balancer.
- Map<Any>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- display
Name String (Updatable) A user-friendly name. It does not have to be unique, and it is changeable. Avoid entering confidential information. Example:
example_load_balancer
- Map<Any>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- ip
Address List<Property Map>Details An array of IP addresses.
- ip
Addresses List<String> An array of IP addresses. Deprecated: use ip_address_details instead
The 'ip_addresses' field has been deprecated. Please use 'ip_address_details' instead.
- ip
Mode String IPv6 is currently supported only in the Government Cloud. Whether the load balancer has an IPv4 or IPv6 IP address.
If "IPV4", the service assigns an IPv4 address and the load balancer supports IPv4 traffic.
If "IPV6", the service assigns an IPv6 address and the load balancer supports IPv6 traffic.
Example: "ipMode":"IPV6"
- is
Private Boolean Whether the load balancer has a VCN-local (private) IP address.
If "true", the service assigns a private IP address to the load balancer.
If "false", the service assigns a public IP address to the load balancer.
A public load balancer is accessible from the internet, depending on your VCN's security list rules. For more information about public and private load balancers, see How Load Balancing Works.
Example:
true
- network
Security List<String>Group Ids (Updatable) An array of NSG OCIDs associated with this load balancer.
During the load balancer's creation, the service adds the new load balancer to the specified NSGs.
The benefits of using NSGs with the load balancer include:
- NSGs define network security rules to govern ingress and egress traffic for the load balancer.
- The network security rules of other resources can reference the NSGs associated with the load balancer to ensure access.
Example:
["ocid1.nsg.oc1.phx.unique_ID"]
- reserved
Ips List<Property Map> An array of reserved Ips. Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- shape String
(Updatable) A template that determines the total pre-provisioned bandwidth (ingress plus egress). To get a list of available shapes, use the ListShapes operation. Example:
flexible
NOTE: Starting May 2023, Fixed shapes - 10Mbps, 100Mbps, 400Mbps, 8000Mbps would be deprecated and only shape allowed would beFlexible
*Note: When updating shape for a load balancer, all existing connections to the load balancer will be reset during the update process. Also10Mbps-Micro
shape cannot be updated to any other shape nor can any other shape be updated to10Mbps-Micro
.- shape
Details Property Map (Updatable) The configuration details to create load balancer using Flexible shape. This is required only if shapeName is
Flexible
.- state String
The current state of the load balancer.
- subnet
Ids List<String> An array of subnet OCIDs.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Map<Any>
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created String The date and time the load balancer was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
Supporting Types
LoadBalancerIpAddressDetail, LoadBalancerIpAddressDetailArgs
- Ip
Address string An IP address. Example:
192.168.0.3
- Is
Public bool Whether the IP address is public or private.
- Reserved
Ips List<LoadBalancer Ip Address Detail Reserved Ip> Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- Ip
Address string An IP address. Example:
192.168.0.3
- Is
Public bool Whether the IP address is public or private.
- Reserved
Ips []LoadBalancer Ip Address Detail Reserved Ip Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- ip
Address String An IP address. Example:
192.168.0.3
- is
Public Boolean Whether the IP address is public or private.
- reserved
Ips List<IpAddress Detail Reserved Ip> Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- ip
Address string An IP address. Example:
192.168.0.3
- is
Public boolean Whether the IP address is public or private.
- reserved
Ips LoadBalancer Ip Address Detail Reserved Ip[] Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- ip_
address str An IP address. Example:
192.168.0.3
- is_
public bool Whether the IP address is public or private.
- reserved_
ips LoadBalancer Ip Address Detail Reserved Ip] Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
- ip
Address String An IP address. Example:
192.168.0.3
- is
Public Boolean Whether the IP address is public or private.
- reserved
Ips List<Property Map> Pre-created public IP that will be used as the IP of this load balancer. This reserved IP will not be deleted when load balancer is deleted. This ip should not be already mapped to any other resource.
LoadBalancerIpAddressDetailReservedIp, LoadBalancerIpAddressDetailReservedIpArgs
- Id string
Ocid of the pre-created public IP. That should be attahed to this load balancer.
- Id string
Ocid of the pre-created public IP. That should be attahed to this load balancer.
- id String
Ocid of the pre-created public IP. That should be attahed to this load balancer.
- id string
Ocid of the pre-created public IP. That should be attahed to this load balancer.
- id str
Ocid of the pre-created public IP. That should be attahed to this load balancer.
- id String
Ocid of the pre-created public IP. That should be attahed to this load balancer.
LoadBalancerReservedIp, LoadBalancerReservedIpArgs
- Id string
Ocid of the pre-created public IP. That should be attahed to this load balancer.
- Id string
Ocid of the pre-created public IP. That should be attahed to this load balancer.
- id String
Ocid of the pre-created public IP. That should be attahed to this load balancer.
- id string
Ocid of the pre-created public IP. That should be attahed to this load balancer.
- id str
Ocid of the pre-created public IP. That should be attahed to this load balancer.
- id String
Ocid of the pre-created public IP. That should be attahed to this load balancer.
LoadBalancerShapeDetails, LoadBalancerShapeDetailsArgs
- Maximum
Bandwidth intIn Mbps (Updatable) Bandwidth in Mbps that determines the maximum bandwidth (ingress plus egress) that the load balancer can achieve. This bandwidth cannot be always guaranteed. For a guaranteed bandwidth use the minimumBandwidthInMbps parameter.
The values must be between minimumBandwidthInMbps and 8000 (8Gbps).
Example:
1500
- Minimum
Bandwidth intIn Mbps (Updatable) Bandwidth in Mbps that determines the total pre-provisioned bandwidth (ingress plus egress). The values must be between 10 and the maximumBandwidthInMbps. Example:
150
- Maximum
Bandwidth intIn Mbps (Updatable) Bandwidth in Mbps that determines the maximum bandwidth (ingress plus egress) that the load balancer can achieve. This bandwidth cannot be always guaranteed. For a guaranteed bandwidth use the minimumBandwidthInMbps parameter.
The values must be between minimumBandwidthInMbps and 8000 (8Gbps).
Example:
1500
- Minimum
Bandwidth intIn Mbps (Updatable) Bandwidth in Mbps that determines the total pre-provisioned bandwidth (ingress plus egress). The values must be between 10 and the maximumBandwidthInMbps. Example:
150
- maximum
Bandwidth IntegerIn Mbps (Updatable) Bandwidth in Mbps that determines the maximum bandwidth (ingress plus egress) that the load balancer can achieve. This bandwidth cannot be always guaranteed. For a guaranteed bandwidth use the minimumBandwidthInMbps parameter.
The values must be between minimumBandwidthInMbps and 8000 (8Gbps).
Example:
1500
- minimum
Bandwidth IntegerIn Mbps (Updatable) Bandwidth in Mbps that determines the total pre-provisioned bandwidth (ingress plus egress). The values must be between 10 and the maximumBandwidthInMbps. Example:
150
- maximum
Bandwidth numberIn Mbps (Updatable) Bandwidth in Mbps that determines the maximum bandwidth (ingress plus egress) that the load balancer can achieve. This bandwidth cannot be always guaranteed. For a guaranteed bandwidth use the minimumBandwidthInMbps parameter.
The values must be between minimumBandwidthInMbps and 8000 (8Gbps).
Example:
1500
- minimum
Bandwidth numberIn Mbps (Updatable) Bandwidth in Mbps that determines the total pre-provisioned bandwidth (ingress plus egress). The values must be between 10 and the maximumBandwidthInMbps. Example:
150
- maximum_
bandwidth_ intin_ mbps (Updatable) Bandwidth in Mbps that determines the maximum bandwidth (ingress plus egress) that the load balancer can achieve. This bandwidth cannot be always guaranteed. For a guaranteed bandwidth use the minimumBandwidthInMbps parameter.
The values must be between minimumBandwidthInMbps and 8000 (8Gbps).
Example:
1500
- minimum_
bandwidth_ intin_ mbps (Updatable) Bandwidth in Mbps that determines the total pre-provisioned bandwidth (ingress plus egress). The values must be between 10 and the maximumBandwidthInMbps. Example:
150
- maximum
Bandwidth NumberIn Mbps (Updatable) Bandwidth in Mbps that determines the maximum bandwidth (ingress plus egress) that the load balancer can achieve. This bandwidth cannot be always guaranteed. For a guaranteed bandwidth use the minimumBandwidthInMbps parameter.
The values must be between minimumBandwidthInMbps and 8000 (8Gbps).
Example:
1500
- minimum
Bandwidth NumberIn Mbps (Updatable) Bandwidth in Mbps that determines the total pre-provisioned bandwidth (ingress plus egress). The values must be between 10 and the maximumBandwidthInMbps. Example:
150
Import
LoadBalancers can be imported using the id
, e.g.
$ pulumi import oci:LoadBalancer/loadBalancer:LoadBalancer test_load_balancer "id"
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
oci
Terraform Provider.