ibm 1.77.1 published on Monday, Apr 14, 2025 by ibm-cloud
ibm.getLbaas
Explore with Pulumi AI
Retrieve information of an existing IBM Cloud load balancer as a read-only data source. For more information, about load balancer as a service, see enabling auto scale for better capacity and resiliency.
Example Usage
Coming soon!
Coming soon!
Coming soon!
Coming soon!
Coming soon!
resources:
  lbaas:
    type: ibm:Lbaas
    properties:
      datacenter: dal09
      description: updated desc-used for terraform uat
      protocols:
        - backendPort: 80
          backendProtocol: HTTP
          frontendPort: 80
          frontendProtocol: HTTP
          loadBalancingMethod: round_robin
      serverInstances:
        - privateIpAddress: 10.1.19.26
      subnets:
        - 1.878778e+06
variables:
  tfaccLbaas:
    fn::invoke:
      function: ibm:getLbaas
      arguments:
        name: test
Using getLbaas
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getLbaas(args: GetLbaasArgs, opts?: InvokeOptions): Promise<GetLbaasResult>
function getLbaasOutput(args: GetLbaasOutputArgs, opts?: InvokeOptions): Output<GetLbaasResult>def get_lbaas(id: Optional[str] = None,
              name: Optional[str] = None,
              opts: Optional[InvokeOptions] = None) -> GetLbaasResult
def get_lbaas_output(id: Optional[pulumi.Input[str]] = None,
              name: Optional[pulumi.Input[str]] = None,
              opts: Optional[InvokeOptions] = None) -> Output[GetLbaasResult]func LookupLbaas(ctx *Context, args *LookupLbaasArgs, opts ...InvokeOption) (*LookupLbaasResult, error)
