Copy page

Commands

Documentation for `scw lb`

This API allows you to manage your Scaleway Load Balancer services.

Access Control List (ACL) management commands

Access Control List (ACL) management commands.

Create an ACL for a given frontend

Create a new ACL for a given frontend. Each ACL must have a name, an action to perform (allow or deny), and a match rule (the action is carried out when the incoming traffic matches the rule).

Usage:

Code
scw lb acl create [arg=value ...]

Arguments:

Name	Description	Argument Specifications
frontend-id	Frontend ID to attach the ACL to	Required
name	ACL name	Required Default: <generated>
action.type	Action to take when incoming traffic matches an ACL filter	One of: allow, deny, redirect
action.redirect.type	Redirect type	One of: location, scheme
action.redirect.target	Redirect 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}}
action.redirect.code	HTTP redirect code to use. Valid values are 301, 302, 303, 307 and 308. Default value is 302
match.ip-subnet.{index}	List of IPs or CIDR v4/v6 addresses to filter for from the client side
match.ips-edge-services	Defines whether Edge Services IPs should be matched. If set to true, restricts all connections except for Edge Services
match.http-filter	Type 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	One of: acl_http_filter_none, path_begin, path_end, regex, http_header_match
match.http-filter-value.{index}	List of values to filter for
match.http-filter-option	Name of the HTTP header to filter on if http_header_match was selected in http_filter
match.invert	Defines whether to invert the match condition. If set to true, the ACL carries out its action when the condition DOES NOT match
index	Priority of this ACL (ACLs are applied in ascending order, 0 is the first ACL executed)	Required
description	ACL description
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Delete an ACL

Delete an ACL, specified by its ACL ID. Deleting an ACL is irreversible and cannot be undone.

Usage:

Code
scw lb acl delete <acl-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
acl-id	ACL ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Get an ACL

Get information for a particular ACL, specified by its ACL ID. The response returns full details of the ACL, including its name, action, match rule and frontend.

Usage:

Code
scw lb acl get <acl-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
acl-id	ACL ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

List ACLs for a given frontend

List the ACLs for a given frontend, specified by its frontend ID. The response is an array of ACL objects, each one representing an ACL that denies or allows traffic based on certain conditions.

Usage:

Code
scw lb acl list [arg=value ...]

Arguments:

Name	Description	Argument Specifications
frontend-id	Frontend ID (ACLs attached to this frontend will be returned in the response)	Required
order-by	Sort order of ACLs in the response	One of: created_at_asc, created_at_desc, name_asc, name_desc
name	ACL name to filter for
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3, all

Define all ACLs for a given frontend

For a given frontend specified by its frontend ID, define and add the complete set of ACLS for that frontend. Any existing ACLs on this frontend will be removed.

Usage:

Code
scw lb acl set [arg=value ...]

Arguments:

Name	Description	Argument Specifications
acls.{index}.name	ACL name	Required
acls.{index}.action.type	Action to take when incoming traffic matches an ACL filter	One of: allow, deny, redirect
acls.{index}.action.redirect.type	Redirect type	One of: location, scheme
acls.{index}.action.redirect.target	Redirect 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}}
acls.{index}.action.redirect.code	HTTP redirect code to use. Valid values are 301, 302, 303, 307 and 308. Default value is 302
acls.{index}.match.ip-subnet.{index}	List of IPs or CIDR v4/v6 addresses to filter for from the client side
acls.{index}.match.ips-edge-services	Defines whether Edge Services IPs should be matched. If set to true, restricts all connections except for Edge Services
acls.{index}.match.http-filter	Type 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	One of: acl_http_filter_none, path_begin, path_end, regex, http_header_match
acls.{index}.match.http-filter-value.{index}	List of values to filter for
acls.{index}.match.http-filter-option	Name of the HTTP header to filter on if http_header_match was selected in http_filter
acls.{index}.match.invert	Defines whether to invert the match condition. If set to true, the ACL carries out its action when the condition DOES NOT match
acls.{index}.index	Priority of this ACL (ACLs are applied in ascending order, 0 is the first ACL executed)	Required
acls.{index}.description	ACL description
frontend-id	Frontend ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Update an ACL

Update a particular ACL, specified by its ACL ID. You can update details including its name, action and match rule.

Usage:

