Load Balancer

00Overview

Provision Layer-7 load balancers and wire up everything in front of your application from a flow — create backend sets and add backend servers, open listeners on the ports and protocols you serve, and steer traffic with hostnames, path-route sets and routing policies. Manage SSL by uploading certificate bundles and cipher suites, adjust the shape and bandwidth as demand changes, and move a load balancer between compartments. Read backend and load-balancer health, and poll the work request behind every change so a flow only continues once the update has actually landed.

Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.

01Connecting Load Balancer

1. Open the node's Authentication dropdown and choose a method. Connect Oracle Cloud (recommended) uses a managed connection that Flomation provisions for you; API signing key (advanced) lets you paste an existing OCI signing key by hand.
2. For Connect Oracle Cloud, go to your Flomation environment's connections and add an Oracle Cloud connection: Flomation generates a signing keypair and walks you through creating a dedicated least-privilege user in Oracle Cloud and uploading Flomation's public key. Paste the resulting User OCID back into Flomation, pick the compartment and test the connection — Oracle can take a short while to activate a new key, so let the test retry.
3. Back in the node, leave Authentication on Connect Oracle Cloud and select your connection in the Oracle Cloud connection field — the tenancy, user, region and fingerprint are filled in for you.
4. For API signing key (advanced), in the Oracle Cloud Console open Profile → User settings → API keys and choose Add API key. Generate or upload a key, then copy the Configuration file preview Oracle shows you — it lists your Tenancy OCID, User OCID, Region and Key Fingerprint. Paste each into the matching node field, and set the Compartment OCID (from Identity → Compartments) to the compartment your load balancers live in.
5. Store the private key as a Flomation environment secret (e.g. loadbalancer_secret) and pick it in the node's Private Key (PEM) field — paste the full PEM including the BEGIN/END lines — and add a Private Key Passphrase secret only if your key is encrypted.

02Backend

OCI Load Balancer: Create Backend

oracle/loadbalancer/backend_create · Action

Add a backend server (IP address and port) to a backend set of an Oracle Cloud load balancer. Asynchronous — returns a work-request id.

Returns: tool_result, work_request_id, success, error

OCI Load Balancer: Delete Backend

oracle/loadbalancer/backend_delete · Action

Remove a backend server from a backend set of an Oracle Cloud load balancer. Asynchronous — returns a work-request id to poll with Get Work Request.

Returns: tool_result, work_request_id, success, error

OCI Load Balancer: Get Backend

oracle/loadbalancer/backend_get · Action

Fetch one backend server of an Oracle Cloud load balancer's backend set by its ip:port name — its weight, ports and drain/backup/offline flags.

Returns: tool_result, backend, name, success, error

OCI Load Balancer: Get Backend Health

oracle/loadbalancer/backend_get_health · Action

Read one backend server's health in an Oracle Cloud load balancer — overall status plus the most recent per-load-balancer health check results.

Returns: tool_result, health, status, success, error

OCI Load Balancer: List Backends

oracle/loadbalancer/backend_list · Action

List the backend servers of one backend set of an Oracle Cloud load balancer — each backend's IP, port, weight and drain/backup/offline state.

Returns: tool_result, backends, count, success, error

OCI Load Balancer: Create Backend Set

oracle/loadbalancer/backend_set_create · Action

Add a backend set — a pool of backend servers with a load-balancing policy (e.g. ROUND_ROBIN) and a health check — to an Oracle Cloud load balancer. Asynchronous.

Returns: tool_result, backend_set_name, work_request_id, success, error

OCI Load Balancer: Delete Backend Set

oracle/loadbalancer/backend_set_delete · Action

Delete one backend set of an Oracle Cloud load balancer by name. Deletion is asynchronous — returns a work-request id to poll with Get Work Request.

Returns: tool_result, name, work_request_id, success, error

OCI Load Balancer: Get Backend Set

oracle/loadbalancer/backend_set_get · Action

Fetch one backend set of an Oracle Cloud load balancer by name — its policy, health checker and backend servers.

Returns: tool_result, backend_set, name, success, error

OCI Load Balancer: Get Backend Set Health

oracle/loadbalancer/backend_set_get_health · Action

