Cloudflare Load Balancer Pool

Group origin servers into a reusable, health-checked pool that load balancers steer traffic to.

What Gets Created

  • A cloudflare_load_balancer_pool (account-scoped) with its origins, optional monitor reference, check regions, load-shedding, origin steering, and notification filters.

Prerequisites

  • A Cloudflare account ID.
  • The Load Balancing add-on enabled on the account (paid add-on) — otherwise the Load Balancing API returns 403.
  • An API token with Account → Load Balancing: Monitors and Pools → Edit (pools are account-scoped).
  • Optionally, a CloudflareLoadBalancerMonitor to health-check the origins. When a monitor is attached, origin addresses must be globally routable (Cloudflare rejects reserved / non-routable IPs), and checkRegions is capped by plan tier.

Configuration Reference

Required

  • accountId, name, origins[] (each with name + address).

Optional

  • origins[]: weight, enabled, port, hostHeader, virtualNetworkId, flattenCname.
  • monitor, checkRegions, enabled, minimumOrigins, latitude, longitude, loadShedding, originSteering, notificationFilter.

Stack Outputs

OutputDescription
pool_idThe pool ID
pool_nameThe pool name
  • CloudflareLoadBalancerMonitor
  • CloudflareLoadBalancer

Next article

Cloudflare Origin CA Certificate

Cloudflare Origin CA Certificate Issue a free Cloudflare Origin CA certificate to encrypt the connection between Cloudflare's edge and your origin server (the "Full (Strict)" SSL mode). What Gets Created A cloudflareorigincacertificate valid for the requested hostnames. When no CSR is supplied: a generated private key + CSR (via the tls provider), with the key exported as a sensitive output. Prerequisites A Cloudflare API token with SSL and Certificates permission (the deprecated Origin CA Key...
Read next article