Code
scw lb acl update <acl-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
acl-id	ACL ID	Required
name	ACL name	Required
action.type	Action to take when incoming traffic matches an ACL filter	One of: allow, deny, redirect
action.redirect.type	Redirect type	One of: location, scheme
action.redirect.target	Redirect 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}}
action.redirect.code	HTTP redirect code to use. Valid values are 301, 302, 303, 307 and 308. Default value is 302
match.ip-subnet.{index}	List of IPs or CIDR v4/v6 addresses to filter for from the client side
match.ips-edge-services	Defines whether Edge Services IPs should be matched. If set to true, restricts all connections except for Edge Services
match.http-filter	Type 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	One of: acl_http_filter_none, path_begin, path_end, regex, http_header_match
match.http-filter-value.{index}	List of values to filter for
match.http-filter-option	Name of the HTTP header to filter on if http_header_match was selected in http_filter
match.invert	Defines whether to invert the match condition. If set to true, the ACL carries out its action when the condition DOES NOT match
index	Priority of this ACL (ACLs are applied in ascending order, 0 is the first ACL executed)	Required
description	ACL description
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Backend management commands

Backend management commands.

Add a set of backend servers to a given backend

For a given backend specified by its backend ID, add a set of backend servers (identified by their IP addresses) it should forward traffic to. These will be appended to any existing set of backend servers for this backend.

Usage:

Code
scw lb backend add-servers <backend-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
backend-id	Backend ID	Required
instance-server-id.{index}	UIID of the instance server.
instance-server-tag.{index}	Tag of the instance server.
use-instance-server-public-ip	Use public IP address of the instance instead of the private one
baremetal-server-id.{index}	UIID of the baremetal server.
baremetal-server-tag.{index}	Tag of the baremetal server.
server-ip.{index}	List of IP addresses to add to backend servers	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Create a backend for a given Load Balancer

Create a new backend for a given Load Balancer, specifying its full configuration including protocol, port and forwarding algorithm.

Usage:

Code
scw lb backend create [arg=value ...]

Arguments:

Name	Description	Argument Specifications
name	Name for the backend	Required Default: <generated>
forward-protocol	Protocol to be used by the backend when forwarding traffic to backend servers	Required One of: tcp, http
forward-port	Port to be used by the backend when forwarding traffic to backend servers	Required
forward-port-algorithm	Load balancing algorithm to be used when determining which backend server to forward new traffic to	Required Default: roundrobin One of: roundrobin, leastconn, first
sticky-sessions	Defines whether to activate sticky sessions (binding a particular session to a particular backend server) 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	Required Default: none One of: none, cookie, table
sticky-sessions-cookie-name	Cookie name for cookie-based sticky sessions
lb-id	Load Balancer ID	Required
health-check.port	Port to use for the backend server health check
health-check.check-delay	Time to wait between two consecutive health checks	Default: 3s
health-check.check-timeout	Maximum time a backend server has to reply to the health check	Default: 1s
health-check.check-max-retries	Number of consecutive unsuccessful health checks after which the server will be considered dead
health-check.tcp-config	Object to configure a basic TCP health check
health-check.mysql-config.user	MySQL user to use for the health check
health-check.pgsql-config.user	PostgreSQL user to use for the health check
health-check.ldap-config	Object to configure an LDAP health check. The response is analyzed to find the LDAPv3 response message
health-check.redis-config	Object to configure a Redis health check. The response is analyzed to find the +PONG response message
health-check.http-config.uri	HTTP path used for the health check
health-check.http-config.method	HTTP method used for the health check
health-check.http-config.code	HTTP response code expected for a successful health check
health-check.http-config.host-header	HTTP host header used for the health check
health-check.https-config.uri	HTTP path used for the health check
health-check.https-config.method	HTTP method used for the health check
health-check.https-config.code	HTTP response code expected for a successful health check
health-check.https-config.host-header	HTTP host header used for the health check
health-check.https-config.sni	SNI used for SSL health checks
health-check.check-send-proxy	Defines whether proxy protocol should be activated for the health check
health-check.transient-check-delay	Time to wait between two consecutive health checks when a backend server is in a transient state (going UP or DOWN)	Default: 0.5s
instance-server-id.{index}	UIID of the instance server.
instance-server-tag.{index}	Tag of the instance server.
use-instance-server-public-ip	Use public IP address of the instance instead of the private one
baremetal-server-id.{index}	UIID of the baremetal server.
baremetal-server-tag.{index}	Tag of the baremetal server.
server-ip.{index}	List of backend server IP addresses (IPv4 or IPv6) the backend should forward traffic to	Required
send-proxy-v2	Deprecated in favor of proxy_protocol field	Deprecated
timeout-server	Maximum allowed time for a backend server to process a request	Default: 5m
timeout-connect	Maximum allowed time for establishing a connection to a backend server	Default: 5s
timeout-tunnel	Maximum allowed tunnel inactivity time after Websocket is established (takes precedence over client and server timeout)	Default: 15m
on-marked-down-action	Action to take when a backend server is marked as down	One of: on_marked_down_action_none, shutdown_sessions
proxy-protocol	Protocol 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	One of: proxy_protocol_unknown, proxy_protocol_none, proxy_protocol_v1, proxy_protocol_v2, proxy_protocol_v2_ssl, proxy_protocol_v2_ssl_cn
failover-host	Scaleway 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-bridging	Defines whether to enable SSL bridging between the Load Balancer and backend servers
ignore-ssl-server-verify	Defines whether the server certificate verification should be ignored
redispatch-attempt-count	Whether to use another backend server on each attempt
max-retries	Number of retries when a backend server connection failed
max-connections	Maximum number of connections allowed per backend server
timeout-queue	Maximum time for a request to be left pending in queue when max_connections is reached
host	Host value to use when connecting to backend servers
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Delete a backend of a given Load Balancer