Read the health status of one backend set of an Oracle Cloud load balancer — overall status plus the total, warning, critical and unknown backend counts and name lists.

Returns: tool_result, health, status, success, error

OCI Load Balancer: Get Health Checker

oracle/loadbalancer/backend_set_get_health_checker · Action

Read the health-checker policy attached to a backend set of an Oracle Cloud load balancer — its protocol, port, URL path, expected return code and retries.

Returns: tool_result, health_checker, success, error

OCI Load Balancer: List Backend Sets

oracle/loadbalancer/backend_set_list · Action

List the backend sets of an Oracle Cloud load balancer — each with its policy, health checker and backend servers.

Returns: tool_result, backend_sets, count, success, error

OCI Load Balancer: Update Backend Set

oracle/loadbalancer/backend_set_update · Action

Update a backend set on an Oracle Cloud load balancer — replace its load-balancing policy (e.g. ROUND_ROBIN) and health check. Replace-semantics: the details overwrite the whole backend set. Asynchronous.

Returns: tool_result, backend_set_name, work_request_id, success, error

OCI Load Balancer: Update Health Checker

oracle/loadbalancer/backend_set_update_health_checker · Action

Replace the health-checker policy (protocol, port, URL path, expected return code, retries and timing) of a backend set on an Oracle Cloud load balancer. Asynchronous.

Returns: tool_result, backend_set_name, work_request_id, success, error

OCI Load Balancer: Update Backend

oracle/loadbalancer/backend_update · Action

Update a backend server (weight, backup, drain, offline) in a backend set of an Oracle Cloud load balancer. Asynchronous — returns a work-request id.

Returns: tool_result, work_request_id, success, error

03Certificate

OCI Load Balancer: Create Certificate

oracle/loadbalancer/certificate_create · Action

Upload an SSL certificate bundle to an Oracle Cloud load balancer so listeners can terminate HTTPS. Asynchronous. Bundles are immutable — to change one, delete and recreate it.

Returns: tool_result, certificate_name, work_request_id, success, error

OCI Load Balancer: Delete Certificate

oracle/loadbalancer/certificate_delete · Action

Delete a certificate bundle from an Oracle Cloud load balancer by name. Asynchronous — returns a work-request id to poll with Get Work Request. Fails if the bundle is still referenced by a listener or backend-set SSL configuration.

Returns: tool_result, certificate_name, work_request_id, success, error

OCI Load Balancer: List Certificates

oracle/loadbalancer/certificate_list · Action

List the SSL certificate bundles configured on an Oracle Cloud load balancer. Synchronous read.

Returns: tool_result, certificates, count, success, error

04Hostname

OCI Load Balancer: Create Hostname

oracle/loadbalancer/hostname_create · Action

Add a virtual hostname to an Oracle Cloud load balancer, for host-based routing on its listeners. Asynchronous.

Returns: tool_result, hostname_name, work_request_id, success, error

OCI Load Balancer: Delete Hostname

oracle/loadbalancer/hostname_delete · Action

Delete a virtual hostname resource from an Oracle Cloud load balancer, by name. Asynchronous — returns a work-request id to poll with Get Work Request.

Returns: tool_result, hostname_name, work_request_id, success, error

OCI Load Balancer: Get Hostname

oracle/loadbalancer/hostname_get · Action

Fetch one virtual hostname of an Oracle Cloud load balancer by name — its friendly name and the hostname value.

Returns: tool_result, hostname, name, success, error

OCI Load Balancer: List Hostnames

oracle/loadbalancer/hostname_list · Action

List the virtual hostnames of an Oracle Cloud load balancer — each with its name and hostname value.

Returns: tool_result, hostnames, count, success, error

OCI Load Balancer: Update Hostname

oracle/loadbalancer/hostname_update · Action

Update a virtual hostname's FQDN on an Oracle Cloud load balancer. Asynchronous.

Returns: tool_result, hostname_name, work_request_id, success, error

05Listener

OCI Load Balancer: Create Listener

oracle/loadbalancer/listener_create · Action

Add a listener — a protocol and port the Oracle Cloud load balancer accepts traffic on — forwarding to a default backend set. Asynchronous — returns a work-request id.

Returns: tool_result, listener_name, work_request_id, success, error

OCI Load Balancer: Delete Listener

