Options
All
  • Public
  • Public/Protected
  • All
Menu

Class LoadBalancerClient

This service client uses {@link common.CircuitBreaker.DefaultConfiguration} for all the operations by default if no circuit breaker configuration is defined by the user.

Hierarchy

  • LoadBalancerClient

Constructors

Properties

Accessors

Methods

Constructors

constructor

  • new LoadBalancerClient(params: common.AuthParams, clientConfiguration?: common.ClientConfiguration): LoadBalancerClient

Properties

Protected _bodyDuplexMode

_bodyDuplexMode: any = undefined

Protected _circuitBreaker

_circuitBreaker: typeof Breaker | null = null

Protected _clientConfiguration

_clientConfiguration: ClientConfiguration

Protected _defaultHeaders

_defaultHeaders: any

Protected _endpoint

_endpoint: string = ""

Protected _httpClient

_httpClient: HttpClient

Protected _httpOptions

_httpOptions: any = undefined

Protected _lastSetRegionOrRegionId

_lastSetRegionOrRegionId: string = ""

Protected _realmSpecificEndpointTemplateEnabled

_realmSpecificEndpointTemplateEnabled: boolean | undefined = undefined

Protected _region

_region: Region

Protected _regionId

_regionId: string = ""

Protected _waiters

targetService

targetService: string = "LoadBalancer"

Static Protected endpointServiceName

endpointServiceName: string = ""

Static Protected serviceEndpointTemplate

serviceEndpointTemplate: string = "https://iaas.{region}.{secondLevelDomain}"

Accessors

endpoint

  • get endpoint(): string
  • set endpoint(endpoint: string): void

logger