Delete a backend of a given Load Balancer, specified by its backend ID. This action is irreversible and cannot be undone.

Usage:

Code
scw lb backend delete <backend-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
backend-id	ID of the backend to delete	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Get a backend of a given Load Balancer

Get the full details of a given backend, specified by its backend ID. The response contains the backend's full configuration parameters including protocol, port and forwarding algorithm.

Usage:

Code
scw lb backend get <backend-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
backend-id	Backend ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

List the backends of a given Load Balancer

List all the backends of a Load Balancer, specified by its Load Balancer ID. By default, results are returned in ascending order by the creation date of each backend. The response is an array of backend objects, containing full details of each one including their configuration parameters such as protocol, port and forwarding algorithm.

Usage:

Code
scw lb backend list [arg=value ...]

Arguments:

Name	Description	Argument Specifications
lb-id	Load Balancer ID	Required
name	Name of the backend to filter for
order-by	Sort order of backends in the response	One of: created_at_asc, created_at_desc, name_asc, name_desc
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3, all

List backend server statistics

List information about your backend servers, including their state and the result of their last health check.

Usage:

Code
scw lb backend list-statistics <lb-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
lb-id	Load Balancer ID	Required
backend-id	ID of the backend
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3, all

Remove a set of servers for a given backend

For a given backend specified by its backend ID, remove the specified backend servers (identified by their IP addresses) so that it no longer forwards traffic to them.

Usage:

Code
scw lb backend remove-servers <backend-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
backend-id	Backend ID	Required
instance-server-id.{index}	UIID of the instance server.
instance-server-tag.{index}	Tag of the instance server.
use-instance-server-public-ip	Use public IP address of the instance instead of the private one
baremetal-server-id.{index}	UIID of the baremetal server.
baremetal-server-tag.{index}	Tag of the baremetal server.
server-ip.{index}	List of IP addresses to remove from backend servers	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Define all backend servers for a given backend

For a given backend specified by its backend ID, define the set of backend servers (identified by their IP addresses) that it should forward traffic to. Any existing backend servers configured for this backend will be removed.

Usage:

Code
scw lb backend set-servers <backend-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
backend-id	Backend ID	Required
instance-server-id.{index}	UIID of the instance server.
instance-server-tag.{index}	Tag of the instance server.
use-instance-server-public-ip	Use public IP address of the instance instead of the private one
baremetal-server-id.{index}	UIID of the baremetal server.
baremetal-server-tag.{index}	Tag of the baremetal server.
server-ip.{index}	List of IP addresses for backend servers. Any other existing backend servers will be removed	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Update a backend of a given Load Balancer

Update a backend of a given Load Balancer, specified by its backend ID. Note that the request type is PUT and not PATCH. You must set all parameters.

Usage:

Code
scw lb backend update <backend-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
backend-id	Backend ID	Required
name	Backend name	Required
forward-protocol	Protocol to be used by the backend when forwarding traffic to backend servers	Required One of: tcp, http
forward-port	Port to be used by the backend when forwarding traffic to backend servers	Required
forward-port-algorithm	Load balancing algorithm to be used when determining which backend server to forward new traffic to	Required One of: roundrobin, leastconn, first
sticky-sessions	Defines whether to activate sticky sessions (binding a particular session to a particular backend server) 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	Required One of: none, cookie, table
sticky-sessions-cookie-name	Cookie name for cookie-based sticky sessions
send-proxy-v2	Deprecated in favor of proxy_protocol field	Deprecated
timeout-server	Maximum allowed time for a backend server to process a request	Default: 5m
timeout-connect	Maximum allowed time for establishing a connection to a backend server	Default: 5s
timeout-tunnel	Maximum allowed tunnel inactivity time after Websocket is established (takes precedence over client and server timeout)	Default: 15m
on-marked-down-action	Action to take when a backend server is marked as down	One of: on_marked_down_action_none, shutdown_sessions
proxy-protocol	Protocol 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	One of: proxy_protocol_unknown, proxy_protocol_none, proxy_protocol_v1, proxy_protocol_v2, proxy_protocol_v2_ssl, proxy_protocol_v2_ssl_cn
failover-host	Scaleway 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-bridging	Defines whether to enable SSL bridging between the Load Balancer and backend servers
ignore-ssl-server-verify	Defines whether the server certificate verification should be ignored
redispatch-attempt-count	Whether to use another backend server on each attempt
max-retries	Number of retries when a backend server connection failed
max-connections	Maximum number of connections allowed per backend server
timeout-queue	Maximum time for a request to be left pending in queue when max_connections is reached
host	Host value to use when connecting to backend servers
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Update a health check for a given backend

Update the configuration of the health check performed by a given backend to verify the health of its backend servers, identified by its backend ID. Note that the request type is PUT and not PATCH. You must set all parameters.

Usage:

Code
scw lb backend update-healthcheck [arg=value ...]

Arguments:

Name	Description	Argument Specifications
port	Port to use for the backend server health check	Required
check-delay	Time to wait between two consecutive health checks	Required
check-timeout	Maximum time a backend server has to reply to the health check	Required
check-max-retries	Number of consecutive unsuccessful health checks after which the server will be considered dead	Required
backend-id	Backend ID	Required
check-send-proxy	Defines whether proxy protocol should be activated for the health check
tcp-config	Object to configure a basic TCP health check
mysql-config.user	MySQL user to use for the health check
pgsql-config.user	PostgreSQL user to use for the health check
ldap-config	Object to configure an LDAP health check. The response is analyzed to find the LDAPv3 response message
redis-config	Object to configure a Redis health check. The response is analyzed to find the +PONG response message
http-config.uri	HTTP path used for the health check
http-config.method	HTTP method used for the health check
http-config.code	HTTP response code expected for a successful health check
http-config.host-header	HTTP host header used for the health check
https-config.uri	HTTP path used for the health check
https-config.method	HTTP method used for the health check
https-config.code	HTTP response code expected for a successful health check
https-config.host-header	HTTP host header used for the health check
https-config.sni	SNI used for SSL health checks
transient-check-delay	Time to wait between two consecutive health checks when a backend server is in a transient state (going UP or DOWN)	Default: 0.5s
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

TLS certificate management commands

TLS certificate management commands.

Create an SSL/TLS certificate

Generate a new SSL/TLS certificate for a given Load Balancer. You can choose to create a Let's Encrypt certificate, or import a custom certificate.

Usage:

Code
scw lb certificate create [arg=value ...]

Arguments:

Name	Description	Argument Specifications
lb-id	Load Balancer ID	Required
name	Name for the certificate	Required Default: <generated>
letsencrypt-common-name	Main domain name of certificate (this domain must exist and resolve to your Load Balancer IP address)
letsencrypt-alternative-name.{index}	Alternative domain names (all domain names must exist and resolve to your Load Balancer IP address)
custom-certificate-chain	Full PEM-formatted certificate, consisting of the entire certificate chain including public key, private key, and (optionally) Certificate Authorities
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Delete an SSL/TLS certificate

Delete an SSL/TLS certificate, specified by its certificate ID. Deleting a certificate is irreversible and cannot be undone.

Usage:

Code
scw lb certificate delete <certificate-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
certificate-id	Certificate ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Get an SSL/TLS certificate

Get information for a particular SSL/TLS certificate, specified by its certificate ID. The response returns full details of the certificate, including its type, main domain name, and alternative domain names.

Usage:

Code
scw lb certificate get <certificate-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
certificate-id	Certificate ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

List all SSL/TLS certificates on a given Load Balancer

List all the SSL/TLS certificates on a given Load Balancer. The response is an array of certificate objects, which are by default listed in ascending order of creation date.

Usage:

Code
scw lb certificate list [arg=value ...]

Arguments:

Name	Description	Argument Specifications
lb-id	Load Balancer ID	Required
order-by	Sort order of certificates in the response	One of: created_at_asc, created_at_desc, name_asc, name_desc
name	Certificate name to filter for, only certificates of this name will be returned
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3, all

Update an SSL/TLS certificate

Update the name of a particular SSL/TLS certificate, specified by its certificate ID.

Usage:

Code
scw lb certificate update <certificate-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
certificate-id	Certificate ID	Required
name	Certificate name	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Frontend management commands

Frontend management commands.

Create a frontend in a given Load Balancer

Create a new frontend for a given Load Balancer, specifying its configuration including the port it should listen on and the backend to attach it to.

Usage:

Code
scw lb frontend create [arg=value ...]

Arguments:

Name	Description	Argument Specifications
name	Name for the frontend	Required Default: <generated>
inbound-port	Port the frontend should listen on	Required
lb-id	Load Balancer ID (ID of the Load Balancer to attach the frontend to)	Required
backend-id	Backend ID (ID of the backend the frontend should pass traffic to)	Required
timeout-client	Maximum allowed inactivity time on the client side	Default: 5m
certificate-id	Certificate ID, deprecated in favor of certificate_ids array	Deprecated
certificate-ids.{index}	List of SSL/TLS certificate IDs to bind to the frontend
enable-http3	Defines whether to enable HTTP/3 protocol on the frontend
connection-rate-limit	Rate limit for new connections established on this frontend. Use 0 value to disable, else value is connections per second.
enable-access-logs	Defines whether to enable access logs on the frontend
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Delete a frontend

Delete a given frontend, specified by its frontend ID. This action is irreversible and cannot be undone.

Usage:

Code
scw lb frontend delete <frontend-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
frontend-id	ID of the frontend to delete	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Get a frontend

Get the full details of a given frontend, specified by its frontend ID. The response contains the frontend's full configuration parameters including the backend it is attached to, the port it listens on, and any certificates it has.

Usage:

Code
scw lb frontend get <frontend-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
frontend-id	Frontend ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

List frontends of a given Load Balancer

List all the frontends of a Load Balancer, specified by its Load Balancer ID. By default, results are returned in ascending order by the creation date of each frontend. The response is an array of frontend objects, containing full details of each one including the port they listen on and the backend they are attached to.

Usage:

Code
scw lb frontend list [arg=value ...]

Arguments:

Name	Description	Argument Specifications
lb-id	Load Balancer ID	Required
name	Name of the frontend to filter for
order-by	Sort order of frontends in the response	One of: created_at_asc, created_at_desc, name_asc, name_desc
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3, all

Update a frontend

Update a given frontend, specified by its frontend ID. You can update configuration parameters including its name and the port it listens on. Note that the request type is PUT and not PATCH. You must set all parameters.

Usage:

Code
scw lb frontend update <frontend-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
frontend-id	Frontend ID	Required
name	Frontend name	Required
inbound-port	Port the frontend should listen on	Required
backend-id	Backend ID (ID of the backend the frontend should pass traffic to)	Required
timeout-client	Maximum allowed inactivity time on the client side	Default: 5m
certificate-id	Certificate ID, deprecated in favor of certificate_ids array	Deprecated
certificate-ids.{index}	List of SSL/TLS certificate IDs to bind to the frontend
enable-http3	Defines whether to enable HTTP/3 protocol on the frontend
connection-rate-limit	Rate limit for new connections established on this frontend. Use 0 value to disable, else value is connections per second.
enable-access-logs	Defines whether to enable access logs on the frontend
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

IP management commands

IP management commands.

Create an IP address

Create a new Load Balancer flexible IP address, in the specified Scaleway Project. This can be attached to new Load Balancers created in the future.

Usage:

Code
scw lb ip create [arg=value ...]

Arguments:

Name	Description	Argument Specifications
project-id	Project ID to use. If none is passed the default project ID will be used
reverse	Reverse DNS (domain name) for the IP address
is-ipv6	If true, creates a Flexible IP with an ipv6 address
tags.{index}	List of tags for the IP
organization-id	Organization ID to use. If none is passed the default organization ID will be used
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Delete an IP address