oracle/loadbalancer/listener_delete · Action

Remove a listener — a protocol and port the Oracle Cloud load balancer accepts traffic on — from a load balancer, by name. Asynchronous — returns a work-request id.

Returns: tool_result, listener_name, work_request_id, success, error

OCI Load Balancer: List Listener Rules

oracle/loadbalancer/listener_list_rules · Action

List the effective rules applied to an Oracle Cloud load balancer listener — the rules from its rule sets, flattened, each tagged with its rule set.

Returns: tool_result, rules, count, success, error

OCI Load Balancer: Update Listener

oracle/loadbalancer/listener_update · Action

Update a listener on an Oracle Cloud load balancer — its default backend set, port, protocol, hostnames and path-route/routing-policy. Replaces the whole listener configuration. Asynchronous — returns a work-request id.

Returns: tool_result, listener_name, work_request_id, success, error

06Load

OCI Load Balancer: Move Load Balancer to Compartment

oracle/loadbalancer/load_balancer_change_compartment · Action

Move an Oracle Cloud load balancer to another compartment. Asynchronous — returns a work-request id to poll with Get Work Request.

Returns: tool_result, id, work_request_id, success, error

OCI Load Balancer: Create Load Balancer

oracle/loadbalancer/load_balancer_create · Action

Provision an Oracle Cloud Layer-7 load balancer in a compartment across one or two subnets. Provisioning is asynchronous — returns a work-request id to poll with Get Work Request.

Returns: tool_result, work_request_id, success, error

OCI Load Balancer: Delete Load Balancer

oracle/loadbalancer/load_balancer_delete · Action

Permanently delete an Oracle Cloud load balancer by OCID. Deletion is asynchronous — returns a work-request id to poll with Get Work Request.

Returns: tool_result, id, work_request_id, success, error

OCI Load Balancer: Get Load Balancer

oracle/loadbalancer/load_balancer_get · Action

Fetch a single Oracle Cloud load balancer by OCID — its shape, IP addresses, subnets, and the names of its listeners and backend sets.

Returns: tool_result, load_balancer, id, lifecycle_state, success, error

OCI Load Balancer: Get Load Balancer Health

oracle/loadbalancer/load_balancer_get_health · Action

Read a load balancer's overall health status — the aggregate OK/WARNING/CRITICAL/UNKNOWN roll-up plus the names of any backend sets in a warning, critical, or unknown state.

Returns: tool_result, health, status, success, error

OCI Load Balancer: List Load Balancers

oracle/loadbalancer/load_balancer_list · Action

List the Oracle Cloud load balancers in a compartment. Walks pagination up to a safe cap.

Returns: tool_result, load_balancers, count, truncated, success, error

OCI Load Balancer: List Load Balancer Healths

oracle/loadbalancer/load_balancer_list_health · Action

List the health status summary for every Oracle Cloud load balancer in a compartment. Walks pagination up to a safe cap.

Returns: tool_result, health_summaries, count, truncated, success, error

OCI Load Balancer: Update Load Balancer

oracle/loadbalancer/load_balancer_update · Action

Update an Oracle Cloud load balancer's mutable top-level fields — its display name and the request-id header feature. Asynchronous — returns a work-request id to poll with Get Work Request.

Returns: tool_result, id, work_request_id, success, error

OCI Load Balancer: Update Load Balancer NSGs

oracle/loadbalancer/load_balancer_update_network_security_groups · Action

Replace the network security groups (NSGs) associated with an Oracle Cloud load balancer. Replace-semantics: an empty list removes all NSG associations. Asynchronous — returns a work-request id to poll with Get Work Request.

Returns: tool_result, id, work_request_id, success, error

OCI Load Balancer: Update Load Balancer Shape

oracle/loadbalancer/load_balancer_update_shape · Action

Change an Oracle Cloud load balancer's shape (e.g. to flexible with a new bandwidth band). Asynchronous — returns a work-request id to poll with Get Work Request.

Returns: tool_result, id, work_request_id, success, error

07Path

OCI Load Balancer: Create Path Route Set

oracle/loadbalancer/path_route_set_create · Action

Add a path route set — a named collection of URL-path rules that route matching requests to specific backend sets — to an Oracle Cloud load balancer. Asynchronous.

