List a load balancer's listeners.

GET

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

Code sample: Shell / cURL

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

• A Stratum cluster endpoint.

Cursor-paginated. Ordered port, id.

The id is the tiebreaker that makes the order total: ordering on port alone leaves rows sharing a port in an arbitrary relative order, and a cursor on that boundary repeats or skips one.

This endpoint returned every listener 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

Listeners.

Media typeapplication/json

object

items

required

Array<object>

object

ownedBy

Set when a platform resource manages this row; absent on a tenant’s own.

object

kind

required

string

Allowed values: auto-scaling-group platform

id

required

The owner: the Auto Scaling group id, or for platform the component (front-door, pack:platform-health, default-network, operator-recipe).

string

id

required

string

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

loadBalancerId

required

string

port

required

integer

>= 1 <= 65535

protocol

required

string

Allowed values: HTTP HTTPS http https

defaultAction

required

object

key

additional properties

any

sslPolicy

string

nullable

enableHttp3

boolean

bindAddress

string

nullable

state

required

string

createdAt

string format: date-time

updatedAt

string format: date-time

nextPageToken

string

Example

{
  "items": [
    {
      "ownedBy": {
        "kind": "auto-scaling-group"
      },
      "protocol": "HTTP"
    }
  ]
}