func LookupLbaasOutput(ctx *Context, args *LookupLbaasOutputArgs, opts ...InvokeOption) LookupLbaasResultOutput> Note: This function is named LookupLbaas in the Go SDK.
public static class GetLbaas 
{
    public static Task<GetLbaasResult> InvokeAsync(GetLbaasArgs args, InvokeOptions? opts = null)
    public static Output<GetLbaasResult> Invoke(GetLbaasInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetLbaasResult> getLbaas(GetLbaasArgs args, InvokeOptions options)
public static Output<GetLbaasResult> getLbaas(GetLbaasArgs args, InvokeOptions options)
fn::invoke:
  function: ibm:index/getLbaas:getLbaas
  arguments:
    # arguments dictionaryThe following arguments are supported:
getLbaas Result
The following output properties are available:
- Active
Connections double - (Integer) The number of total established connections.
 - Datacenter string
 - (String) The data center where load balancer is located.
 - Description string
 - (String) A description of the load balancer.
 - Health
Monitors List<GetLbaas Health Monitor>  - (List of Objects) A nested block describes the health_monitors assigned to the load balancer.
 - Id string
 - Name string
 - Protocols
List<Get
Lbaas Protocol>  - (List of Objects) A nested block describes the protocols that are assigned to the load balancer.
 - Server
Instances List<GetLbaas Server Instance>  - Server
Instances doubleDown  - (Integer) The number of service instances, that are in the 
DOWNhealth state. - Server
Instances doubleUp  - (Integer) The number of service instances, that are in the 
UPhealth state. - Ssl
Ciphers List<string> - (Array) The list of SSL offloads.
 - Status string
 - (String) Specifies the operation status of the load balancer as 
onlineoroffline. - Type string
 - (String) Specifies whether a load balancer is public or private.
 - Use
System boolPublic Ip Pool  - (String) It specifies whether the public IP addresses are allocated from system public IP pool or public subnet from the account order of the load balancer.
 - Vip string
 - (String) The virtual IP address of the load balancer.
 
- Active
Connections float64 - (Integer) The number of total established connections.
 - Datacenter string
 - (String) The data center where load balancer is located.
 - Description string
 - (String) A description of the load balancer.
 - Health
Monitors []GetLbaas Health Monitor Type  - (List of Objects) A nested block describes the health_monitors assigned to the load balancer.
 - Id string
 - Name string
 - Protocols
[]Get
Lbaas Protocol  - (List of Objects) A nested block describes the protocols that are assigned to the load balancer.
 - Server
Instances []GetLbaas Server Instance  - Server
Instances float64Down  - (Integer) The number of service instances, that are in the 
DOWNhealth state. - Server
Instances float64Up  - (Integer) The number of service instances, that are in the 
UPhealth state. - Ssl
Ciphers []string - (Array) The list of SSL offloads.
 - Status string
 - (String) Specifies the operation status of the load balancer as 
onlineoroffline. - Type string
 - (String) Specifies whether a load balancer is public or private.
 - Use
System boolPublic Ip Pool  - (String) It specifies whether the public IP addresses are allocated from system public IP pool or public subnet from the account order of the load balancer.
 - Vip string
 - (String) The virtual IP address of the load balancer.
 
- active
Connections Double - (Integer) The number of total established connections.
 - datacenter String
 - (String) The data center where load balancer is located.
 - description String
 - (String) A description of the load balancer.
 - health
Monitors List<GetLbaas Health Monitor>  - (List of Objects) A nested block describes the health_monitors assigned to the load balancer.
 - id String
 - name String
 - protocols
List<Get
Lbaas Protocol>  - (List of Objects) A nested block describes the protocols that are assigned to the load balancer.
 - server
Instances List<GetLbaas Server Instance>  - server
Instances DoubleDown  - (Integer) The number of service instances, that are in the 
DOWNhealth state. - server
Instances DoubleUp  - (Integer) The number of service instances, that are in the 
UPhealth state. - ssl
Ciphers List<String> - (Array) The list of SSL offloads.
 - status String
 - (String) Specifies the operation status of the load balancer as 
onlineoroffline. - type String
 - (String) Specifies whether a load balancer is public or private.
 - use
System BooleanPublic Ip Pool  - (String) It specifies whether the public IP addresses are allocated from system public IP pool or public subnet from the account order of the load balancer.
 - vip String
 - (String) The virtual IP address of the load balancer.
 
- active
Connections number - (Integer) The number of total established connections.
 - datacenter string
 - (String) The data center where load balancer is located.
 - description string
 - (String) A description of the load balancer.
 - health
Monitors GetLbaas Health Monitor[]  - (List of Objects) A nested block describes the health_monitors assigned to the load balancer.
 - id string
 - name string
 - protocols
Get
Lbaas Protocol[]  - (List of Objects) A nested block describes the protocols that are assigned to the load balancer.
 - server
Instances GetLbaas Server Instance[]  - server
Instances numberDown  - (Integer) The number of service instances, that are in the 
DOWNhealth state. - server
Instances numberUp  - (Integer) The number of service instances, that are in the 
UPhealth state. - ssl
Ciphers string[] - (Array) The list of SSL offloads.
 - status string
 - (String) Specifies the operation status of the load balancer as 
onlineoroffline. - type string
 - (String) Specifies whether a load balancer is public or private.
 - use
System booleanPublic Ip Pool  - (String) It specifies whether the public IP addresses are allocated from system public IP pool or public subnet from the account order of the load balancer.
 - vip string
 - (String) The virtual IP address of the load balancer.
 
- active_
connections float - (Integer) The number of total established connections.
 - datacenter str
 - (String) The data center where load balancer is located.
 - description str
 - (String) A description of the load balancer.
 - health_
monitors Sequence[GetLbaas Health Monitor]  - (List of Objects) A nested block describes the health_monitors assigned to the load balancer.
 - id str
 - name str
 - protocols
Sequence[Get
Lbaas Protocol]  - (List of Objects) A nested block describes the protocols that are assigned to the load balancer.
 - server_
instances Sequence[GetLbaas Server Instance]  - server_
instances_ floatdown  - (Integer) The number of service instances, that are in the 
DOWNhealth state. - server_
instances_ floatup  - (Integer) The number of service instances, that are in the 
UPhealth state. - ssl_
ciphers Sequence[str] - (Array) The list of SSL offloads.
 - status str
 - (String) Specifies the operation status of the load balancer as 
onlineoroffline. - type str
 - (String) Specifies whether a load balancer is public or private.
 - use_
system_ boolpublic_ ip_ pool  - (String) It specifies whether the public IP addresses are allocated from system public IP pool or public subnet from the account order of the load balancer.
 - vip str
 - (String) The virtual IP address of the load balancer.
 
- active
Connections Number - (Integer) The number of total established connections.
 - datacenter String
 - (String) The data center where load balancer is located.
 - description String
 - (String) A description of the load balancer.
 - health
Monitors List<Property Map> - (List of Objects) A nested block describes the health_monitors assigned to the load balancer.
 - id String
 - name String
 - protocols List<Property Map>
 - (List of Objects) A nested block describes the protocols that are assigned to the load balancer.
 - server
Instances List<Property Map> - server
Instances NumberDown  - (Integer) The number of service instances, that are in the 
DOWNhealth state. - server
Instances NumberUp  - (Integer) The number of service instances, that are in the 
UPhealth state. - ssl
Ciphers List<String> - (Array) The list of SSL offloads.
 - status String
 - (String) Specifies the operation status of the load balancer as 
onlineoroffline. - type String
 - (String) Specifies whether a load balancer is public or private.
 - use
System BooleanPublic Ip Pool  - (String) It specifies whether the public IP addresses are allocated from system public IP pool or public subnet from the account order of the load balancer.
 - vip String
 - (String) The virtual IP address of the load balancer.
 
Supporting Types
GetLbaasHealthMonitor   
- Interval double
 - (Integer) The interval in seconds to perform the health check.
 - Max
Retries double - (Integer) The maximum retries before the load balancer are considered unhealthy.
 - Monitor
Id string - (String) The health monitor UUID.
 - Port double
 - (String) The backend port.
 - Protocol string
 - (String) The backend protocol.
 - Timeout double
 - (String) The health check method.
 - Url
Path string - (String) If monitor is "HTTP", it specifies the URL path.
 
- Interval float64
 - (Integer) The interval in seconds to perform the health check.
 - Max
Retries float64 - (Integer) The maximum retries before the load balancer are considered unhealthy.
 - Monitor
Id string - (String) The health monitor UUID.
 - Port float64
 - (String) The backend port.
 - Protocol string
 - (String) The backend protocol.
 - Timeout float64
 - (String) The health check method.
 - Url
Path string - (String) If monitor is "HTTP", it specifies the URL path.
 
- interval Double
 - (Integer) The interval in seconds to perform the health check.
 - max
Retries Double - (Integer) The maximum retries before the load balancer are considered unhealthy.
 - monitor
Id String - (String) The health monitor UUID.
 - port Double
 - (String) The backend port.
 - protocol String
 - (String) The backend protocol.
 - timeout Double
 - (String) The health check method.
 - url
Path String - (String) If monitor is "HTTP", it specifies the URL path.
 
- interval number
 - (Integer) The interval in seconds to perform the health check.
 - max
Retries number - (Integer) The maximum retries before the load balancer are considered unhealthy.
 - monitor
Id string - (String) The health monitor UUID.
 - port number
 - (String) The backend port.
 - protocol string
 - (String) The backend protocol.
 - timeout number
 - (String) The health check method.
 - url
Path string - (String) If monitor is "HTTP", it specifies the URL path.
 
- interval float
 - (Integer) The interval in seconds to perform the health check.
 - max_
retries float - (Integer) The maximum retries before the load balancer are considered unhealthy.
 - monitor_
id str - (String) The health monitor UUID.
 - port float
 - (String) The backend port.
 - protocol str
 - (String) The backend protocol.
 - timeout float
 - (String) The health check method.
 - url_
path str - (String) If monitor is "HTTP", it specifies the URL path.
 
- interval Number
 - (Integer) The interval in seconds to perform the health check.
 - max
Retries Number - (Integer) The maximum retries before the load balancer are considered unhealthy.
 - monitor
Id String - (String) The health monitor UUID.
 - port Number
 - (String) The backend port.
 - protocol String
 - (String) The backend protocol.
 - timeout Number
 - (String) The health check method.
 - url
Path String - (String) If monitor is "HTTP", it specifies the URL path.
 
GetLbaasProtocol  
- Backend
Port double - (Integer) The backend protocol port number.
 - Backend
Protocol string - (String) The backend protocol.
 - Frontend
Port double - (Integer) The front-end protocol port number.
 - Frontend
Protocol string - (String) The front-end protocol.
 - Load
Balancing stringMethod  - (String) The load-balancing algorithm.
 - Max
Conn double - (Integer) The number of connections the listener can accept.
 - Protocol
Id string - (String) The UUID of a load balancer protocol.
 - Session
Stickiness string - (Bool) Session stickiness.
 - Tls
Certificate doubleId  - (String) The ID of the SSL/TLS certificate used for a protocol.
 
- Backend
Port float64 - (Integer) The backend protocol port number.
 - Backend
Protocol string - (String) The backend protocol.
 - Frontend
Port float64 - (Integer) The front-end protocol port number.
 - Frontend
Protocol string - (String) The front-end protocol.
 - Load
Balancing stringMethod  - (String) The load-balancing algorithm.
 - Max
Conn float64 - (Integer) The number of connections the listener can accept.
 - Protocol
Id string - (String) The UUID of a load balancer protocol.
 - Session
Stickiness string - (Bool) Session stickiness.
 - Tls
Certificate float64Id  - (String) The ID of the SSL/TLS certificate used for a protocol.
 
- backend
Port Double - (Integer) The backend protocol port number.
 - backend
Protocol String - (String) The backend protocol.
 - frontend
Port Double - (Integer) The front-end protocol port number.
 - frontend
Protocol String - (String) The front-end protocol.
 - load
Balancing StringMethod  - (String) The load-balancing algorithm.
 - max
Conn Double - (Integer) The number of connections the listener can accept.
 - protocol
Id String - (String) The UUID of a load balancer protocol.
 - session
Stickiness String - (Bool) Session stickiness.
 - tls
Certificate DoubleId  - (String) The ID of the SSL/TLS certificate used for a protocol.
 
- backend
Port number - (Integer) The backend protocol port number.
 - backend
Protocol string - (String) The backend protocol.
 - frontend
Port number - (Integer) The front-end protocol port number.
 - frontend
Protocol string - (String) The front-end protocol.
 - load
Balancing stringMethod  - (String) The load-balancing algorithm.
 - max
Conn number - (Integer) The number of connections the listener can accept.
 - protocol
Id string - (String) The UUID of a load balancer protocol.
 - session
Stickiness string - (Bool) Session stickiness.
 - tls
Certificate numberId  - (String) The ID of the SSL/TLS certificate used for a protocol.
 
- backend_
port float - (Integer) The backend protocol port number.
 - backend_
protocol str - (String) The backend protocol.
 - frontend_
port float - (Integer) The front-end protocol port number.
 - frontend_
protocol str - (String) The front-end protocol.
 - load_
balancing_ strmethod  - (String) The load-balancing algorithm.
 - max_
conn float - (Integer) The number of connections the listener can accept.
 - protocol_
id str - (String) The UUID of a load balancer protocol.
 - session_
stickiness str - (Bool) Session stickiness.
 - tls_
certificate_ floatid  - (String) The ID of the SSL/TLS certificate used for a protocol.
 
- backend
Port Number - (Integer) The backend protocol port number.
 - backend
Protocol String - (String) The backend protocol.
 - frontend
Port Number - (Integer) The front-end protocol port number.
 - frontend
Protocol String - (String) The front-end protocol.
 - load
Balancing StringMethod  - (String) The load-balancing algorithm.
 - max
Conn Number - (Integer) The number of connections the listener can accept.
 - protocol
Id String - (String) The UUID of a load balancer protocol.
 - session
Stickiness String - (Bool) Session stickiness.
 - tls
Certificate NumberId  - (String) The ID of the SSL/TLS certificate used for a protocol.
 
GetLbaasServerInstance   
- Member
Id string - Private
Ip stringAddress  - Status string
 - (String) Specifies the operation status of the load balancer as 
onlineoroffline. - Weight double
 
- Member
Id string - Private
Ip stringAddress  - Status string
 - (String) Specifies the operation status of the load balancer as 
onlineoroffline. - Weight float64
 
- member
Id String - private
Ip StringAddress  - status String
 - (String) Specifies the operation status of the load balancer as 
onlineoroffline. - weight Double
 
- member
Id string - private
Ip stringAddress  - status string
 - (String) Specifies the operation status of the load balancer as 
onlineoroffline. - weight number
 
- member_
id str - private_
ip_ straddress  - status str
 - (String) Specifies the operation status of the load balancer as 
onlineoroffline. - weight float
 
- member
Id String - private
Ip StringAddress  - status String
 - (String) Specifies the operation status of the load balancer as 
onlineoroffline. - weight Number
 
Package Details
- Repository
 - ibm ibm-cloud/terraform-provider-ibm
 - License
 - Notes
 - This Pulumi package is based on the 
ibmTerraform Provider.