List a load balancer's listeners, newest first
https://lb-api.ezghcloud.com/v1/organizations/{orgId}/projects/{projectId}/load-balancers/{loadBalancer}/listenersAuthorization
Path parameters
Query parameters
Returns
200
A page of listeners.
- listenersarray ofobject{ … }required
13 properties
An http or https listener's action for a request no rule matches. Null on tcp and tls.
2 variants
One of the following:
- Action{ … }
4 properties
2 variants
One of the following:
- null
- typeforwardorredirectorfixedResponserequired
- null
- rulesarray ofobject{ … }required
Ordered: the first rule that matches a request acts on it, and the default action takes the rest. At most 100. Sent, it replaces the whole list. Empty on tcp and tls.
3 properties
- actionobject{ … }required
type names the one of forward, redirect and fixedResponse that is set; the others are null.
4 properties
2 variants
One of the following:
- FixedResponse{ … }
3 properties
- bodystringrequired
UTF-8, at most 1024 bytes. Default empty.
- contentTypetext/plainortext/htmlorapplication/jsonrequired
Default text/plain.
- statusCodeintegerrequiredmaximum: 599, minimum: 200
- null
2 variants
One of the following:
- Forward{ … }
3 properties
Changes the request's headers before it goes to the target.
2 variants
One of the following:
- null
Changes the target's response headers before they reach the client.
2 variants
One of the following:
- null
- targetGroupsarray ofobject{ … }required
Each request picks a group by weight; the sum of weights is above 0.
2 properties
- targetGroupstringrequired
An http target group of the listener's load balancer.
- weightintegerrequired
Required with more than one group; 0 never receives.
maximum: 999, minimum: 0
- null
2 variants
One of the following:
- Redirect{ … }
5 properties
- hoststring | nullrequiredmaxLength: 253
- pathstring | nullrequiredmaxLength: 1024
- portinteger | nullrequiredmaximum: 65535, minimum: 1
- schemehttporhttpsornullrequired
- statusCode301or302or307or308required
Default 302.
- null
400
invalid_request (with issues), invalid_cursor, or the endpoint's own 400 codes.
401
unauthenticated: no credential, or one that doesn't check out.
403
access_denied: the caller's policies don't allow the action; forbidden_origin: a cookie-authenticated write from an origin that isn't allowed; spend_limit_reached.
404
not_found: unknown, malformed, or in an organization the caller isn't in.
429
too_many_requests, with Retry-After; or quota_exceeded (a rate, usage or concurrency quota, with quota), never with Retry-After.
500
internal_error: a bug; the details are in the logs, under the request ID.
503
unavailable: a dependency the request needs is down. Retry after Retry-After.