Delete a Load Balancer flexible IP address. This action is irreversible, and cannot be undone.

Usage:

Code
scw lb ip delete <ip-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
ip-id	IP address ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Get an IP address

Retrieve the full details of a Load Balancer flexible IP address.

Usage:

Code
scw lb ip get <ip-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
ip-id	IP address ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

List IP addresses

List the Load Balancer flexible IP addresses held in the account (filtered by Organization ID or Project ID). It is also possible to search for a specific IP address.

Usage:

Code
scw lb ip list [arg=value ...]

Arguments:

Name	Description	Argument Specifications
ip-address	IP address to filter for
project-id	Project ID to filter for, only Load Balancer IP addresses from this Project will be returned
ip-type	IP type to filter for	One of: all, ipv4, ipv6
tags.{index}	Tag to filter for, only IPs with one or more matching tags will be returned
organization-id	Organization ID to filter for, only Load Balancer IP addresses from this Organization will be returned
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3, all

Update an IP address

Update the reverse DNS of a Load Balancer flexible IP address.

Usage:

Code
scw lb ip update <ip-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
ip-id	IP address ID	Required
reverse	Reverse DNS (domain name) for the IP address
lb-id	ID of the server on which to attach the flexible IP
tags.{index}	List of tags for the IP
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Load balancer management commands

Load balancer management commands.

Create a Load Balancer

Create a new Load Balancer. Note that the Load Balancer will be created without frontends or backends; these must be created separately via the dedicated endpoints.

Usage:

Code
scw lb lb create [arg=value ...]

Arguments:

Name	Description	Argument Specifications
project-id	Project ID to use. If none is passed the default project ID will be used
name	Name for the Load Balancer	Required Default: <generated>
description	Description for the Load Balancer
ip-id	ID of an existing flexible IP address to attach to the Load Balancer	Deprecated
assign-flexible-ip	Defines whether to automatically assign a flexible public IP to the Load Balancer. Default value is true (assign).	Default: true
assign-flexible-ipv6	Defines whether to automatically assign a flexible public IPv6 to the Load Balancer. Default value is false (do not assign).	Default: false
ip-ids.{index}	List of IP IDs to attach to the Load Balancer
tags.{index}	List of tags for the Load Balancer
type	Load Balancer commercial offer type. Use the Load Balancer types endpoint to retrieve a list of available offer types	Default: LB-S One of: LB-S, LB-GP-M, LB-GP-L
ssl-compatibility-level	Determines the minimal SSL version which needs to be supported on the client side, in an SSL/TLS offloading context. Intermediate is suitable for general-purpose servers with a variety of clients, recommended for almost all systems (>= TLS1.2). Modern is suitable for services with clients that support TLS 1.3 and do not need backward compatibility (= TLS1.3). Old is compatible with a small number of very old clients and should be used only as a last resort (>= TLS1.0)	One of: ssl_compatibility_level_unknown, ssl_compatibility_level_intermediate, ssl_compatibility_level_modern, ssl_compatibility_level_old
organization-id	Organization ID to use. If none is passed the default organization ID will be used
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Delete a Load Balancer

Delete an existing Load Balancer, specified by its Load Balancer ID. Deleting a Load Balancer is permanent, and cannot be undone. The Load Balancer's flexible IP address can either be deleted with the Load Balancer, or kept in your account for future use.

Usage:

Code
scw lb lb delete <lb-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
lb-id	ID of the Load Balancer to delete	Required
release-ip	Defines whether the Load Balancer's flexible IP should be deleted. Set to true to release the flexible IP, or false to keep it available in your account for future Load Balancers
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Get a Load Balancer

Retrieve information about an existing Load Balancer, specified by its Load Balancer ID. Its full details, including name, status and IP address, are returned in the response object.

Usage:

Code
scw lb lb get <lb-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
lb-id	Load Balancer ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Get usage statistics of a given Load Balancer

Get usage statistics of a given Load Balancer.

Usage:

Code
scw lb lb get-stats <lb-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
lb-id	Load Balancer ID	Required
backend-id	ID of the backend
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

List Load Balancers

List all Load Balancers in the specified zone, for a Scaleway Organization or Scaleway Project. By default, the Load Balancers returned in the list are ordered by creation date in ascending order, though this can be modified via the order_by field.

Usage:

Code
scw lb lb list [arg=value ...]

