Upstream Groups

An upstream group contains origin targets and their health check settings. Select an operation to review its inputs and responses.

Guide: Configure origins and health checks

Concepts: Upstreams

📄️ List upstream groups associated with your account

Returns the list of upstream groups associated with your account.

📄️ Creates a new upstream group (backend pool)

Creates a new upstream group (backend pool) with health check configuration.

📄️ Delete an upstream group

Delete an upstream group. Validates no load balancer groups or routes reference it, then cascade deletes all associated upstreams and their status/events/reports.

📄️ Get an upstream group

Returns details of an upstream group including health check configuration and inline upstreams summary.

📄️ Update an upstream group configuration

Update an upstream group configuration.

📄️ List upstreams (backend servers) in an upstream group

Returns the list of upstreams (backend servers) in an upstream group.

📄️ Adds a backend target to an upstream group

Adds a backend target to an upstream group.

📄️ Remove a backend server from an upstream group

Remove a backend server from an upstream group.

📄️ Get details of a single upstream

Get details of a single upstream.

📄️ Update an upstream's name, health check address, or disabled state

Update an upstream's name, health check address, or disabled state.

📄️ Returns the health check event history for an upstream

Returns the health check event history for an upstream.

📄️ Returns aggregated performance report data for an upstream

Returns aggregated performance report data for an upstream, broken down by location.

📄️ Returns the per-location health check status for an upstream

Returns the per-location health check status for an upstream.