Schemas
scaleway.lb.v1.Acl
idACL ID.
nameACL name.
ACL match filter object. One of ip_subnet, ips_edge_services or http_filter & http_filter_value are required.
Action to take when incoming traffic matches an ACL filter.
ACL is attached to this frontend object.
indexPriority of this ACL (ACLs are applied in ascending order, 0 is the first ACL executed).
created_atDate on which the ACL was created. (RFC 3339 format)
updated_atDate on which the ACL was last updated. (RFC 3339 format)
descriptionACL description.
scaleway.lb.v1.AclAction
typeAction to take when incoming traffic matches an ACL filter.
Redirection parameters when using an ACL with a redirect action.
scaleway.lb.v1.AclActionRedirect
typeRedirect type.
targetRedirect target. For a location redirect, you can use a URL e.g. https://scaleway.com. Using a scheme name (e.g. https, http, ftp, git) will replace the request's original scheme. This can be useful to implement HTTP to HTTPS redirects. Valid placeholders that can be used in a location redirect to preserve parts of the original request in the redirection URL are {{host}}, {{query}}, {{path}} and {{scheme}}.
codeHTTP redirect code to use. Valid values are 301, 302, 303, 307 and 308. Default value is 302.
scaleway.lb.v1.AclActionRedirect.RedirectType
scaleway.lb.v1.AclHttpFilter
scaleway.lb.v1.AclMatch
ip_subnetList of IPs or CIDR v4/v6 addresses to filter for from the client side.
ips_edge_servicesDefines whether Edge Services IPs should be matched. If set to true, restricts all connections except for Edge Services.
http_filterType of HTTP filter to match. Extracts the request's URL path, which starts at the first slash and ends before the question mark (without the host part). Defines where to filter for the http_filter_value. Only supported for HTTP backends.
http_filter_valueList of values to filter for.
http_filter_optionName of the HTTP header to filter on if http_header_match was selected in http_filter.
invertDefines whether to invert the match condition. If set to true, the ACL carries out its action when the condition DOES NOT match.
scaleway.lb.v1.AclSpec
nameACL name.
Action to take when incoming traffic matches an ACL filter.
indexPriority of this ACL (ACLs are applied in ascending order, 0 is the first ACL executed).
ACL match filter object. One of ip_subnet, ips_edge_services or http_filter and http_filter_value are required.
descriptionACL description.
scaleway.lb.v1.Backend
idBackend ID.
nameName of the backend.
forward_protocolProtocol used by the backend when forwarding traffic to backend servers.
forward_portPort used by the backend when forwarding traffic to backend servers.
forward_port_algorithmLoad balancing algorithm to use when determining which backend server to forward new traffic to.
sticky_sessionsDefines whether sticky sessions (binding a particular session to a particular backend server) are activated and the method to use if so. None disables sticky sessions. Cookie-based uses an HTTP cookie to stick a session to a backend server. Table-based uses the source (client) IP address to stick a session to a backend server.
sticky_sessions_cookie_nameCookie name for cookie-based sticky sessions.
Object defining the health check to be carried out by the backend when checking the status and health of backend servers.
poolList of IP addresses of backend servers attached to this backend.
Load Balancer the backend is attached to.
timeout_serverMaximum allowed time for a backend server to process a request. (in milliseconds)
timeout_connectMaximum allowed time for establishing a connection to a backend server. (in milliseconds)
timeout_tunnelMaximum allowed tunnel inactivity time after Websocket is established (takes precedence over client and server timeout). (in milliseconds)
on_marked_down_actionAction to take when a backend server is marked as down.
proxy_protocolProtocol to use between the Load Balancer and backend servers. Allows the backend servers to be informed of the client's real IP address. The PROXY protocol must be supported by the backend servers' software.
created_atDate at which the backend was created. (RFC 3339 format)
updated_atDate at which the backend was updated. (RFC 3339 format)
failover_hostScaleway Object Storage bucket website to be served as failover if all backend servers are down, e.g. failover-website.s3-website.fr-par.scw.cloud.
ssl_bridgingDefines whether to enable SSL bridging between the Load Balancer and backend servers.
ignore_ssl_server_verifyDefines whether the server certificate verification should be ignored.
redispatch_attempt_countWhether to use another backend server on each attempt.
max_retriesNumber of retries when a backend server connection failed.
max_connectionsMaximum number of connections allowed per backend server.
timeout_queueMaximum time for a request to be left pending in queue when max_connections is reached. (in seconds)
send_proxy_v2Deprecated in favor of proxy_protocol field.
scaleway.lb.v1.BackendServerStats
instance_idID of your Load Balancer's underlying Instance.
backend_idBackend ID.
ipIPv4 or IPv6 address of the backend server.
server_stateServer operational state (stopped/starting/running/stopping).
server_state_changed_atTime since last operational change. (RFC 3339 format)
last_health_check_statusLast health check status (unknown/neutral/failed/passed/condpass).
scaleway.lb.v1.BackendServerStats.HealthCheckStatus
scaleway.lb.v1.BackendServerStats.ServerState
scaleway.lb.v1.Certificate
typeCertificate type (Let's Encrypt or custom).
idCertificate ID.
common_nameMain domain name of certificate.
subject_alternative_nameAlternative domain names.
fingerprintIdentifier (SHA-1) of the certificate.
not_valid_beforeLower validity bound. (RFC 3339 format)
not_valid_afterUpper validity bound. (RFC 3339 format)
statusCertificate status.
Load Balancer object the certificate is attached to.
nameCertificate name.
created_atDate on which the certificate was created. (RFC 3339 format)
updated_atDate on which the certificate was last updated. (RFC 3339 format)
status_detailsAdditional information about the certificate status (useful in case of certificate generation failure, for example).
scaleway.lb.v1.Certificate.Type
scaleway.lb.v1.CreateCertificateRequest.CustomCertificate
certificate_chainFull PEM-formatted certificate, consisting of the entire certificate chain including public key, private key, and (optionally) Certificate Authorities.
scaleway.lb.v1.CreateCertificateRequest.LetsencryptConfig
common_nameMain domain name of certificate (this domain must exist and resolve to your Load Balancer IP address).
subject_alternative_nameAlternative domain names (all domain names must exist and resolve to your Load Balancer IP address).
scaleway.lb.v1.ForwardPortAlgorithm
scaleway.lb.v1.Frontend
idFrontend ID.
nameName of the frontend.
inbound_portPort the frontend listens on.
Backend object the frontend is attached to.
Load Balancer object the frontend is attached to.
timeout_clientMaximum allowed inactivity time on the client side. (in milliseconds)
certificate_idsList of SSL/TLS certificate IDs to bind to the frontend.
created_atDate on which the frontend was created. (RFC 3339 format)
updated_atDate on which the frontend was last updated. (RFC 3339 format)
enable_http3Defines whether to enable HTTP/3 protocol on the frontend.
connection_rate_limitRate limit for new connections established on this frontend. Use 0 value to disable, else value is connections per second.
enable_access_logsDefines whether to enable access logs on the frontend.
Certificate, deprecated in favor of certificate_ids array.
scaleway.lb.v1.HealthCheck
portPort to use for the backend server health check.
check_delayTime to wait between two consecutive health checks. (in milliseconds)
check_timeoutMaximum time a backend server has to reply to the health check. (in milliseconds)
check_max_retriesNumber of consecutive unsuccessful health checks after which the server will be considered dead.
Object to configure a basic TCP health check.
Object to configure a MySQL health check. The check requires MySQL >=3.22 or <9.0. For older or newer versions, use a TCP health check.
Object to configure a PostgreSQL health check.
Object to configure an LDAP health check. The response is analyzed to find the LDAPv3 response message.
Object to configure a Redis health check. The response is analyzed to find the +PONG response message.
Object to configure an HTTP health check.
Object to configure an HTTPS health check.
check_send_proxyDefines whether proxy protocol should be activated for the health check.
transient_check_delayTime to wait between two consecutive health checks when a backend server is in a transient state (going UP or DOWN). (in seconds)
scaleway.lb.v1.HealthCheck.HttpConfig
uriHTTP path used for the health check. The HTTP path to use when performing a health check on backend servers.
methodHTTP method used for the health check. The HTTP method used when performing a health check on backend servers.
codeHTTP response code expected for a successful health check. The HTTP response code that should be returned for a health check to be considered successful.
host_headerHTTP host header used for the health check. The HTTP host header used when performing a health check on backend servers.
scaleway.lb.v1.HealthCheck.HttpsConfig
uriHTTP path used for the health check. The HTTP path to use when performing a health check on backend servers.
methodHTTP method used for the health check. The HTTP method used when performing a health check on backend servers.
codeHTTP response code expected for a successful health check. The HTTP response code that should be returned for a health check to be considered successful.
host_headerHTTP host header used for the health check. The HTTP host header used when performing a health check on backend servers.
sniSNI used for SSL health checks. The SNI value used when performing a health check on backend servers over SSL.
scaleway.lb.v1.Instance
idUnderlying Instance ID.
statusInstance status.
ip_addressInstance IP address.
created_atDate on which the Instance was created. (RFC 3339 format)
updated_atDate on which the Instance was last updated. (RFC 3339 format)
zoneThe zone the Instance is in.
regionThe region the Instance is in.
scaleway.lb.v1.Instance.Status
scaleway.lb.v1.Ip
idIP address ID.
ip_addressIP address.
organization_idOrganization ID of the Scaleway Organization the IP address is in.
project_idProject ID of the Scaleway Project the IP address is in.
lb_idLoad Balancer ID.
reverseReverse DNS (domain name) of the IP address.
tagsIP tags.
zoneThe zone the IP address is in.
regionThe region the IP address is in.
scaleway.lb.v1.Lb
idUnderlying Instance ID.
nameLoad Balancer name.
descriptionLoad Balancer description.
statusLoad Balancer status.
List of underlying Instances.
organization_idScaleway Organization ID.
project_idScaleway Project ID.
List of IP addresses attached to the Load Balancer.
tagsLoad Balancer tags.
frontend_countNumber of frontends the Load Balancer has.
backend_countNumber of backends the Load Balancer has.
typeLoad Balancer offer type.
Subscriber information.
ssl_compatibility_levelDetermines the minimal SSL version which needs to be supported on client side.
created_atDate on which the Load Balancer was created. (RFC 3339 format)
updated_atDate on which the Load Balancer was last updated. (RFC 3339 format)
private_network_countNumber of Private Networks attached to the Load Balancer.
route_countNumber of routes configured on the Load Balancer.
zoneThe zone the Load Balancer is in.
regionThe region the Load Balancer is in.
scaleway.lb.v1.Lb.Status
scaleway.lb.v1.LbType
nameLoad Balancer commercial offer type name.
stock_statusCurrent stock status for a given Load Balancer type.
bandwidthMaximum bandwidth for a given Load Balancer type.
multicloudAbility to handle backend servers outside Scaleway for a given Load Balancer type.
descriptionLoad Balancer commercial offer type description.
zoneThe zone the Load Balancer stock is in.
regionThe region the Load Balancer stock is in.
scaleway.lb.v1.LbType.Stock
scaleway.lb.v1.ListAclRequest.OrderBy
scaleway.lb.v1.ListAclResponse
List of ACL objects.
total_countThe total number of objects.
scaleway.lb.v1.ListBackendStatsResponse
List of objects containing backend server statistics.
total_countThe total number of objects.
scaleway.lb.v1.ListBackendsRequest.OrderBy
scaleway.lb.v1.ListBackendsResponse
List of backend objects of a given Load Balancer.
total_countTotal count of backend objects, without pagination.
scaleway.lb.v1.ListCertificatesRequest.OrderBy
scaleway.lb.v1.ListCertificatesResponse
List of certificate objects.
total_countThe total number of objects.
scaleway.lb.v1.ListFrontendsRequest.OrderBy
scaleway.lb.v1.ListFrontendsResponse
List of frontend objects of a given Load Balancer.
total_countTotal count of frontend objects, without pagination.
scaleway.lb.v1.ListIpsResponse
List of IP address objects.
total_countTotal count of IP address objects, without pagination.
scaleway.lb.v1.ListLbPrivateNetworksResponse
List of Private Network objects attached to the Load Balancer.
total_countTotal number of objects in the response.
scaleway.lb.v1.ListLbTypesResponse
List of Load Balancer commercial offer type objects.
total_countTotal number of Load Balancer offer type objects.
scaleway.lb.v1.ListLbsRequest.OrderBy
scaleway.lb.v1.ListLbsResponse
List of Load Balancer objects.
total_countThe total number of Load Balancer objects.
scaleway.lb.v1.ListPrivateNetworksRequest.OrderBy
scaleway.lb.v1.ListRoutesRequest.OrderBy
scaleway.lb.v1.ListRoutesResponse
List of route objects.
total_countThe total number of route objects.
scaleway.lb.v1.ListSubscriberRequest.OrderBy
scaleway.lb.v1.ListSubscriberResponse
List of subscriber objects.
total_countThe total number of objects.
scaleway.lb.v1.OnMarkedDownAction
scaleway.lb.v1.PrivateNetwork
Load Balancer object which is attached to the Private Network.
ipam_idsIPAM IDs of the booked IP addresses. (UUID format)
private_network_idPrivate Network ID.
statusStatus of Private Network connection.
created_atDate on which the Private Network was created. (RFC 3339 format)
updated_atDate on which the PN was last updated. (RFC 3339 format)
Object containing an array of a local IP address for the Load Balancer on this Private Network.
Object containing DHCP-assigned IP addresses.
scaleway.lb.v1.PrivateNetwork.StaticConfig
ip_addressArray of a local IP address for the Load Balancer on this Private Network.
scaleway.lb.v1.PrivateNetwork.Status
scaleway.lb.v1.ProxyProtocol
scaleway.lb.v1.Route
idRoute ID.
frontend_idID of the source frontend.
backend_idID of the target backend.
Object defining the match condition for a route to be applied. If an incoming client session matches the specified condition (i.e. it has a matching SNI value or HTTP Host header value), it will be passed to the target backend.
created_atDate on which the route was created. (RFC 3339 format)
updated_atDate on which the route was last updated. (RFC 3339 format)
scaleway.lb.v1.Route.Match
sniServer Name Indication (SNI) value to match. Value to match in the Server Name Indication TLS extension (SNI) field from an incoming connection made via an SSL/TLS transport layer. This field should be set for routes on TCP Load Balancers.
host_headerHTTP host header to match. Value to match in the HTTP Host request header from an incoming request. This field should be set for routes on HTTP Load Balancers.
match_subdomainsIf true, all subdomains will match.
path_beginPath begin value to match. Value to match in the URL beginning path from an incoming request.
scaleway.lb.v1.SSLCompatibilityLevel
scaleway.lb.v1.SetAclsResponse
List of ACL objects.
total_countThe total number of ACL objects.