Arguments:

Name	Description	Argument Specifications
name	Load Balancer name to filter for
order-by	Sort order of Load Balancers in the response	One of: created_at_asc, created_at_desc, name_asc, name_desc
project-id	Project ID to filter for, only Load Balancers from this Project will be returned
tags.{index}	Filter by tag, only Load Balancers with one or more matching tags will be returned
lb-ids.{index}	Filter by lb_ids, only Load Balancers with these IDs will be returned
organization-id	Organization ID to filter for, only Load Balancers from this Organization will be returned
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3, all

Migrate a Load Balancer

Migrate an existing Load Balancer from one commercial type to another. Allows you to scale your Load Balancer up or down in terms of bandwidth or multi-cloud provision.

Usage:

Code
scw lb lb migrate <lb-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
lb-id	Load Balancer ID	Required
type	Load Balancer type to migrate to (use the List all Load Balancer offer types endpoint to get a list of available offer types)	Required One of: LB-S, LB-GP-M, LB-GP-L
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Update a Load Balancer

Update the parameters of an existing Load Balancer, specified by its Load Balancer ID. Note that the request type is PUT and not PATCH. You must set all parameters.

Usage:

Code
scw lb lb update <lb-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
lb-id	Load Balancer ID	Required
name	Load Balancer name	Required
description	Load Balancer description	Required
assign-flexible-ipv6	Automatically assign a flexible public IPv6 to the Load Balancer
ip-id	The IP ID to attach to the Load Balancer
tags.{index}	List of tags for the Load Balancer
ssl-compatibility-level	Determines the minimal SSL version which needs to be supported on the client side, in an SSL/TLS offloading context. Intermediate is suitable for general-purpose servers with a variety of clients, recommended for almost all systems (>= TLS1.2). Modern is suitable for services with clients that support TLS 1.3 and do not need backward compatibility (= TLS1.3). Old is compatible with a small number of very old clients and should be used only as a last resort (>= TLS1.0)	One of: ssl_compatibility_level_unknown, ssl_compatibility_level_intermediate, ssl_compatibility_level_modern, ssl_compatibility_level_old
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Wait for a load balancer to reach a stable state

Wait for a load balancer to reach a stable state. This is similar to using --wait flag.

Usage:

Code
scw lb lb wait <lb-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
lb-id	ID of the load balancer you want to wait for.	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, pl-waw-1, nl-ams-1
timeout	Timeout of the wait	Default: 10m0s

Examples:

Wait for a load balancer to reach a stable state

Code
scw lb lb wait 11111111-1111-1111-1111-111111111111

Load balancer types management commands

Load balancer types management commands.

List all Load Balancer offer types

List all the different commercial Load Balancer types. The response includes an array of offer types, each with a name, description, and information about its stock availability.

Usage:

Code
scw lb lb-types list [arg=value ...]

Arguments:

Name	Description	Argument Specifications
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3, all

Private networks management commands

Private networks management commands.

Attach a Load Balancer to a Private Network

Attach a specified Load Balancer to a specified Private Network, defining a static or DHCP configuration for the Load Balancer on the network.

Usage:

Code
scw lb private-network attach <lb-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
lb-id	Load Balancer ID	Required
private-network-id	Private Network ID	Required
ipam-ids.{index}	IPAM ID of a pre-reserved IP address to assign to the Load Balancer on this Private Network. In the future, it will be possible to specify multiple IPs in this field (IPv4 and IPv6), for now only one ID of an IPv4 address is expected. When null, a new private IP address is created for the Load Balancer on this Private Network.
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Detach Load Balancer from Private Network

Detach a specified Load Balancer from a specified Private Network.

Usage:

Code
scw lb private-network detach <lb-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
lb-id	Load balancer ID	Required
private-network-id	Set your instance private network id	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

List Private Networks attached to a Load Balancer

List the Private Networks attached to a given Load Balancer, specified by its Load Balancer ID. The response is an array of Private Network objects, giving information including the status, configuration, name and creation date of each Private Network.

Usage:

Code
scw lb private-network list <lb-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
order-by	Sort order of Private Network objects in the response	One of: created_at_asc, created_at_desc
lb-id	Load Balancer ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3, all

Route rules management commands

Route rules management commands.

Create a route

Create a new route on a given frontend. To configure a route, specify the backend to direct to if a certain condition is matched (based on the value of the SNI field or HTTP Host header).

Usage:

Code
scw lb route create [arg=value ...]

Arguments:

Name	Description	Argument Specifications
frontend-id	ID of the source frontend to create the route on
backend-id	ID of the target backend for the route
match.sni	Server Name Indication (SNI) value to match
match.host-header	HTTP host header to match
match.match-subdomains	If true, all subdomains will match
match.path-begin	Path begin value to match
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Delete a route

Delete an existing route, specified by its route ID. Deleting a route is permanent, and cannot be undone.

Usage:

Code
scw lb route delete <route-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
route-id	Route ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Get a route

Retrieve information about an existing route, specified by its route ID. Its full details, origin frontend, target backend and match condition, are returned in the response object.

Usage:

Code
scw lb route get <route-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
route-id	Route ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

List all routes

List all routes for a given frontend. The response is an array of routes, each one with a specified backend to direct to if a certain condition is matched (based on the value of the SNI field or HTTP Host header).

Usage:

Code
scw lb route list [arg=value ...]

Arguments:

Name	Description	Argument Specifications
order-by	Sort order of routes in the response	One of: created_at_asc, created_at_desc
frontend-id	Frontend ID to filter for, only Routes from this Frontend will be returned
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3, all

Update a route

Update the configuration of an existing route, specified by its route ID.

Usage:

Code
scw lb route update <route-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
route-id	Route ID	Required
backend-id	ID of the target backend for the route
match.sni	Server Name Indication (SNI) value to match
match.host-header	HTTP host header to match
match.match-subdomains	If true, all subdomains will match
match.path-begin	Path begin value to match
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Subscriber management commands

Subscriber management commands.

Create a subscriber

Create a new subscriber, either with an email configuration or a webhook configuration, for a specified Scaleway Project.

Usage:

Code
scw lb subscriber create [arg=value ...]

Arguments:

Name	Description	Argument Specifications
name	Subscriber name	Required
email-config.email	Email address to send alerts to
webhook-config.uri	URI to receive POST requests
project-id	Project ID to use. If none is passed the default project ID will be used
organization-id	Organization ID to use. If none is passed the default organization ID will be used
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Delete a subscriber

Delete an existing subscriber, specified by its subscriber ID. Deleting a subscriber is permanent, and cannot be undone.

Usage:

Code
scw lb subscriber delete <subscriber-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
subscriber-id	Subscriber ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Get a subscriber

Retrieve information about an existing subscriber, specified by its subscriber ID. Its full details, including name and email/webhook configuration, are returned in the response object.

Usage:

Code
scw lb subscriber get <subscriber-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
subscriber-id	Subscriber ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

List all subscribers

List all subscribers to Load Balancer alerts. By default, returns all subscribers to Load Balancer alerts for the Organization associated with the authentication token used for the request.

Usage:

Code
scw lb subscriber list [arg=value ...]

Arguments:

Name	Description	Argument Specifications
order-by	Sort order of subscribers in the response	One of: created_at_asc, created_at_desc, name_asc, name_desc
name	Subscriber name to search for	Required
project-id	Filter subscribers by Project ID
organization-id	Filter subscribers by Organization ID
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3, all

Subscribe a subscriber to alerts for a given Load Balancer

Subscribe an existing subscriber to alerts for a given Load Balancer.

Usage:

Code
scw lb subscriber subscribe [arg=value ...]

Arguments:

Name	Description	Argument Specifications
lb-id	Load Balancer ID	Required
subscriber-id	Subscriber ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Unsubscribe a subscriber from alerts for a given Load Balancer

Unsubscribe a subscriber from alerts for a given Load Balancer. The subscriber is not deleted, and can be resubscribed in the future if necessary.

Usage:

Code
scw lb subscriber unsubscribe [arg=value ...]

Arguments:

Name	Description	Argument Specifications
lb-id	Load Balancer ID	Required
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3

Update a subscriber

Update the parameters of a given subscriber (e.g. name, webhook configuration, email configuration), specified by its subscriber ID.

Usage:

Code
scw lb subscriber update <subscriber-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
subscriber-id	Subscriber ID	Required
name	Subscriber name	Required
email-config.email	Email address to send alerts to
webhook-config.uri	URI to receive POST requests
zone	Zone to target. If none is passed will use default zone from the config	Default: fr-par-1 One of: fr-par-1, fr-par-2, nl-ams-1, nl-ams-2, nl-ams-3, pl-waw-1, pl-waw-2, pl-waw-3