region

  • set region(region: Region): void
  • Sets the region to call (ex, Region.US_PHOENIX_1). Note, this will call {@link #endpoint(String) endpoint} after resolving the endpoint.

    Parameters

    • region: Region

      The region of the service.

    Returns void

regionId

  • set regionId(regionId: string): void
  • Sets the regionId to call (ex, 'us-phoenix-1').

    Note, this will first try to map the region ID to a known Region and call {@link #region(Region) region}. If no known Region could be determined, it will create an endpoint assuming its in default Realm OC1 and then call {@link #endpoint(String) endpoint}.

    Parameters

    • regionId: string

      The public region ID.

    Returns void

useRealmSpecificEndpointTemplate

  • set useRealmSpecificEndpointTemplate(realmSpecificEndpointTemplateEnabled: boolean): void
  • Determines whether realm specific endpoint should be used or not. Set realmSpecificEndpointTemplateEnabled to "true" if the user wants to enable use of realm specific endpoint template, otherwise set it to "false"

    Parameters

    • realmSpecificEndpointTemplateEnabled: boolean

      flag to enable the use of realm specific endpoint template

    Returns void

Methods

changeLoadBalancerCompartment

close

  • close(): void

createBackend

createBackendSet

createCertificate

createHostname

createListener

createLoadBalancer

  • 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](https://docs.cloud.oracle.com/Content/Identity/Concepts/overview.htm).

    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](https://docs.cloud.oracle.com/Content/General/Concepts/regions.htm). 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](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).

    After you send your request, the new object's state will temporarily be PROVISIONING. Before using the object, first make sure its state has changed to RUNNING.

    When you create a load balancer, the system assigns an IP address. To get the IP address, use the {@link #getLoadBalancer(GetLoadBalancerRequest) getLoadBalancer} operation.

    This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use CreateLoadBalancer API.

    Parameters

    Returns Promise<CreateLoadBalancerResponse>

    CreateLoadBalancerResponse

createPathRouteSet

createRoutingPolicy

createRuleSet

createSSLCipherSuite

createWaiters

  • Creates a new LoadBalancerWaiter for resources for this service.

    Parameters

    • Optional config: common.WaiterConfiguration

      The waiter configuration for termination and delay strategy

    Returns LoadBalancerWaiter

    The service waiters.

deleteBackend

  • Removes a backend server from a given load balancer and backend set. This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use DeleteBackend API.

    Parameters

    Returns Promise<DeleteBackendResponse>

    DeleteBackendResponse

deleteBackendSet

  • Deletes the specified backend set. Note that deleting a backend set removes its backend servers from the load balancer.

    Before you can delete a backend set, you must remove it from any active listeners.

    This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use DeleteBackendSet API.

    Parameters

    Returns Promise<DeleteBackendSetResponse>

    DeleteBackendSetResponse

deleteCertificate

deleteHostname

deleteListener

deleteLoadBalancer

deletePathRouteSet

  • Deletes a path route set from the specified load balancer.

    To delete a path route rule from a path route set, use the {@link #updatePathRouteSet(UpdatePathRouteSetRequest) updatePathRouteSet} operation.

    This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use DeletePathRouteSet API.

    Parameters

    Returns Promise<DeletePathRouteSetResponse>

    DeletePathRouteSetResponse

deleteRoutingPolicy

  • Deletes a routing policy from the specified load balancer.

    To delete a routing rule from a routing policy, use the {@link #updateRoutingPolicy(UpdateRoutingPolicyRequest) updateRoutingPolicy} operation.

    This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use DeleteRoutingPolicy API.

    Parameters

    Returns Promise<DeleteRoutingPolicyResponse>

    DeleteRoutingPolicyResponse

deleteRuleSet

  • Deletes a rule set from the specified load balancer.

    To delete a rule from a rule set, use the {@link #updateRuleSet(UpdateRuleSetRequest) updateRuleSet} operation.

    This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use DeleteRuleSet API.

    Parameters

    Returns Promise<DeleteRuleSetResponse>

    DeleteRuleSetResponse

deleteSSLCipherSuite

getBackend

  • Gets the specified backend server's configuration information. This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use GetBackend API.

    Parameters

    Returns Promise<GetBackendResponse>

    GetBackendResponse

getBackendHealth

getBackendSet

getBackendSetHealth

getHealthChecker

  • Gets the health check policy information for a given load balancer and backend set. This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use GetHealthChecker API.

    Parameters

    Returns Promise<GetHealthCheckerResponse>

    GetHealthCheckerResponse

getHostname

  • Gets the specified hostname resource's configuration information. This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use GetHostname API.

    Parameters

    Returns Promise<GetHostnameResponse>

    GetHostnameResponse

getLoadBalancer

getLoadBalancerHealth

getPathRouteSet

getRoutingPolicy

getRuleSet

getSSLCipherSuite

getWaiters

getWorkRequest

listAllLoadBalancerHealths

  • NOTE: This function is deprecated in favor of listLoadBalancerHealthsRecordIterator function. Creates a new async iterator which will iterate over the models.LoadBalancerHealthSummary objects contained in responses from the listLoadBalancerHealths operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<LoadBalancerHealthSummary>

listAllLoadBalancerHealthsResponses

  • NOTE: This function is deprecated in favor of listLoadBalancerHealthsResponseIterator function. Creates a new async iterator which will iterate over the responses received from the listLoadBalancerHealths operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<ListLoadBalancerHealthsResponse>

listAllLoadBalancers

  • NOTE: This function is deprecated in favor of listLoadBalancersRecordIterator function. Creates a new async iterator which will iterate over the models.LoadBalancer objects contained in responses from the listLoadBalancers operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<LoadBalancer>

listAllLoadBalancersResponses

  • NOTE: This function is deprecated in favor of listLoadBalancersResponseIterator function. Creates a new async iterator which will iterate over the responses received from the listLoadBalancers operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<ListLoadBalancersResponse>

listAllPolicies

  • NOTE: This function is deprecated in favor of listPoliciesRecordIterator function. Creates a new async iterator which will iterate over the models.LoadBalancerPolicy objects contained in responses from the listPolicies operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<LoadBalancerPolicy>

listAllPoliciesResponses

  • NOTE: This function is deprecated in favor of listPoliciesResponseIterator function. Creates a new async iterator which will iterate over the responses received from the listPolicies operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<ListPoliciesResponse>

listAllProtocols

  • NOTE: This function is deprecated in favor of listProtocolsRecordIterator function. Creates a new async iterator which will iterate over the models.LoadBalancerProtocol objects contained in responses from the listProtocols operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<LoadBalancerProtocol>

listAllProtocolsResponses

  • NOTE: This function is deprecated in favor of listProtocolsResponseIterator function. Creates a new async iterator which will iterate over the responses received from the listProtocols operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<ListProtocolsResponse>

listAllRoutingPolicies

  • NOTE: This function is deprecated in favor of listRoutingPoliciesRecordIterator function. Creates a new async iterator which will iterate over the models.RoutingPolicy objects contained in responses from the listRoutingPolicies operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<RoutingPolicy>

listAllRoutingPoliciesResponses

  • NOTE: This function is deprecated in favor of listRoutingPoliciesResponseIterator function. Creates a new async iterator which will iterate over the responses received from the listRoutingPolicies operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<ListRoutingPoliciesResponse>

listAllShapes

  • NOTE: This function is deprecated in favor of listShapesRecordIterator function. Creates a new async iterator which will iterate over the models.LoadBalancerShape objects contained in responses from the listShapes operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<LoadBalancerShape>

listAllShapesResponses

  • NOTE: This function is deprecated in favor of listShapesResponseIterator function. Creates a new async iterator which will iterate over the responses received from the listShapes operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<ListShapesResponse>

listAllWorkRequests

  • NOTE: This function is deprecated in favor of listWorkRequestsRecordIterator function. Creates a new async iterator which will iterate over the models.WorkRequest objects contained in responses from the listWorkRequests operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<WorkRequest>

listAllWorkRequestsResponses

  • NOTE: This function is deprecated in favor of listWorkRequestsResponseIterator function. Creates a new async iterator which will iterate over the responses received from the listWorkRequests operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<ListWorkRequestsResponse>

listBackendSets

listBackends

  • Lists the backend servers for a given load balancer and backend set. This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use ListBackends API.

    Parameters

    Returns Promise<ListBackendsResponse>

    ListBackendsResponse

listCertificates

listHostnames

  • Lists all hostname resources associated with the specified load balancer. This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use ListHostnames API.

    Parameters

    Returns Promise<ListHostnamesResponse>

    ListHostnamesResponse

listListenerRules

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

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

    This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use ListListenerRules API.

    Parameters

    Returns Promise<ListListenerRulesResponse>

    ListListenerRulesResponse

listLoadBalancerHealths

listLoadBalancerHealthsRecordIterator

listLoadBalancerHealthsResponseIterator

listLoadBalancers

listLoadBalancersRecordIterator

  • Creates a new async iterator which will iterate over the models.LoadBalancer objects contained in responses from the listLoadBalancers operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<LoadBalancer>

listLoadBalancersResponseIterator

listPathRouteSets

listPolicies

listPoliciesRecordIterator

  • Creates a new async iterator which will iterate over the models.LoadBalancerPolicy objects contained in responses from the listPolicies operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<LoadBalancerPolicy>

listPoliciesResponseIterator

listProtocols

listProtocolsRecordIterator

  • Creates a new async iterator which will iterate over the models.LoadBalancerProtocol objects contained in responses from the listProtocols operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<LoadBalancerProtocol>

listProtocolsResponseIterator

listRoutingPolicies

listRoutingPoliciesRecordIterator

  • Creates a new async iterator which will iterate over the models.RoutingPolicy objects contained in responses from the listRoutingPolicies operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<RoutingPolicy>

listRoutingPoliciesResponseIterator

listRuleSets

  • Lists all rule sets associated with the specified load balancer. This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use ListRuleSets API.

    Parameters

    Returns Promise<ListRuleSetsResponse>

    ListRuleSetsResponse

listSSLCipherSuites

listShapes

listShapesRecordIterator

  • Creates a new async iterator which will iterate over the models.LoadBalancerShape objects contained in responses from the listShapes operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<LoadBalancerShape>

listShapesResponseIterator

listWorkRequests

listWorkRequestsRecordIterator

  • Creates a new async iterator which will iterate over the models.WorkRequest objects contained in responses from the listWorkRequests operation. This iterator will fetch more data from the server as needed.

    Parameters

    Returns AsyncIterableIterator<WorkRequest>

listWorkRequestsResponseIterator

shutdownCircuitBreaker

  • shutdownCircuitBreaker(): void

updateBackend

  • Updates the configuration of a backend server within the specified backend set. This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use UpdateBackend API.

    Parameters

    Returns Promise<UpdateBackendResponse>

    UpdateBackendResponse

updateBackendSet

updateHealthChecker

updateHostname

  • Overwrites an existing hostname resource on the specified load balancer. Use this operation to change a virtual hostname.

    This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use UpdateHostname API.

    Parameters

    Returns Promise<UpdateHostnameResponse>

    UpdateHostnameResponse

updateListener

updateLoadBalancer

updateLoadBalancerShape

  • Update the shape of a load balancer. The new shape can be larger or smaller compared to existing shape of the LB. The service will try to perform this operation in the least disruptive way to existing connections, but there is a possibility that they might be lost during the LB resizing process. The new shape becomes effective as soon as the related work request completes successfully, i.e. when reshaping to a larger shape, the LB will start accepting larger bandwidth and when reshaping to a smaller one, the LB will be accepting smaller bandwidth.

    This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use UpdateLoadBalancerShape API.

    Parameters

    Returns Promise<UpdateLoadBalancerShapeResponse>

    UpdateLoadBalancerShapeResponse

updateNetworkSecurityGroups

updatePathRouteSet

  • Overwrites an existing path route set on the specified load balancer. Use this operation to add, delete, or alter path route rules in a path route set.

    To add a new path route rule to a path route set, the `pathRoutes` in the {@link #updatePathRouteSetDetails(UpdatePathRouteSetDetailsRequest) updatePathRouteSetDetails} object must include both the new path route rule to add and the existing path route rules to retain.

    This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use UpdatePathRouteSet API.

    Parameters

    Returns Promise<UpdatePathRouteSetResponse>

    UpdatePathRouteSetResponse

updateRoutingPolicy

  • Overwrites an existing routing policy on the specified load balancer. Use this operation to add, delete, or alter routing policy rules in a routing policy.

    To add a new routing rule to a routing policy, the body must include both the new routing rule to add and the existing rules to retain.

    This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use UpdateRoutingPolicy API.

    Parameters

    Returns Promise<UpdateRoutingPolicyResponse>

    UpdateRoutingPolicyResponse

updateRuleSet

  • Overwrites an existing set of rules on the specified load balancer. Use this operation to add or alter the rules in a rule set.

    To add a new rule to a set, the body must include both the new rule to add and the existing rules to retain.

    This operation does not retry by default if the user has not defined a retry configuration.

    throws

    OciError when an error occurs

    example

    Click here to see how to use UpdateRuleSet API.

    Parameters

    Returns Promise<UpdateRuleSetResponse>

    UpdateRuleSetResponse

updateSSLCipherSuite