Returns: tool_result, path_route_set_name, work_request_id, success, error

OCI Load Balancer: Delete Path Route Set

oracle/loadbalancer/path_route_set_delete · Action

Delete a path route set from an Oracle Cloud load balancer by name. Deletion is asynchronous — returns a work-request id to poll with Get Work Request.

Returns: tool_result, path_route_set_name, work_request_id, success, error

OCI Load Balancer: Get Path Route Set

oracle/loadbalancer/path_route_set_get · Action

Fetch one path-route set of an Oracle Cloud load balancer by name — its ordered path routes.

Returns: tool_result, path_route_set, name, success, error

OCI Load Balancer: List Path Route Sets

oracle/loadbalancer/path_route_set_list · Action

List the path-route sets of an Oracle Cloud load balancer — each with its ordered path routes.

Returns: tool_result, path_route_sets, count, success, error

OCI Load Balancer: Update Path Route Set

oracle/loadbalancer/path_route_set_update · Action

Update a path-route set on an Oracle Cloud load balancer — replaces the whole set of URL path-routing rules with the supplied array. Asynchronous — returns a work-request id.

Returns: tool_result, path_route_set_name, work_request_id, success, error

08Policy

OCI Load Balancer: List Policies

oracle/loadbalancer/policy_list · Action

List the backend-set load-balancing policies available in a compartment (ROUND_ROBIN, LEAST_CONNECTIONS, IP_HASH) — the valid policy values for a backend set.

Returns: tool_result, policies, count, success, error

09Protocol

OCI Load Balancer: List Protocols

oracle/loadbalancer/protocol_list · Action

List the listener protocols supported in a compartment (HTTP, HTTP2, TCP, GRPC) — the valid protocol values for a load-balancer listener.

Returns: tool_result, protocols, count, success, error

10Routing

OCI Load Balancer: Create Routing Policy

oracle/loadbalancer/routing_policy_create · Action

Add a routing policy — an ordered list of condition→backend-set routing rules — to an Oracle Cloud load balancer. Routing rules apply only to HTTP/HTTPS traffic. Asynchronous.

Returns: tool_result, routing_policy_name, work_request_id, success, error

OCI Load Balancer: Delete Routing Policy

oracle/loadbalancer/routing_policy_delete · Action

Delete a routing policy from an Oracle Cloud load balancer by name. Deletion is asynchronous — returns a work-request id to poll with Get Work Request.

Returns: tool_result, routing_policy_name, work_request_id, success, error

OCI Load Balancer: Get Routing Policy

oracle/loadbalancer/routing_policy_get · Action

Fetch one routing policy of an Oracle Cloud load balancer by name — its condition-language version and ordered rules.

Returns: tool_result, routing_policy, name, success, error

OCI Load Balancer: List Routing Policies

oracle/loadbalancer/routing_policy_list · Action

List the routing policies of an Oracle Cloud load balancer — each with its condition-language version and ordered rules. Walks pagination up to a safe cap.

Returns: tool_result, routing_policies, count, truncated, success, error

OCI Load Balancer: Update Routing Policy

oracle/loadbalancer/routing_policy_update · Action

Update a routing policy on an Oracle Cloud load balancer — replaces the policy's whole ordered list of routing rules with the supplied array. Asynchronous — returns a work-request id.

Returns: tool_result, routing_policy_name, work_request_id, success, error

11Rule

OCI Load Balancer: Create Rule Set

oracle/loadbalancer/rule_set_create · Action

Add a rule set — a named set of HTTP header, redirect and access-control rules — to an Oracle Cloud load balancer. Asynchronous.

Returns: tool_result, rule_set_name, work_request_id, success, error

OCI Load Balancer: Delete Rule Set

oracle/loadbalancer/rule_set_delete · Action

Delete a rule set from an Oracle Cloud load balancer by name. Deletion is asynchronous — returns a work-request id to poll with Get Work Request.

Returns: tool_result, rule_set_name, work_request_id, success, error

OCI Load Balancer: Get Rule Set

oracle/loadbalancer/rule_set_get · Action

Fetch one rule set of an Oracle Cloud load balancer by name — its request/response control rules.

Returns: tool_result, rule_set, name, success, error

