# lb-api ## Pages - [Load Balancers API](https://docs.ezghcloud.com/lb-api/index.md) — One public IPv4 address in front of a VPC's instances, with TCP, TLS, HTTP and HTTPS listeners and target groups. Every path is under an organization; lists are paged with limit, cursor and nextCursor. - [Cancel an operation](https://docs.ezghcloud.com/lb-api/CancelOperation/index.md) — 409 operation_finished or operation_not_cancellable when it can't be cancelled. - [Create a listener](https://docs.ezghcloud.com/lb-api/CreateListener/index.md) — 409 protocol_mismatch when a target group's protocol doesn't suit the listener (http groups for http and https listeners, tcp groups for tcp and tls), 409 rule_limit past 100 rules, and 409 target_group_not_found when an action names a target group that isn't this load balancer's or doesn't exist. - [Create a load balancer](https://docs.ezghcloud.com/lb-api/CreateLoadBalancer/index.md) — Asynchronous: answers 202 with the operation that creates it, which takes minutes. With ipv6: true, or with no ipv4Address, the operation fails with 409 ipv6_unavailable if IPv6 can't be given to the load balancer; one with an ipv4Address that left ipv6 out is made with IPv4 only instead. It fails with 409 subnet_has_no_gateway_route without each family's route to the subnet's Network Gateway. - [Create a target group](https://docs.ezghcloud.com/lb-api/CreateTargetGroup/index.md) - [Delete a listener](https://docs.ezghcloud.com/lb-api/DeleteListener/index.md) - [Delete a load balancer](https://docs.ezghcloud.com/lb-api/DeleteLoadBalancer/index.md) — Asynchronous. Removes its listeners and leaves its target groups unused. 409 load_balancer_referenced while a firewall rule names it. - [Delete a target group](https://docs.ezghcloud.com/lb-api/DeleteTargetGroup/index.md) — 409 target_group_in_use while a listener uses it. - [Deregister a target](https://docs.ezghcloud.com/lb-api/DeregisterTarget/index.md) — The target drains, and goes when the group's deregistration delay ends. - [Get a listener](https://docs.ezghcloud.com/lb-api/GetListener/index.md) - [Get a load balancer](https://docs.ezghcloud.com/lb-api/GetLoadBalancer/index.md) - [Get an operation (poll it until it finishes)](https://docs.ezghcloud.com/lb-api/GetOperation/index.md) — While it's queued or running, Retry-After suggests when to poll again. Not recorded in Trails. - [Get a target group](https://docs.ezghcloud.com/lb-api/GetTargetGroup/index.md) - [List a load balancer's listeners, newest first](https://docs.ezghcloud.com/lb-api/ListListeners/index.md) - [List a project's load balancers, newest first](https://docs.ezghcloud.com/lb-api/ListLoadBalancers/index.md) - [List the organization's operations, newest first](https://docs.ezghcloud.com/lb-api/ListOperations/index.md) - [List a project's target groups, newest first](https://docs.ezghcloud.com/lb-api/ListTargetGroups/index.md) - [List a target group's targets, newest first](https://docs.ezghcloud.com/lb-api/ListTargets/index.md) - [Register a target](https://docs.ezghcloud.com/lb-api/RegisterTarget/index.md) - [Change a listener](https://docs.ezghcloud.com/lb-api/UpdateListener/index.md) — Takes If-Match (optional): 412 precondition_failed when the listener has changed since. 409 protocol_mismatch, rule_limit and target_group_not_found as for a create. - [Change a load balancer's name, description, tags or IPv6](https://docs.ezghcloud.com/lb-api/UpdateLoadBalancer/index.md) — 409 load_balancer_provisioning while it isn't active yet, for a change of ipv6. lastChange tracks IPv6 being turned on or off. - [Change a target group](https://docs.ezghcloud.com/lb-api/UpdateTargetGroup/index.md) - [Action](https://docs.ezghcloud.com/lb-api/schemas/Action/index.md) — type names the one of forward, redirect and fixedResponse that is set; the others are null. - [ActionInput](https://docs.ezghcloud.com/lb-api/schemas/ActionInput/index.md) — type names the one of forward, redirect and fixedResponse that is set; the others are null. - [Error](https://docs.ezghcloud.com/lb-api/schemas/Error/index.md) — Every non-2xx answer. Clients branch on code, never on message. - [FixedResponse](https://docs.ezghcloud.com/lb-api/schemas/FixedResponse/index.md) - [FixedResponseInput](https://docs.ezghcloud.com/lb-api/schemas/FixedResponseInput/index.md) - [Forward](https://docs.ezghcloud.com/lb-api/schemas/Forward/index.md) - [ForwardInput](https://docs.ezghcloud.com/lb-api/schemas/ForwardInput/index.md) - [HeaderEdit](https://docs.ezghcloud.com/lb-api/schemas/HeaderEdit/index.md) - [HeaderModifier](https://docs.ezghcloud.com/lb-api/schemas/HeaderModifier/index.md) — As Gateway API's header modifier filter: removes, then sets, then adds. Names are HTTP tokens, case-insensitive and once each per list; content-length, transfer-encoding, connection, upgrade, keep-alive and te can't be named. - [HeaderModifierInput](https://docs.ezghcloud.com/lb-api/schemas/HeaderModifierInput/index.md) — As Gateway API's header modifier filter: removes, then sets, then adds. Names are HTTP tokens, case-insensitive and once each per list; content-length, transfer-encoding, connection, upgrade, keep-alive and te can't be named. - [HealthCheck](https://docs.ezghcloud.com/lb-api/schemas/HealthCheck/index.md) - [HealthCheckInput](https://docs.ezghcloud.com/lb-api/schemas/HealthCheckInput/index.md) - [LastChange](https://docs.ezghcloud.com/lb-api/schemas/LastChange/index.md) - [Listener](https://docs.ezghcloud.com/lb-api/schemas/Listener/index.md) - [ListenerCreate](https://docs.ezghcloud.com/lb-api/schemas/ListenerCreate/index.md) - [ListenerList](https://docs.ezghcloud.com/lb-api/schemas/ListenerList/index.md) - [ListenerUpdate](https://docs.ezghcloud.com/lb-api/schemas/ListenerUpdate/index.md) - [LoadBalancer](https://docs.ezghcloud.com/lb-api/schemas/LoadBalancer/index.md) - [LoadBalancerCreate](https://docs.ezghcloud.com/lb-api/schemas/LoadBalancerCreate/index.md) - [LoadBalancerList](https://docs.ezghcloud.com/lb-api/schemas/LoadBalancerList/index.md) - [LoadBalancerUpdate](https://docs.ezghcloud.com/lb-api/schemas/LoadBalancerUpdate/index.md) - [LoadBalancerWaf](https://docs.ezghcloud.com/lb-api/schemas/LoadBalancerWaf/index.md) - [Match](https://docs.ezghcloud.com/lb-api/schemas/Match/index.md) — Fields AND together. Entries OR within hosts, paths and methods, and AND within headers and queryParams. An empty field matches anything. - [MatchInput](https://docs.ezghcloud.com/lb-api/schemas/MatchInput/index.md) — Fields AND together. Entries OR within hosts, paths and methods, and AND within headers and queryParams. An empty field matches anything. - [NameValue](https://docs.ezghcloud.com/lb-api/schemas/NameValue/index.md) - [Operation](https://docs.ezghcloud.com/lb-api/schemas/Operation/index.md) - [OperationList](https://docs.ezghcloud.com/lb-api/schemas/OperationList/index.md) - [OperationStatus](https://docs.ezghcloud.com/lb-api/schemas/OperationStatus/index.md) - [PathMatch](https://docs.ezghcloud.com/lb-api/schemas/PathMatch/index.md) - [QuotaExceeded](https://docs.ezghcloud.com/lb-api/schemas/QuotaExceeded/index.md) — quota_exceeded: the quota that refused the request. Never with Retry-After. - [Redirect](https://docs.ezghcloud.com/lb-api/schemas/Redirect/index.md) — Each part set replaces the request's, and null keeps it; the query is always kept. At least one of scheme, host, port and path is set. - [RedirectInput](https://docs.ezghcloud.com/lb-api/schemas/RedirectInput/index.md) — Each part set replaces the request's, and null keeps it; the query is always kept. At least one of scheme, host, port and path is set. - [Rule](https://docs.ezghcloud.com/lb-api/schemas/Rule/index.md) - [RuleInput](https://docs.ezghcloud.com/lb-api/schemas/RuleInput/index.md) - [Tags](https://docs.ezghcloud.com/lb-api/schemas/Tags/index.md) — At most 50; keys 1-128 characters, values at most 256, keys starting with ezgh: are reserved. - [Target](https://docs.ezghcloud.com/lb-api/schemas/Target/index.md) - [TargetCreate](https://docs.ezghcloud.com/lb-api/schemas/TargetCreate/index.md) - [TargetGroup](https://docs.ezghcloud.com/lb-api/schemas/TargetGroup/index.md) - [TargetGroupCreate](https://docs.ezghcloud.com/lb-api/schemas/TargetGroupCreate/index.md) - [TargetGroupList](https://docs.ezghcloud.com/lb-api/schemas/TargetGroupList/index.md) - [TargetGroupUpdate](https://docs.ezghcloud.com/lb-api/schemas/TargetGroupUpdate/index.md) - [TargetList](https://docs.ezghcloud.com/lb-api/schemas/TargetList/index.md) - [WeightedTargetGroup](https://docs.ezghcloud.com/lb-api/schemas/WeightedTargetGroup/index.md) - [WeightedTargetGroupInput](https://docs.ezghcloud.com/lb-api/schemas/WeightedTargetGroupInput/index.md)