List an LB's middlewares.

GET

/v1/projects/{projectId}/lb/load-balancers/{loadBalancerId}/middlewares

Code sample: Shell / cURL

curl --request GET \
  --url 'https://stratum.example.com/v1/projects/example/lb/load-balancers/example/middlewares?limit=100' \
  --header 'Authorization: Bearer <token>'

• A Stratum cluster endpoint.

Cursor-paginated. Ordered name, id.

Ordering on name alone is not total, so id is the tiebreaker. Without a unique tiebreaker a cursor sitting on a tie repeats or skips a row.

When nextPageToken is present there are more rows; pass it back as page_token. A token that cannot be parsed is treated as no token, so a client gets the first page rather than a 400.

This endpoint returned every matching row with no limit of any kind until .

Authorizations

• bearerAuth

Parameters

Path Parameters

projectId

required

string

/^p-[a-z0-9-]+$/

loadBalancerId

required

string

/^lb-[a-z0-9]+$/

Query Parameters

limit

integer

default: 100 >= 1 <= 500

page_token

string

Opaque cursor from a previous response’s nextPageToken. Omit for the first page.

Responses

200

Middlewares.

Media typeapplication/json

object

items

required

Array<object>

A named request/response filter on an LB (slice F). One of the 16 data-plane kinds; config is kind-specific and validated by the data plane.

object

id

required

string

/^mw-[a-z0-9]+$/

loadBalancerId

required

string

name

required

string

kind

required

string

Allowed values: header_rewrite redirect strip_prefix compress basic_auth request_body_limit rate_limit ip_allow ip_deny regex_deny geo_block retry_on_status circuit_breaker forward_auth cache security_headers

config

required

Kind-specific configuration.

object

key

additional properties

any

createdAt

string format: date-time

updatedAt

string format: date-time

nextPageToken

string

Example

{
  "items": [
    {
      "kind": "header_rewrite"
    }
  ]
}