OCI Load Balancer: List Rule Sets

oracle/loadbalancer/rule_set_list · Action

List the rule sets configured on an Oracle Cloud load balancer. Synchronous read.

Returns: tool_result, rule_sets, count, success, error

OCI Load Balancer: Update Rule Set

oracle/loadbalancer/rule_set_update · Action

Update a rule set on an Oracle Cloud load balancer — replaces the whole array of rules that compose the set. Asynchronous — returns a work-request id.

Returns: tool_result, rule_set_name, work_request_id, success, error

12Shape

OCI Load Balancer: List Shapes

oracle/loadbalancer/shape_list · Action

List the load-balancer shapes available in a compartment (flexible, 10Mbps, 100Mbps, 400Mbps, …) — the valid shape values for Create Load Balancer.

Returns: tool_result, shapes, count, success, error

13Ssl

OCI Load Balancer: Create SSL Cipher Suite

oracle/loadbalancer/ssl_cipher_suite_create · Action

Add a custom SSL cipher suite — a named list of ciphers the load balancer may negotiate for HTTPS/SSL connections — to an Oracle Cloud load balancer. Asynchronous.

Returns: tool_result, cipher_suite_name, work_request_id, success, error

OCI Load Balancer: Delete SSL Cipher Suite

oracle/loadbalancer/ssl_cipher_suite_delete · Action

Delete a custom SSL cipher suite from an Oracle Cloud load balancer by name. Deletion is asynchronous — returns a work-request id to poll with Get Work Request.

Returns: tool_result, work_request_id, success, error

OCI Load Balancer: Get SSL Cipher Suite

oracle/loadbalancer/ssl_cipher_suite_get · Action

Fetch one SSL cipher suite of an Oracle Cloud load balancer by name — its configured ciphers.

Returns: tool_result, ssl_cipher_suite, name, success, error

OCI Load Balancer: List SSL Cipher Suites

oracle/loadbalancer/ssl_cipher_suite_list · Action

List the SSL cipher suites available on an Oracle Cloud load balancer, including the OCI-reserved oci-* suites. Synchronous read.

Returns: tool_result, ssl_cipher_suites, count, success, error

OCI Load Balancer: Update SSL Cipher Suite

oracle/loadbalancer/ssl_cipher_suite_update · Action

Replace the cipher list of a custom SSL cipher suite on an Oracle Cloud load balancer (Oracle's reserved oci-* suites cannot be updated). Asynchronous.

Returns: tool_result, cipher_suite_name, work_request_id, success, error

14Work

OCI Load Balancer: Get Work Request

oracle/loadbalancer/work_request_get · Action

Read the status of an Oracle Cloud load-balancer work request by OCID. Every asynchronous action returns a work-request id — poll it here until it is SUCCEEDED or FAILED.

Returns: tool_result, work_request, lifecycle_state, load_balancer_id, success, error

OCI Load Balancer: List Work Requests

oracle/loadbalancer/work_request_list · Action

List the work requests recorded for an Oracle Cloud load balancer — each with its type, lifecycle state and message. Walks pagination up to a safe cap.

Returns: tool_result, work_requests, count, truncated, success, error

15Notes & Limitations

Behaviours and constraints worth knowing before you build with these nodes.

• Every create, update and delete action is asynchronous and returns a work-request id rather than the finished resource, so use Get Work Request to poll until the request reaches SUCCEEDED before a later step depends on the change.
• Update actions read the resource's current configuration first and seed any field you leave blank from it, so an optional field left empty keeps its existing value rather than clearing it.
• Sub-resources are addressed by their name within a load balancer rather than by their own OCID — a backend set, listener, hostname or certificate by its name, and an individual backend by its ip:port.
• The Oracle Cloud API has no direct read for an individual listener, so fetch the parent load balancer with Get Load Balancer to see its listeners and their configuration.
• Updates that replace a whole list — routing-policy rules, path routes, rule-set items and network security groups — overwrite the entire existing set with what you supply rather than merging, so include every entry you want to keep; to remove all of a load balancer's network security groups, supply an empty list.
• A certificate bundle is immutable and cannot be deleted while a listener or backend set still references it, so update SSL by first re-pointing the reference, then deleting and recreating the bundle.