lb

package
v1.0.0-beta.26 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 12, 2024 License: Apache-2.0 Imports: 14 Imported by: 10

Documentation

Overview

Package lb provides methods and message types of the lb v1 API.

Index

Constants

View Source
const (
	ACLActionRedirectRedirectTypeLocation = ACLActionRedirectRedirectType("location")
	ACLActionRedirectRedirectTypeScheme   = ACLActionRedirectRedirectType("scheme")
)
View Source
const (
	ACLActionTypeAllow    = ACLActionType("allow")
	ACLActionTypeDeny     = ACLActionType("deny")
	ACLActionTypeRedirect = ACLActionType("redirect")
)
View Source
const (
	ACLHTTPFilterACLHTTPFilterNone = ACLHTTPFilter("acl_http_filter_none")
	ACLHTTPFilterPathBegin         = ACLHTTPFilter("path_begin")
	ACLHTTPFilterPathEnd           = ACLHTTPFilter("path_end")
	ACLHTTPFilterRegex             = ACLHTTPFilter("regex")
	ACLHTTPFilterHTTPHeaderMatch   = ACLHTTPFilter("http_header_match")
)
View Source
const (
	BackendServerStatsHealthCheckStatusUnknown  = BackendServerStatsHealthCheckStatus("unknown")
	BackendServerStatsHealthCheckStatusNeutral  = BackendServerStatsHealthCheckStatus("neutral")
	BackendServerStatsHealthCheckStatusFailed   = BackendServerStatsHealthCheckStatus("failed")
	BackendServerStatsHealthCheckStatusPassed   = BackendServerStatsHealthCheckStatus("passed")
	BackendServerStatsHealthCheckStatusCondpass = BackendServerStatsHealthCheckStatus("condpass")
)
View Source
const (
	BackendServerStatsServerStateStopped  = BackendServerStatsServerState("stopped")
	BackendServerStatsServerStateStarting = BackendServerStatsServerState("starting")
	BackendServerStatsServerStateRunning  = BackendServerStatsServerState("running")
	BackendServerStatsServerStateStopping = BackendServerStatsServerState("stopping")
)
View Source
const (
	CertificateStatusPending = CertificateStatus("pending")
	CertificateStatusReady   = CertificateStatus("ready")
	CertificateStatusError   = CertificateStatus("error")
)
View Source
const (
	CertificateTypeLetsencryt = CertificateType("letsencryt")
	CertificateTypeCustom     = CertificateType("custom")
)
View Source
const (
	ForwardPortAlgorithmRoundrobin = ForwardPortAlgorithm("roundrobin")
	ForwardPortAlgorithmLeastconn  = ForwardPortAlgorithm("leastconn")
	ForwardPortAlgorithmFirst      = ForwardPortAlgorithm("first")
)
View Source
const (
	InstanceStatusUnknown   = InstanceStatus("unknown")
	InstanceStatusReady     = InstanceStatus("ready")
	InstanceStatusPending   = InstanceStatus("pending")
	InstanceStatusStopped   = InstanceStatus("stopped")
	InstanceStatusError     = InstanceStatus("error")
	InstanceStatusLocked    = InstanceStatus("locked")
	InstanceStatusMigrating = InstanceStatus("migrating")
)
View Source
const (
	LBStatusUnknown   = LBStatus("unknown")
	LBStatusReady     = LBStatus("ready")
	LBStatusPending   = LBStatus("pending")
	LBStatusStopped   = LBStatus("stopped")
	LBStatusError     = LBStatus("error")
	LBStatusLocked    = LBStatus("locked")
	LBStatusMigrating = LBStatus("migrating")
	LBStatusToCreate  = LBStatus("to_create")
	LBStatusCreating  = LBStatus("creating")
	LBStatusToDelete  = LBStatus("to_delete")
	LBStatusDeleting  = LBStatus("deleting")
)
View Source
const (
	LBTypeStockUnknown    = LBTypeStock("unknown")
	LBTypeStockLowStock   = LBTypeStock("low_stock")
	LBTypeStockOutOfStock = LBTypeStock("out_of_stock")
	LBTypeStockAvailable  = LBTypeStock("available")
)
View Source
const (
	ListACLRequestOrderByCreatedAtAsc  = ListACLRequestOrderBy("created_at_asc")
	ListACLRequestOrderByCreatedAtDesc = ListACLRequestOrderBy("created_at_desc")
	ListACLRequestOrderByNameAsc       = ListACLRequestOrderBy("name_asc")
	ListACLRequestOrderByNameDesc      = ListACLRequestOrderBy("name_desc")
)
View Source
const (
	ListBackendsRequestOrderByCreatedAtAsc  = ListBackendsRequestOrderBy("created_at_asc")
	ListBackendsRequestOrderByCreatedAtDesc = ListBackendsRequestOrderBy("created_at_desc")
	ListBackendsRequestOrderByNameAsc       = ListBackendsRequestOrderBy("name_asc")
	ListBackendsRequestOrderByNameDesc      = ListBackendsRequestOrderBy("name_desc")
)
View Source
const (
	ListCertificatesRequestOrderByCreatedAtAsc  = ListCertificatesRequestOrderBy("created_at_asc")
	ListCertificatesRequestOrderByCreatedAtDesc = ListCertificatesRequestOrderBy("created_at_desc")
	ListCertificatesRequestOrderByNameAsc       = ListCertificatesRequestOrderBy("name_asc")
	ListCertificatesRequestOrderByNameDesc      = ListCertificatesRequestOrderBy("name_desc")
)
View Source
const (
	ListFrontendsRequestOrderByCreatedAtAsc  = ListFrontendsRequestOrderBy("created_at_asc")
	ListFrontendsRequestOrderByCreatedAtDesc = ListFrontendsRequestOrderBy("created_at_desc")
	ListFrontendsRequestOrderByNameAsc       = ListFrontendsRequestOrderBy("name_asc")
	ListFrontendsRequestOrderByNameDesc      = ListFrontendsRequestOrderBy("name_desc")
)
View Source
const (
	ListIPsRequestIPTypeAll  = ListIPsRequestIPType("all")
	ListIPsRequestIPTypeIPv4 = ListIPsRequestIPType("ipv4")
	ListIPsRequestIPTypeIPv6 = ListIPsRequestIPType("ipv6")
)
View Source
const (
	ListLBsRequestOrderByCreatedAtAsc  = ListLBsRequestOrderBy("created_at_asc")
	ListLBsRequestOrderByCreatedAtDesc = ListLBsRequestOrderBy("created_at_desc")
	ListLBsRequestOrderByNameAsc       = ListLBsRequestOrderBy("name_asc")
	ListLBsRequestOrderByNameDesc      = ListLBsRequestOrderBy("name_desc")
)
View Source
const (
	ListPrivateNetworksRequestOrderByCreatedAtAsc  = ListPrivateNetworksRequestOrderBy("created_at_asc")
	ListPrivateNetworksRequestOrderByCreatedAtDesc = ListPrivateNetworksRequestOrderBy("created_at_desc")
)
View Source
const (
	ListRoutesRequestOrderByCreatedAtAsc  = ListRoutesRequestOrderBy("created_at_asc")
	ListRoutesRequestOrderByCreatedAtDesc = ListRoutesRequestOrderBy("created_at_desc")
)
View Source
const (
	ListSubscriberRequestOrderByCreatedAtAsc  = ListSubscriberRequestOrderBy("created_at_asc")
	ListSubscriberRequestOrderByCreatedAtDesc = ListSubscriberRequestOrderBy("created_at_desc")
	ListSubscriberRequestOrderByNameAsc       = ListSubscriberRequestOrderBy("name_asc")
	ListSubscriberRequestOrderByNameDesc      = ListSubscriberRequestOrderBy("name_desc")
)
View Source
const (
	OnMarkedDownActionOnMarkedDownActionNone = OnMarkedDownAction("on_marked_down_action_none")
	OnMarkedDownActionShutdownSessions       = OnMarkedDownAction("shutdown_sessions")
)
View Source
const (
	PrivateNetworkStatusUnknown = PrivateNetworkStatus("unknown")
	PrivateNetworkStatusReady   = PrivateNetworkStatus("ready")
	PrivateNetworkStatusPending = PrivateNetworkStatus("pending")
	PrivateNetworkStatusError   = PrivateNetworkStatus("error")
)
View Source
const (
	ProtocolTCP  = Protocol("tcp")
	ProtocolHTTP = Protocol("http")
)
View Source
const (
	ProxyProtocolProxyProtocolUnknown = ProxyProtocol("proxy_protocol_unknown")
	ProxyProtocolProxyProtocolNone    = ProxyProtocol("proxy_protocol_none")
	ProxyProtocolProxyProtocolV1      = ProxyProtocol("proxy_protocol_v1")
	ProxyProtocolProxyProtocolV2      = ProxyProtocol("proxy_protocol_v2")
	ProxyProtocolProxyProtocolV2Ssl   = ProxyProtocol("proxy_protocol_v2_ssl")
	ProxyProtocolProxyProtocolV2SslCn = ProxyProtocol("proxy_protocol_v2_ssl_cn")
)
View Source
const (
	SSLCompatibilityLevelSslCompatibilityLevelUnknown      = SSLCompatibilityLevel("ssl_compatibility_level_unknown")
	SSLCompatibilityLevelSslCompatibilityLevelIntermediate = SSLCompatibilityLevel("ssl_compatibility_level_intermediate")
	SSLCompatibilityLevelSslCompatibilityLevelModern       = SSLCompatibilityLevel("ssl_compatibility_level_modern")
	SSLCompatibilityLevelSslCompatibilityLevelOld          = SSLCompatibilityLevel("ssl_compatibility_level_old")
)
View Source
const (
	StickySessionsTypeNone   = StickySessionsType("none")
	StickySessionsTypeCookie = StickySessionsType("cookie")
	StickySessionsTypeTable  = StickySessionsType("table")
)

Variables

This section is empty.

Functions

This section is empty.

Types

type ACL

type ACL struct {
	// ID: ACL ID.
	ID string `json:"id"`

	// Name: ACL name.
	Name string `json:"name"`

	// Match: ACL match filter object. One of `ip_subnet` or `http_filter` & `http_filter_value` are required.
	Match *ACLMatch `json:"match"`

	// Action: action to take when incoming traffic matches an ACL filter.
	Action *ACLAction `json:"action"`

	// Frontend: ACL is attached to this frontend object.
	Frontend *Frontend `json:"frontend"`

	// Index: priority of this ACL (ACLs are applied in ascending order, 0 is the first ACL executed).
	Index int32 `json:"index"`

	// CreatedAt: date on which the ACL was created.
	CreatedAt *time.Time `json:"created_at"`

	// UpdatedAt: date on which the ACL was last updated.
	UpdatedAt *time.Time `json:"updated_at"`

	// Description: ACL description.
	Description string `json:"description"`
}

ACL: acl.

type ACLAction

type ACLAction struct {
	// Type: action to take when incoming traffic matches an ACL filter.
	// Default value: allow
	Type ACLActionType `json:"type"`

	// Redirect: redirection parameters when using an ACL with a `redirect` action.
	Redirect *ACLActionRedirect `json:"redirect"`
}

ACLAction: acl action.

type ACLActionRedirect

type ACLActionRedirect struct {
	// Type: redirect type.
	// Default value: location
	Type ACLActionRedirectRedirectType `json:"type"`

	// 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\}\}.
	Target string `json:"target"`

	// Code: HTTP redirect code to use. Valid values are 301, 302, 303, 307 and 308. Default value is 302.
	Code *int32 `json:"code"`
}

ACLActionRedirect: acl action redirect.

type ACLActionRedirectRedirectType

type ACLActionRedirectRedirectType string

func (ACLActionRedirectRedirectType) MarshalJSON

func (enum ACLActionRedirectRedirectType) MarshalJSON() ([]byte, error)

func (ACLActionRedirectRedirectType) String

func (enum ACLActionRedirectRedirectType) String() string

func (*ACLActionRedirectRedirectType) UnmarshalJSON

func (enum *ACLActionRedirectRedirectType) UnmarshalJSON(data []byte) error

type ACLActionType

type ACLActionType string

func (ACLActionType) MarshalJSON

func (enum ACLActionType) MarshalJSON() ([]byte, error)

func (ACLActionType) String

func (enum ACLActionType) String() string

func (*ACLActionType) UnmarshalJSON

func (enum *ACLActionType) UnmarshalJSON(data []byte) error

type ACLHTTPFilter

type ACLHTTPFilter string

func (ACLHTTPFilter) MarshalJSON

func (enum ACLHTTPFilter) MarshalJSON() ([]byte, error)

func (ACLHTTPFilter) String

func (enum ACLHTTPFilter) String() string

func (*ACLHTTPFilter) UnmarshalJSON

func (enum *ACLHTTPFilter) UnmarshalJSON(data []byte) error

type ACLMatch

type ACLMatch struct {
	// IPSubnet: list of IPs or CIDR v4/v6 addresses to filter for from the client side.
	IPSubnet []*string `json:"ip_subnet"`

	// HTTPFilter: 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.
	// Default value: acl_http_filter_none
	HTTPFilter ACLHTTPFilter `json:"http_filter"`

	// HTTPFilterValue: list of values to filter for.
	HTTPFilterValue []*string `json:"http_filter_value"`

	// HTTPFilterOption: name of the HTTP header to filter on if `http_header_match` was selected in `http_filter`.
	HTTPFilterOption *string `json:"http_filter_option"`

	// Invert: defines whether to invert the match condition. If set to `true`, the ACL carries out its action when the condition DOES NOT match.
	Invert bool `json:"invert"`
}

ACLMatch: acl match.

type ACLSpec

type ACLSpec struct {
	// Name: ACL name.
	Name string `json:"name"`

	// Action: action to take when incoming traffic matches an ACL filter.
	Action *ACLAction `json:"action"`

	// Match: ACL match filter object. One of `ip_subnet` or `http_filter` and `http_filter_value` are required.
	Match *ACLMatch `json:"match"`

	// Index: priority of this ACL (ACLs are applied in ascending order, 0 is the first ACL executed).
	Index int32 `json:"index"`

	// Description: ACL description.
	Description string `json:"description"`
}

ACLSpec: acl spec.

type API

type API struct {
	// contains filtered or unexported fields
}

This API allows you to manage your load balancer service.

func NewAPI deprecated

func NewAPI(client *scw.Client) *API

Deprecated: NewAPI returns a API object from a Scaleway client.

func (*API) AddBackendServers

func (s *API) AddBackendServers(req *AddBackendServersRequest, opts ...scw.RequestOption) (*Backend, error)

AddBackendServers: Add a set of servers in a given backend.

func (*API) AttachPrivateNetwork

func (s *API) AttachPrivateNetwork(req *AttachPrivateNetworkRequest, opts ...scw.RequestOption) (*PrivateNetwork, error)

AttachPrivateNetwork: Add load balancer on instance private network.

func (*API) CreateACL

func (s *API) CreateACL(req *CreateACLRequest, opts ...scw.RequestOption) (*ACL, error)

CreateACL: Create an ACL for a given frontend.

func (*API) CreateBackend

func (s *API) CreateBackend(req *CreateBackendRequest, opts ...scw.RequestOption) (*Backend, error)

CreateBackend: Create a backend in a given load balancer.

func (*API) CreateCertificate

func (s *API) CreateCertificate(req *CreateCertificateRequest, opts ...scw.RequestOption) (*Certificate, error)

CreateCertificate: Generate a new TLS certificate using Let's Encrypt or import your certificate.

func (*API) CreateFrontend

func (s *API) CreateFrontend(req *CreateFrontendRequest, opts ...scw.RequestOption) (*Frontend, error)

CreateFrontend: Create a frontend in a given load balancer.

func (*API) CreateIP

func (s *API) CreateIP(req *CreateIPRequest, opts ...scw.RequestOption) (*IP, error)

CreateIP: Create an IP.

func (*API) CreateLB

func (s *API) CreateLB(req *CreateLBRequest, opts ...scw.RequestOption) (*LB, error)

CreateLB: Create a load balancer.

func (*API) CreateRoute

func (s *API) CreateRoute(req *CreateRouteRequest, opts ...scw.RequestOption) (*Route, error)

CreateRoute: Create a backend redirection.

func (*API) CreateSubscriber

func (s *API) CreateSubscriber(req *CreateSubscriberRequest, opts ...scw.RequestOption) (*Subscriber, error)

CreateSubscriber: Create a subscriber, webhook or email.

func (*API) DeleteACL

func (s *API) DeleteACL(req *DeleteACLRequest, opts ...scw.RequestOption) error

DeleteACL: Delete an ACL.

func (*API) DeleteBackend

func (s *API) DeleteBackend(req *DeleteBackendRequest, opts ...scw.RequestOption) error

DeleteBackend: Delete a backend in a given load balancer.

func (*API) DeleteCertificate

func (s *API) DeleteCertificate(req *DeleteCertificateRequest, opts ...scw.RequestOption) error

DeleteCertificate: Delete a TLS certificate.

func (*API) DeleteFrontend

func (s *API) DeleteFrontend(req *DeleteFrontendRequest, opts ...scw.RequestOption) error

DeleteFrontend: Delete a frontend.

func (*API) DeleteLB

func (s *API) DeleteLB(req *DeleteLBRequest, opts ...scw.RequestOption) error

DeleteLB: Delete a load balancer.

func (*API) DeleteRoute

func (s *API) DeleteRoute(req *DeleteRouteRequest, opts ...scw.RequestOption) error

DeleteRoute: Delete a backend redirection.

func (*API) DeleteSubscriber

func (s *API) DeleteSubscriber(req *DeleteSubscriberRequest, opts ...scw.RequestOption) error

DeleteSubscriber: Delete a subscriber.

func (*API) DetachPrivateNetwork

func (s *API) DetachPrivateNetwork(req *DetachPrivateNetworkRequest, opts ...scw.RequestOption) error

DetachPrivateNetwork: Remove load balancer of private network.

func (*API) GetACL

func (s *API) GetACL(req *GetACLRequest, opts ...scw.RequestOption) (*ACL, error)

GetACL: Get an ACL.

func (*API) GetBackend

func (s *API) GetBackend(req *GetBackendRequest, opts ...scw.RequestOption) (*Backend, error)

GetBackend: Get a backend in a given load balancer.

func (*API) GetCertificate

func (s *API) GetCertificate(req *GetCertificateRequest, opts ...scw.RequestOption) (*Certificate, error)

GetCertificate: Get a TLS certificate.

func (*API) GetFrontend

func (s *API) GetFrontend(req *GetFrontendRequest, opts ...scw.RequestOption) (*Frontend, error)

GetFrontend: Get a frontend.

func (*API) GetIP

func (s *API) GetIP(req *GetIPRequest, opts ...scw.RequestOption) (*IP, error)

GetIP: Get an IP.

func (*API) GetLB

func (s *API) GetLB(req *GetLBRequest, opts ...scw.RequestOption) (*LB, error)

GetLB: Get a load balancer.

func (*API) GetLBStats deprecated

func (s *API) GetLBStats(req *GetLBStatsRequest, opts ...scw.RequestOption) (*LBStats, error)

Deprecated: GetLBStats: Get usage statistics of a given load balancer.

func (*API) GetRoute

func (s *API) GetRoute(req *GetRouteRequest, opts ...scw.RequestOption) (*Route, error)

GetRoute: Get single backend redirection.

func (*API) GetSubscriber

func (s *API) GetSubscriber(req *GetSubscriberRequest, opts ...scw.RequestOption) (*Subscriber, error)

GetSubscriber: Get a subscriber.

func (*API) ListACLs

func (s *API) ListACLs(req *ListACLsRequest, opts ...scw.RequestOption) (*ListACLResponse, error)

ListACLs: List ACL for a given frontend.

func (*API) ListBackendStats

func (s *API) ListBackendStats(req *ListBackendStatsRequest, opts ...scw.RequestOption) (*ListBackendStatsResponse, error)

ListBackendStats: List backend server statistics.

func (*API) ListBackends

func (s *API) ListBackends(req *ListBackendsRequest, opts ...scw.RequestOption) (*ListBackendsResponse, error)

ListBackends: List backends in a given load balancer.

func (*API) ListCertificates

func (s *API) ListCertificates(req *ListCertificatesRequest, opts ...scw.RequestOption) (*ListCertificatesResponse, error)

ListCertificates: List all TLS certificates on a given load balancer.

func (*API) ListFrontends

func (s *API) ListFrontends(req *ListFrontendsRequest, opts ...scw.RequestOption) (*ListFrontendsResponse, error)

ListFrontends: List frontends in a given load balancer.

func (*API) ListIPs

func (s *API) ListIPs(req *ListIPsRequest, opts ...scw.RequestOption) (*ListIPsResponse, error)

ListIPs: List IPs.

func (*API) ListLBPrivateNetworks

func (s *API) ListLBPrivateNetworks(req *ListLBPrivateNetworksRequest, opts ...scw.RequestOption) (*ListLBPrivateNetworksResponse, error)

ListLBPrivateNetworks: List attached private network of load balancer.

func (*API) ListLBTypes

func (s *API) ListLBTypes(req *ListLBTypesRequest, opts ...scw.RequestOption) (*ListLBTypesResponse, error)

ListLBTypes: List all load balancer offer type.

func (*API) ListLBs

func (s *API) ListLBs(req *ListLBsRequest, opts ...scw.RequestOption) (*ListLBsResponse, error)

ListLBs: List load balancers.

func (*API) ListRoutes

func (s *API) ListRoutes(req *ListRoutesRequest, opts ...scw.RequestOption) (*ListRoutesResponse, error)

ListRoutes: List all backend redirections.

func (*API) ListSubscriber

func (s *API) ListSubscriber(req *ListSubscriberRequest, opts ...scw.RequestOption) (*ListSubscriberResponse, error)

ListSubscriber: List all subscriber.

func (*API) MigrateLB

func (s *API) MigrateLB(req *MigrateLBRequest, opts ...scw.RequestOption) (*LB, error)

MigrateLB: Migrate a load balancer.

func (*API) Regions

func (s *API) Regions() []scw.Region

func (*API) ReleaseIP

func (s *API) ReleaseIP(req *ReleaseIPRequest, opts ...scw.RequestOption) error

ReleaseIP: Delete an IP.

func (*API) RemoveBackendServers

func (s *API) RemoveBackendServers(req *RemoveBackendServersRequest, opts ...scw.RequestOption) (*Backend, error)

RemoveBackendServers: Remove a set of servers for a given backend.

func (*API) SetBackendServers

func (s *API) SetBackendServers(req *SetBackendServersRequest, opts ...scw.RequestOption) (*Backend, error)

SetBackendServers: Define all servers in a given backend.

func (*API) SubscribeToLB

func (s *API) SubscribeToLB(req *SubscribeToLBRequest, opts ...scw.RequestOption) (*LB, error)

SubscribeToLB: Subscribe a subscriber to a given load balancer.

func (*API) UnsubscribeFromLB

func (s *API) UnsubscribeFromLB(req *UnsubscribeFromLBRequest, opts ...scw.RequestOption) (*LB, error)

UnsubscribeFromLB: Unsubscribe a subscriber from a given load balancer.

func (*API) UpdateACL

func (s *API) UpdateACL(req *UpdateACLRequest, opts ...scw.RequestOption) (*ACL, error)

UpdateACL: Update an ACL.

func (*API) UpdateBackend

func (s *API) UpdateBackend(req *UpdateBackendRequest, opts ...scw.RequestOption) (*Backend, error)

UpdateBackend: Update a backend in a given load balancer.

func (*API) UpdateCertificate

func (s *API) UpdateCertificate(req *UpdateCertificateRequest, opts ...scw.RequestOption) (*Certificate, error)

UpdateCertificate: Update a TLS certificate.

func (*API) UpdateFrontend

func (s *API) UpdateFrontend(req *UpdateFrontendRequest, opts ...scw.RequestOption) (*Frontend, error)

UpdateFrontend: Update a frontend.

func (*API) UpdateHealthCheck

func (s *API) UpdateHealthCheck(req *UpdateHealthCheckRequest, opts ...scw.RequestOption) (*HealthCheck, error)

UpdateHealthCheck: Update an health check for a given backend.

func (*API) UpdateIP

func (s *API) UpdateIP(req *UpdateIPRequest, opts ...scw.RequestOption) (*IP, error)

UpdateIP: Update an IP.

func (*API) UpdateLB

func (s *API) UpdateLB(req *UpdateLBRequest, opts ...scw.RequestOption) (*LB, error)

UpdateLB: Update a load balancer.

func (*API) UpdateRoute

func (s *API) UpdateRoute(req *UpdateRouteRequest, opts ...scw.RequestOption) (*Route, error)

UpdateRoute: Edit a backend redirection.

func (*API) UpdateSubscriber

func (s *API) UpdateSubscriber(req *UpdateSubscriberRequest, opts ...scw.RequestOption) (*Subscriber, error)

UpdateSubscriber: Update a subscriber.

func (*API) WaitForLb

func (s *API) WaitForLb(req *WaitForLBRequest, opts ...scw.RequestOption) (*LB, error)

WaitForLb waits for the lb to be in a "terminal state" before returning. This function can be used to wait for a lb to be ready for example.

type AddBackendServersRequest

type AddBackendServersRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// BackendID: backend ID.
	BackendID string `json:"-"`

	// ServerIP: list of IP addresses to add to backend servers.
	ServerIP []string `json:"server_ip"`
}

AddBackendServersRequest: add backend servers request.

type AttachPrivateNetworkRequest

type AttachPrivateNetworkRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// PrivateNetworkID: private Network ID.
	PrivateNetworkID string `json:"-"`

	// Deprecated: StaticConfig: object containing an array of a local IP address for the Load Balancer on this Private Network.
	// Precisely one of StaticConfig, DHCPConfig, IpamConfig must be set.
	StaticConfig *PrivateNetworkStaticConfig `json:"static_config,omitempty"`

	// Deprecated: DHCPConfig: defines whether to let DHCP assign IP addresses.
	// Precisely one of StaticConfig, DHCPConfig, IpamConfig must be set.
	DHCPConfig *PrivateNetworkDHCPConfig `json:"dhcp_config,omitempty"`

	// Deprecated: IpamConfig: for internal use only.
	// Precisely one of StaticConfig, DHCPConfig, IpamConfig must be set.
	IpamConfig *PrivateNetworkIpamConfig `json:"ipam_config,omitempty"`
}

AttachPrivateNetworkRequest: attach private network request.

type Backend

type Backend struct {
	// ID: backend ID.
	ID string `json:"id"`

	// Name: name of the backend.
	Name string `json:"name"`

	// ForwardProtocol: protocol used by the backend when forwarding traffic to backend servers.
	// Default value: tcp
	ForwardProtocol Protocol `json:"forward_protocol"`

	// ForwardPort: port used by the backend when forwarding traffic to backend servers.
	ForwardPort int32 `json:"forward_port"`

	// ForwardPortAlgorithm: load balancing algorithm to use when determining which backend server to forward new traffic to.
	// Default value: roundrobin
	ForwardPortAlgorithm ForwardPortAlgorithm `json:"forward_port_algorithm"`

	// StickySessions: defines 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.
	// Default value: none
	StickySessions StickySessionsType `json:"sticky_sessions"`

	// StickySessionsCookieName: cookie name for cookie-based sticky sessions.
	StickySessionsCookieName string `json:"sticky_sessions_cookie_name"`

	// HealthCheck: object defining the health check to be carried out by the backend when checking the status and health of backend servers.
	HealthCheck *HealthCheck `json:"health_check"`

	// Pool: list of IP addresses of backend servers attached to this backend.
	Pool []string `json:"pool"`

	// LB: load Balancer the backend is attached to.
	LB *LB `json:"lb"`

	// Deprecated: SendProxyV2: deprecated in favor of proxy_protocol field.
	SendProxyV2 *bool `json:"send_proxy_v2,omitempty"`

	// TimeoutServer: maximum allowed time for a backend server to process a request.
	TimeoutServer *time.Duration `json:"timeout_server"`

	// TimeoutConnect: maximum allowed time for establishing a connection to a backend server.
	TimeoutConnect *time.Duration `json:"timeout_connect"`

	// TimeoutTunnel: maximum allowed tunnel inactivity time after Websocket is established (takes precedence over client and server timeout).
	TimeoutTunnel *time.Duration `json:"timeout_tunnel"`

	// OnMarkedDownAction: action to take when a backend server is marked as down.
	// Default value: on_marked_down_action_none
	OnMarkedDownAction OnMarkedDownAction `json:"on_marked_down_action"`

	// ProxyProtocol: 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.
	// Default value: proxy_protocol_unknown
	ProxyProtocol ProxyProtocol `json:"proxy_protocol"`

	// CreatedAt: date at which the backend was created.
	CreatedAt *time.Time `json:"created_at"`

	// UpdatedAt: date at which the backend was updated.
	UpdatedAt *time.Time `json:"updated_at"`

	// FailoverHost: scaleway S3 bucket website to be served as failover if all backend servers are down, e.g. failover-website.s3-website.fr-par.scw.cloud.
	FailoverHost *string `json:"failover_host"`

	// SslBridging: defines whether to enable SSL bridging between the Load Balancer and backend servers.
	SslBridging *bool `json:"ssl_bridging"`

	// IgnoreSslServerVerify: defines whether the server certificate verification should be ignored.
	IgnoreSslServerVerify *bool `json:"ignore_ssl_server_verify"`

	// RedispatchAttemptCount: whether to use another backend server on each attempt.
	RedispatchAttemptCount *int32 `json:"redispatch_attempt_count"`

	// MaxRetries: number of retries when a backend server connection failed.
	MaxRetries *int32 `json:"max_retries"`

	// MaxConnections: maximum number of connections allowed per backend server.
	MaxConnections *int32 `json:"max_connections"`

	// TimeoutQueue: maximum time for a request to be left pending in queue when `max_connections` is reached.
	TimeoutQueue *scw.Duration `json:"timeout_queue"`
}

Backend: backend.

func (Backend) MarshalJSON

func (m Backend) MarshalJSON() ([]byte, error)

func (*Backend) UnmarshalJSON

func (m *Backend) UnmarshalJSON(b []byte) error

type BackendServerStats

type BackendServerStats struct {
	// InstanceID: ID of your Load Balancer's underlying Instance.
	InstanceID string `json:"instance_id"`

	// BackendID: backend ID.
	BackendID string `json:"backend_id"`

	// IP: iPv4 or IPv6 address of the backend server.
	IP string `json:"ip"`

	// ServerState: server operational state (stopped/starting/running/stopping).
	// Default value: stopped
	ServerState BackendServerStatsServerState `json:"server_state"`

	// ServerStateChangedAt: time since last operational change.
	ServerStateChangedAt *time.Time `json:"server_state_changed_at"`

	// LastHealthCheckStatus: last health check status (unknown/neutral/failed/passed/condpass).
	// Default value: unknown
	LastHealthCheckStatus BackendServerStatsHealthCheckStatus `json:"last_health_check_status"`
}

BackendServerStats: backend server stats.

type BackendServerStatsHealthCheckStatus

type BackendServerStatsHealthCheckStatus string

func (BackendServerStatsHealthCheckStatus) MarshalJSON

func (enum BackendServerStatsHealthCheckStatus) MarshalJSON() ([]byte, error)

func (BackendServerStatsHealthCheckStatus) String

func (*BackendServerStatsHealthCheckStatus) UnmarshalJSON

func (enum *BackendServerStatsHealthCheckStatus) UnmarshalJSON(data []byte) error

type BackendServerStatsServerState

type BackendServerStatsServerState string

func (BackendServerStatsServerState) MarshalJSON

func (enum BackendServerStatsServerState) MarshalJSON() ([]byte, error)

func (BackendServerStatsServerState) String

func (enum BackendServerStatsServerState) String() string

func (*BackendServerStatsServerState) UnmarshalJSON

func (enum *BackendServerStatsServerState) UnmarshalJSON(data []byte) error

type Certificate

type Certificate struct {
	// Type: certificate type (Let's Encrypt or custom).
	// Default value: letsencryt
	Type CertificateType `json:"type"`

	// ID: certificate ID.
	ID string `json:"id"`

	// CommonName: main domain name of certificate.
	CommonName string `json:"common_name"`

	// SubjectAlternativeName: alternative domain names.
	SubjectAlternativeName []string `json:"subject_alternative_name"`

	// Fingerprint: identifier (SHA-1) of the certificate.
	Fingerprint string `json:"fingerprint"`

	// NotValidBefore: lower validity bound.
	NotValidBefore *time.Time `json:"not_valid_before"`

	// NotValidAfter: upper validity bound.
	NotValidAfter *time.Time `json:"not_valid_after"`

	// Status: certificate status.
	// Default value: pending
	Status CertificateStatus `json:"status"`

	// LB: load Balancer object the certificate is attached to.
	LB *LB `json:"lb"`

	// Name: certificate name.
	Name string `json:"name"`

	// CreatedAt: date on which the certificate was created.
	CreatedAt *time.Time `json:"created_at"`

	// UpdatedAt: date on which the certificate was last updated.
	UpdatedAt *time.Time `json:"updated_at"`

	// StatusDetails: additional information about the certificate status (useful in case of certificate generation failure, for example).
	StatusDetails *string `json:"status_details"`
}

Certificate: certificate.

type CertificateStatus

type CertificateStatus string

func (CertificateStatus) MarshalJSON

func (enum CertificateStatus) MarshalJSON() ([]byte, error)

func (CertificateStatus) String

func (enum CertificateStatus) String() string

func (*CertificateStatus) UnmarshalJSON

func (enum *CertificateStatus) UnmarshalJSON(data []byte) error

type CertificateType

type CertificateType string

func (CertificateType) MarshalJSON

func (enum CertificateType) MarshalJSON() ([]byte, error)

func (CertificateType) String

func (enum CertificateType) String() string

func (*CertificateType) UnmarshalJSON

func (enum *CertificateType) UnmarshalJSON(data []byte) error

type CreateACLRequest

type CreateACLRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// FrontendID: frontend ID to attach the ACL to.
	FrontendID string `json:"-"`

	// Name: ACL name.
	Name string `json:"name"`

	// Action: action to take when incoming traffic matches an ACL filter.
	Action *ACLAction `json:"action"`

	// Match: ACL match filter object. One of `ip_subnet` or `http_filter` & `http_filter_value` are required.
	Match *ACLMatch `json:"match,omitempty"`

	// Index: priority of this ACL (ACLs are applied in ascending order, 0 is the first ACL executed).
	Index int32 `json:"index"`

	// Description: ACL description.
	Description string `json:"description"`
}

CreateACLRequest: Add an ACL to a Load Balancer frontend.

type CreateBackendRequest

type CreateBackendRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// Name: name for the backend.
	Name string `json:"name"`

	// ForwardProtocol: protocol to be used by the backend when forwarding traffic to backend servers.
	// Default value: tcp
	ForwardProtocol Protocol `json:"forward_protocol"`

	// ForwardPort: port to be used by the backend when forwarding traffic to backend servers.
	ForwardPort int32 `json:"forward_port"`

	// ForwardPortAlgorithm: load balancing algorithm to be used when determining which backend server to forward new traffic to.
	// Default value: roundrobin
	ForwardPortAlgorithm ForwardPortAlgorithm `json:"forward_port_algorithm"`

	// StickySessions: 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.
	// Default value: none
	StickySessions StickySessionsType `json:"sticky_sessions"`

	// StickySessionsCookieName: cookie name for cookie-based sticky sessions.
	StickySessionsCookieName string `json:"sticky_sessions_cookie_name"`

	// HealthCheck: object defining the health check to be carried out by the backend when checking the status and health of backend servers.
	HealthCheck *HealthCheck `json:"health_check"`

	// ServerIP: list of backend server IP addresses (IPv4 or IPv6) the backend should forward traffic to.
	ServerIP []string `json:"server_ip"`

	// Deprecated: SendProxyV2: deprecated in favor of proxy_protocol field.
	SendProxyV2 *bool `json:"send_proxy_v2,omitempty"`

	// TimeoutServer: maximum allowed time for a backend server to process a request.
	TimeoutServer *time.Duration `json:"timeout_server,omitempty"`

	// TimeoutConnect: maximum allowed time for establishing a connection to a backend server.
	TimeoutConnect *time.Duration `json:"timeout_connect,omitempty"`

	// TimeoutTunnel: maximum allowed tunnel inactivity time after Websocket is established (takes precedence over client and server timeout).
	TimeoutTunnel *time.Duration `json:"timeout_tunnel,omitempty"`

	// OnMarkedDownAction: action to take when a backend server is marked as down.
	// Default value: on_marked_down_action_none
	OnMarkedDownAction OnMarkedDownAction `json:"on_marked_down_action"`

	// ProxyProtocol: 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.
	// Default value: proxy_protocol_unknown
	ProxyProtocol ProxyProtocol `json:"proxy_protocol"`

	// FailoverHost: scaleway S3 bucket website to be served as failover if all backend servers are down, e.g. failover-website.s3-website.fr-par.scw.cloud.
	FailoverHost *string `json:"failover_host,omitempty"`

	// SslBridging: defines whether to enable SSL bridging between the Load Balancer and backend servers.
	SslBridging *bool `json:"ssl_bridging,omitempty"`

	// IgnoreSslServerVerify: defines whether the server certificate verification should be ignored.
	IgnoreSslServerVerify *bool `json:"ignore_ssl_server_verify,omitempty"`

	// RedispatchAttemptCount: whether to use another backend server on each attempt.
	RedispatchAttemptCount *int32 `json:"redispatch_attempt_count,omitempty"`

	// MaxRetries: number of retries when a backend server connection failed.
	MaxRetries *int32 `json:"max_retries,omitempty"`

	// MaxConnections: maximum number of connections allowed per backend server.
	MaxConnections *int32 `json:"max_connections,omitempty"`

	// TimeoutQueue: maximum time for a request to be left pending in queue when `max_connections` is reached.
	TimeoutQueue *scw.Duration `json:"timeout_queue,omitempty"`
}

CreateBackendRequest: create backend request.

func (CreateBackendRequest) MarshalJSON

func (m CreateBackendRequest) MarshalJSON() ([]byte, error)

func (*CreateBackendRequest) UnmarshalJSON

func (m *CreateBackendRequest) UnmarshalJSON(b []byte) error

type CreateCertificateRequest

type CreateCertificateRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// Name: name for the certificate.
	Name string `json:"name"`

	// Letsencrypt: object to define a new Let's Encrypt certificate to be generated.
	// Precisely one of Letsencrypt, CustomCertificate must be set.
	Letsencrypt *CreateCertificateRequestLetsencryptConfig `json:"letsencrypt,omitempty"`

	// CustomCertificate: object to define an existing custom certificate to be imported.
	// Precisely one of Letsencrypt, CustomCertificate must be set.
	CustomCertificate *CreateCertificateRequestCustomCertificate `json:"custom_certificate,omitempty"`
}

CreateCertificateRequest: create certificate request.

type CreateCertificateRequestCustomCertificate

type CreateCertificateRequestCustomCertificate struct {
	// CertificateChain: full PEM-formatted certificate, consisting of the entire certificate chain including public key, private key, and (optionally) Certificate Authorities.
	CertificateChain string `json:"certificate_chain"`
}

CreateCertificateRequestCustomCertificate: create certificate request custom certificate.

type CreateCertificateRequestLetsencryptConfig

type CreateCertificateRequestLetsencryptConfig struct {
	// CommonName: main domain name of certificate (this domain must exist and resolve to your Load Balancer IP address).
	CommonName string `json:"common_name"`

	// SubjectAlternativeName: alternative domain names (all domain names must exist and resolve to your Load Balancer IP address).
	SubjectAlternativeName []string `json:"subject_alternative_name"`
}

CreateCertificateRequestLetsencryptConfig: create certificate request letsencrypt config.

type CreateFrontendRequest

type CreateFrontendRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load Balancer ID (ID of the Load Balancer to attach the frontend to).
	LBID string `json:"-"`

	// Name: name for the frontend.
	Name string `json:"name"`

	// InboundPort: port the frontend should listen on.
	InboundPort int32 `json:"inbound_port"`

	// BackendID: backend ID (ID of the backend the frontend should pass traffic to).
	BackendID string `json:"backend_id"`

	// TimeoutClient: maximum allowed inactivity time on the client side.
	TimeoutClient *time.Duration `json:"timeout_client,omitempty"`

	// Deprecated: CertificateID: certificate ID, deprecated in favor of certificate_ids array.
	CertificateID *string `json:"certificate_id,omitempty"`

	// CertificateIDs: list of SSL/TLS certificate IDs to bind to the frontend.
	CertificateIDs *[]string `json:"certificate_ids,omitempty"`

	// EnableHTTP3: defines whether to enable HTTP/3 protocol on the frontend.
	EnableHTTP3 bool `json:"enable_http3"`
}

CreateFrontendRequest: create frontend request.

func (CreateFrontendRequest) MarshalJSON

func (m CreateFrontendRequest) MarshalJSON() ([]byte, error)

func (*CreateFrontendRequest) UnmarshalJSON

func (m *CreateFrontendRequest) UnmarshalJSON(b []byte) error

type CreateIPRequest

type CreateIPRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// Deprecated: OrganizationID: organization ID of the Organization where the IP address should be created.
	// Precisely one of ProjectID, OrganizationID must be set.
	OrganizationID *string `json:"organization_id,omitempty"`

	// ProjectID: project ID of the Project where the IP address should be created.
	// Precisely one of ProjectID, OrganizationID must be set.
	ProjectID *string `json:"project_id,omitempty"`

	// Reverse: reverse DNS (domain name) for the IP address.
	Reverse *string `json:"reverse,omitempty"`

	// IsIPv6: if true, creates a Flexible IP with an ipv6 address.
	IsIPv6 bool `json:"is_ipv6"`
}

CreateIPRequest: create ip request.

type CreateLBRequest

type CreateLBRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// Deprecated: OrganizationID: scaleway Organization to create the Load Balancer in.
	// Precisely one of ProjectID, OrganizationID must be set.
	OrganizationID *string `json:"organization_id,omitempty"`

	// ProjectID: scaleway Project to create the Load Balancer in.
	// Precisely one of ProjectID, OrganizationID must be set.
	ProjectID *string `json:"project_id,omitempty"`

	// Name: name for the Load Balancer.
	Name string `json:"name"`

	// Description: description for the Load Balancer.
	Description string `json:"description"`

	// Deprecated: IPID: ID of an existing flexible IP address to attach to the Load Balancer.
	IPID *string `json:"ip_id,omitempty"`

	// AssignFlexibleIP: defines whether to automatically assign a flexible public IP to lb. Default value is `false` (do not assign).
	AssignFlexibleIP *bool `json:"assign_flexible_ip,omitempty"`

	// AssignFlexibleIPv6: defines whether to automatically assign a flexible public IPv6 to the Load Balancer. Default value is `false` (do not assign).
	AssignFlexibleIPv6 *bool `json:"assign_flexible_ipv6,omitempty"`

	// IPIDs: list of IP IDs to attach to the Load Balancer.
	IPIDs []string `json:"ip_ids"`

	// Tags: list of tags for the Load Balancer.
	Tags []string `json:"tags"`

	// Type: load Balancer commercial offer type. Use the Load Balancer types endpoint to retrieve a list of available offer types.
	Type string `json:"type"`

	// SslCompatibilityLevel: 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. Modern is suitable for services with clients that support TLS 1.3 and do not need backward compatibility. Old is compatible with a small number of very old clients and should be used only as a last resort.
	// Default value: ssl_compatibility_level_unknown
	SslCompatibilityLevel SSLCompatibilityLevel `json:"ssl_compatibility_level"`
}

CreateLBRequest: create lb request.

type CreateRouteRequest

type CreateRouteRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// FrontendID: ID of the source frontend to create the route on.
	FrontendID string `json:"frontend_id"`

	// BackendID: ID of the target backend for the route.
	BackendID string `json:"backend_id"`

	// Match: 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.
	Match *RouteMatch `json:"match,omitempty"`
}

CreateRouteRequest: create route request.

type CreateSubscriberRequest

type CreateSubscriberRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// Name: subscriber name.
	Name string `json:"name"`

	// EmailConfig: email address configuration.
	// Precisely one of EmailConfig, WebhookConfig must be set.
	EmailConfig *SubscriberEmailConfig `json:"email_config,omitempty"`

	// WebhookConfig: webHook URI configuration.
	// Precisely one of EmailConfig, WebhookConfig must be set.
	WebhookConfig *SubscriberWebhookConfig `json:"webhook_config,omitempty"`

	// Deprecated: OrganizationID: organization ID to create the subscriber in.
	// Precisely one of ProjectID, OrganizationID must be set.
	OrganizationID *string `json:"organization_id,omitempty"`

	// ProjectID: project ID to create the subscriber in.
	// Precisely one of ProjectID, OrganizationID must be set.
	ProjectID *string `json:"project_id,omitempty"`
}

CreateSubscriberRequest: Create a new alert subscriber (webhook or email).

type DeleteACLRequest

type DeleteACLRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// ACLID: ACL ID.
	ACLID string `json:"-"`
}

DeleteACLRequest: delete acl request.

type DeleteBackendRequest

type DeleteBackendRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// BackendID: ID of the backend to delete.
	BackendID string `json:"-"`
}

DeleteBackendRequest: delete backend request.

type DeleteCertificateRequest

type DeleteCertificateRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// CertificateID: certificate ID.
	CertificateID string `json:"-"`
}

DeleteCertificateRequest: delete certificate request.

type DeleteFrontendRequest

type DeleteFrontendRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// FrontendID: ID of the frontend to delete.
	FrontendID string `json:"-"`
}

DeleteFrontendRequest: delete frontend request.

type DeleteLBRequest

type DeleteLBRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: ID of the Load Balancer to delete.
	LBID string `json:"-"`

	// ReleaseIP: 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.
	ReleaseIP bool `json:"release_ip"`
}

DeleteLBRequest: delete lb request.

type DeleteRouteRequest

type DeleteRouteRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// RouteID: route ID.
	RouteID string `json:"-"`
}

DeleteRouteRequest: delete route request.

type DeleteSubscriberRequest

type DeleteSubscriberRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// SubscriberID: subscriber ID.
	SubscriberID string `json:"-"`
}

DeleteSubscriberRequest: delete subscriber request.

type DetachPrivateNetworkRequest

type DetachPrivateNetworkRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load balancer ID.
	LBID string `json:"-"`

	// PrivateNetworkID: set your instance private network id.
	PrivateNetworkID string `json:"-"`
}

DetachPrivateNetworkRequest: detach private network request.

type ForwardPortAlgorithm

type ForwardPortAlgorithm string

func (ForwardPortAlgorithm) MarshalJSON

func (enum ForwardPortAlgorithm) MarshalJSON() ([]byte, error)

func (ForwardPortAlgorithm) String

func (enum ForwardPortAlgorithm) String() string

func (*ForwardPortAlgorithm) UnmarshalJSON

func (enum *ForwardPortAlgorithm) UnmarshalJSON(data []byte) error

type Frontend

type Frontend struct {
	// ID: frontend ID.
	ID string `json:"id"`

	// Name: name of the frontend.
	Name string `json:"name"`

	// InboundPort: port the frontend listens on.
	InboundPort int32 `json:"inbound_port"`

	// Backend: backend object the frontend is attached to.
	Backend *Backend `json:"backend"`

	// LB: load Balancer object the frontend is attached to.
	LB *LB `json:"lb"`

	// TimeoutClient: maximum allowed inactivity time on the client side.
	TimeoutClient *time.Duration `json:"timeout_client"`

	// Deprecated: Certificate: certificate, deprecated in favor of certificate_ids array.
	Certificate *Certificate `json:"certificate,omitempty"`

	// CertificateIDs: list of SSL/TLS certificate IDs to bind to the frontend.
	CertificateIDs []string `json:"certificate_ids"`

	// CreatedAt: date on which the frontend was created.
	CreatedAt *time.Time `json:"created_at"`

	// UpdatedAt: date on which the frontend was last updated.
	UpdatedAt *time.Time `json:"updated_at"`

	// EnableHTTP3: defines whether to enable HTTP/3 protocol on the frontend.
	EnableHTTP3 bool `json:"enable_http3"`
}

Frontend: frontend.

func (Frontend) MarshalJSON

func (m Frontend) MarshalJSON() ([]byte, error)

func (*Frontend) UnmarshalJSON

func (m *Frontend) UnmarshalJSON(b []byte) error

type GetACLRequest

type GetACLRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// ACLID: ACL ID.
	ACLID string `json:"-"`
}

GetACLRequest: get acl request.

type GetBackendRequest

type GetBackendRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// BackendID: backend ID.
	BackendID string `json:"-"`
}

GetBackendRequest: get backend request.

type GetCertificateRequest

type GetCertificateRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// CertificateID: certificate ID.
	CertificateID string `json:"-"`
}

GetCertificateRequest: get certificate request.

type GetFrontendRequest

type GetFrontendRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// FrontendID: frontend ID.
	FrontendID string `json:"-"`
}

GetFrontendRequest: get frontend request.

type GetIPRequest

type GetIPRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// IPID: IP address ID.
	IPID string `json:"-"`
}

GetIPRequest: get ip request.

type GetLBRequest

type GetLBRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`
}

GetLBRequest: get lb request.

type GetLBStatsRequest

type GetLBStatsRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// BackendID: ID of the backend.
	BackendID *string `json:"backend_id,omitempty"`
}

GetLBStatsRequest: Get Load Balancer stats.

type GetRouteRequest

type GetRouteRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// RouteID: route ID.
	RouteID string `json:"-"`
}

GetRouteRequest: get route request.

type GetSubscriberRequest

type GetSubscriberRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// SubscriberID: subscriber ID.
	SubscriberID string `json:"-"`
}

GetSubscriberRequest: get subscriber request.

type HealthCheck

type HealthCheck struct {
	// Port: port to use for the backend server health check.
	Port int32 `json:"port"`

	// CheckDelay: time to wait between two consecutive health checks.
	CheckDelay *time.Duration `json:"check_delay"`

	// CheckTimeout: maximum time a backend server has to reply to the health check.
	CheckTimeout *time.Duration `json:"check_timeout"`

	// CheckMaxRetries: number of consecutive unsuccessful health checks after which the server will be considered dead.
	CheckMaxRetries int32 `json:"check_max_retries"`

	// TCPConfig: object to configure a basic TCP health check.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	TCPConfig *HealthCheckTCPConfig `json:"tcp_config,omitempty"`

	// MysqlConfig: object to configure a MySQL health check. The check requires MySQL >=3.22, for older versions, use a TCP health check.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	MysqlConfig *HealthCheckMysqlConfig `json:"mysql_config,omitempty"`

	// PgsqlConfig: object to configure a PostgreSQL health check.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	PgsqlConfig *HealthCheckPgsqlConfig `json:"pgsql_config,omitempty"`

	// LdapConfig: object to configure an LDAP health check. The response is analyzed to find the LDAPv3 response message.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	LdapConfig *HealthCheckLdapConfig `json:"ldap_config,omitempty"`

	// RedisConfig: object to configure a Redis health check. The response is analyzed to find the +PONG response message.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	RedisConfig *HealthCheckRedisConfig `json:"redis_config,omitempty"`

	// HTTPConfig: object to configure an HTTP health check.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	HTTPConfig *HealthCheckHTTPConfig `json:"http_config,omitempty"`

	// HTTPSConfig: object to configure an HTTPS health check.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	HTTPSConfig *HealthCheckHTTPSConfig `json:"https_config,omitempty"`

	// CheckSendProxy: defines whether proxy protocol should be activated for the health check.
	CheckSendProxy bool `json:"check_send_proxy"`

	// TransientCheckDelay: time to wait between two consecutive health checks when a backend server is in a transient state (going UP or DOWN).
	TransientCheckDelay *scw.Duration `json:"transient_check_delay"`
}

HealthCheck: health check.

func (HealthCheck) MarshalJSON

func (m HealthCheck) MarshalJSON() ([]byte, error)

func (*HealthCheck) UnmarshalJSON

func (m *HealthCheck) UnmarshalJSON(b []byte) error

type HealthCheckHTTPConfig

type HealthCheckHTTPConfig struct {
	// URI: the HTTP URI to use when performing a health check on backend servers.
	URI string `json:"uri"`

	// Method: the HTTP method used when performing a health check on backend servers.
	Method string `json:"method"`

	// Code: the HTTP response code that should be returned for a health check to be considered successful.
	Code *int32 `json:"code"`

	// HostHeader: the HTTP host header used when performing a health check on backend servers.
	HostHeader string `json:"host_header"`
}

HealthCheckHTTPConfig: health check http config.

type HealthCheckHTTPSConfig

type HealthCheckHTTPSConfig struct {
	// URI: the HTTP URI to use when performing a health check on backend servers.
	URI string `json:"uri"`

	// Method: the HTTP method used when performing a health check on backend servers.
	Method string `json:"method"`

	// Code: the HTTP response code that should be returned for a health check to be considered successful.
	Code *int32 `json:"code"`

	// HostHeader: the HTTP host header used when performing a health check on backend servers.
	HostHeader string `json:"host_header"`

	// Sni: the SNI value used when performing a health check on backend servers over SSL.
	Sni string `json:"sni"`
}

HealthCheckHTTPSConfig: health check https config.

type HealthCheckLdapConfig

type HealthCheckLdapConfig struct {
}

HealthCheckLdapConfig: health check ldap config.

type HealthCheckMysqlConfig

type HealthCheckMysqlConfig struct {
	// User: mySQL user to use for the health check.
	User string `json:"user"`
}

HealthCheckMysqlConfig: health check mysql config.

type HealthCheckPgsqlConfig

type HealthCheckPgsqlConfig struct {
	// User: postgreSQL user to use for the health check.
	User string `json:"user"`
}

HealthCheckPgsqlConfig: health check pgsql config.

type HealthCheckRedisConfig

type HealthCheckRedisConfig struct {
}

HealthCheckRedisConfig: health check redis config.

type HealthCheckTCPConfig

type HealthCheckTCPConfig struct {
}

HealthCheckTCPConfig: health check tcp config.

type IP

type IP struct {
	// ID: IP address ID.
	ID string `json:"id"`

	// IPAddress: IP address.
	IPAddress string `json:"ip_address"`

	// OrganizationID: organization ID of the Scaleway Organization the IP address is in.
	OrganizationID string `json:"organization_id"`

	// ProjectID: project ID of the Scaleway Project the IP address is in.
	ProjectID string `json:"project_id"`

	// LBID: load Balancer ID.
	LBID *string `json:"lb_id"`

	// Reverse: reverse DNS (domain name) of the IP address.
	Reverse string `json:"reverse"`

	// Deprecated: Region: the region the IP address is in.
	Region *scw.Region `json:"region,omitempty"`

	// Zone: the zone the IP address is in.
	Zone scw.Zone `json:"zone"`
}

IP: ip.

type Instance

type Instance struct {
	// ID: underlying Instance ID.
	ID string `json:"id"`

	// Status: instance status.
	// Default value: unknown
	Status InstanceStatus `json:"status"`

	// IPAddress: instance IP address.
	IPAddress string `json:"ip_address"`

	// CreatedAt: date on which the Instance was created.
	CreatedAt *time.Time `json:"created_at"`

	// UpdatedAt: date on which the Instance was last updated.
	UpdatedAt *time.Time `json:"updated_at"`

	// Deprecated: Region: the region the Instance is in.
	Region *scw.Region `json:"region,omitempty"`

	// Zone: the zone the Instance is in.
	Zone scw.Zone `json:"zone"`
}

Instance: instance.

type InstanceStatus

type InstanceStatus string

func (InstanceStatus) MarshalJSON

func (enum InstanceStatus) MarshalJSON() ([]byte, error)

func (InstanceStatus) String

func (enum InstanceStatus) String() string

func (*InstanceStatus) UnmarshalJSON

func (enum *InstanceStatus) UnmarshalJSON(data []byte) error

type LB

type LB struct {
	// ID: underlying Instance ID.
	ID string `json:"id"`

	// Name: load Balancer name.
	Name string `json:"name"`

	// Description: load Balancer description.
	Description string `json:"description"`

	// Status: load Balancer status.
	// Default value: unknown
	Status LBStatus `json:"status"`

	// Instances: list of underlying Instances.
	Instances []*Instance `json:"instances"`

	// OrganizationID: scaleway Organization ID.
	OrganizationID string `json:"organization_id"`

	// ProjectID: scaleway Project ID.
	ProjectID string `json:"project_id"`

	// IP: list of IP addresses attached to the Load Balancer.
	IP []*IP `json:"ip"`

	// Tags: load Balancer tags.
	Tags []string `json:"tags"`

	// FrontendCount: number of frontends the Load Balancer has.
	FrontendCount int32 `json:"frontend_count"`

	// BackendCount: number of backends the Load Balancer has.
	BackendCount int32 `json:"backend_count"`

	// Type: load Balancer offer type.
	Type string `json:"type"`

	// Subscriber: subscriber information.
	Subscriber *Subscriber `json:"subscriber"`

	// SslCompatibilityLevel: determines the minimal SSL version which needs to be supported on client side.
	// Default value: ssl_compatibility_level_unknown
	SslCompatibilityLevel SSLCompatibilityLevel `json:"ssl_compatibility_level"`

	// CreatedAt: date on which the Load Balancer was created.
	CreatedAt *time.Time `json:"created_at"`

	// UpdatedAt: date on which the Load Balancer was last updated.
	UpdatedAt *time.Time `json:"updated_at"`

	// PrivateNetworkCount: number of Private Networks attached to the Load Balancer.
	PrivateNetworkCount int32 `json:"private_network_count"`

	// RouteCount: number of routes configured on the Load Balancer.
	RouteCount int32 `json:"route_count"`

	// Deprecated: Region: the region the Load Balancer is in.
	Region *scw.Region `json:"region,omitempty"`

	// Zone: the zone the Load Balancer is in.
	Zone scw.Zone `json:"zone"`
}

LB: lb.

type LBStats

type LBStats struct {
	// BackendServersStats: list of objects containing Load Balancer statistics.
	BackendServersStats []*BackendServerStats `json:"backend_servers_stats"`
}

LBStats: lb stats.

type LBStatus

type LBStatus string

func (LBStatus) MarshalJSON

func (enum LBStatus) MarshalJSON() ([]byte, error)

func (LBStatus) String

func (enum LBStatus) String() string

func (*LBStatus) UnmarshalJSON

func (enum *LBStatus) UnmarshalJSON(data []byte) error

type LBType

type LBType struct {
	// Name: load Balancer commercial offer type name.
	Name string `json:"name"`

	// StockStatus: current stock status for a given Load Balancer type.
	// Default value: unknown
	StockStatus LBTypeStock `json:"stock_status"`

	// Description: load Balancer commercial offer type description.
	Description string `json:"description"`

	// Deprecated: Region: the region the Load Balancer stock is in.
	Region *scw.Region `json:"region,omitempty"`

	// Zone: the zone the Load Balancer stock is in.
	Zone scw.Zone `json:"zone"`
}

LBType: lb type.

type LBTypeStock

type LBTypeStock string

func (LBTypeStock) MarshalJSON

func (enum LBTypeStock) MarshalJSON() ([]byte, error)

func (LBTypeStock) String

func (enum LBTypeStock) String() string

func (*LBTypeStock) UnmarshalJSON

func (enum *LBTypeStock) UnmarshalJSON(data []byte) error

type ListACLRequestOrderBy

type ListACLRequestOrderBy string

func (ListACLRequestOrderBy) MarshalJSON

func (enum ListACLRequestOrderBy) MarshalJSON() ([]byte, error)

func (ListACLRequestOrderBy) String

func (enum ListACLRequestOrderBy) String() string

func (*ListACLRequestOrderBy) UnmarshalJSON

func (enum *ListACLRequestOrderBy) UnmarshalJSON(data []byte) error

type ListACLResponse

type ListACLResponse struct {
	// ACLs: list of ACL objects.
	ACLs []*ACL `json:"acls"`

	// TotalCount: the total number of objects.
	TotalCount uint32 `json:"total_count"`
}

ListACLResponse: list acl response.

func (*ListACLResponse) UnsafeAppend

func (r *ListACLResponse) UnsafeAppend(res interface{}) (uint32, error)

UnsafeAppend should not be used Internal usage only

func (*ListACLResponse) UnsafeGetTotalCount

func (r *ListACLResponse) UnsafeGetTotalCount() uint32

UnsafeGetTotalCount should not be used Internal usage only

type ListACLsRequest

type ListACLsRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// FrontendID: frontend ID (ACLs attached to this frontend will be returned in the response).
	FrontendID string `json:"-"`

	// OrderBy: sort order of ACLs in the response.
	// Default value: created_at_asc
	OrderBy ListACLRequestOrderBy `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: the number of ACLs to return.
	PageSize *uint32 `json:"-"`

	// Name: ACL name to filter for.
	Name *string `json:"-"`
}

ListACLsRequest: list ac ls request.

type ListBackendStatsRequest

type ListBackendStatsRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: number of items to return.
	PageSize *uint32 `json:"-"`

	// BackendID: ID of the backend.
	BackendID *string `json:"-"`
}

ListBackendStatsRequest: list backend stats request.

type ListBackendStatsResponse

type ListBackendStatsResponse struct {
	// BackendServersStats: list of objects containing backend server statistics.
	BackendServersStats []*BackendServerStats `json:"backend_servers_stats"`

	// TotalCount: the total number of objects.
	TotalCount uint32 `json:"total_count"`
}

ListBackendStatsResponse: list backend stats response.

func (*ListBackendStatsResponse) UnsafeAppend

func (r *ListBackendStatsResponse) UnsafeAppend(res interface{}) (uint32, error)

UnsafeAppend should not be used Internal usage only

func (*ListBackendStatsResponse) UnsafeGetTotalCount

func (r *ListBackendStatsResponse) UnsafeGetTotalCount() uint32

UnsafeGetTotalCount should not be used Internal usage only

type ListBackendsRequest

type ListBackendsRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// Name: name of the backend to filter for.
	Name *string `json:"-"`

	// OrderBy: sort order of backends in the response.
	// Default value: created_at_asc
	OrderBy ListBackendsRequestOrderBy `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: number of backends to return.
	PageSize *uint32 `json:"-"`
}

ListBackendsRequest: list backends request.

type ListBackendsRequestOrderBy

type ListBackendsRequestOrderBy string

func (ListBackendsRequestOrderBy) MarshalJSON

func (enum ListBackendsRequestOrderBy) MarshalJSON() ([]byte, error)

func (ListBackendsRequestOrderBy) String

func (enum ListBackendsRequestOrderBy) String() string

func (*ListBackendsRequestOrderBy) UnmarshalJSON

func (enum *ListBackendsRequestOrderBy) UnmarshalJSON(data []byte) error

type ListBackendsResponse

type ListBackendsResponse struct {
	// Backends: list of backend objects of a given Load Balancer.
	Backends []*Backend `json:"backends"`

	// TotalCount: total count of backend objects, without pagination.
	TotalCount uint32 `json:"total_count"`
}

ListBackendsResponse: list backends response.

func (*ListBackendsResponse) UnsafeAppend

func (r *ListBackendsResponse) UnsafeAppend(res interface{}) (uint32, error)

UnsafeAppend should not be used Internal usage only

func (*ListBackendsResponse) UnsafeGetTotalCount

func (r *ListBackendsResponse) UnsafeGetTotalCount() uint32

UnsafeGetTotalCount should not be used Internal usage only

type ListCertificatesRequest

type ListCertificatesRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// OrderBy: sort order of certificates in the response.
	// Default value: created_at_asc
	OrderBy ListCertificatesRequestOrderBy `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: number of certificates to return.
	PageSize *uint32 `json:"-"`

	// Name: certificate name to filter for, only certificates of this name will be returned.
	Name *string `json:"-"`
}

ListCertificatesRequest: list certificates request.

type ListCertificatesRequestOrderBy

type ListCertificatesRequestOrderBy string

func (ListCertificatesRequestOrderBy) MarshalJSON

func (enum ListCertificatesRequestOrderBy) MarshalJSON() ([]byte, error)

func (ListCertificatesRequestOrderBy) String

func (enum ListCertificatesRequestOrderBy) String() string

func (*ListCertificatesRequestOrderBy) UnmarshalJSON

func (enum *ListCertificatesRequestOrderBy) UnmarshalJSON(data []byte) error

type ListCertificatesResponse

type ListCertificatesResponse struct {
	// Certificates: list of certificate objects.
	Certificates []*Certificate `json:"certificates"`

	// TotalCount: the total number of objects.
	TotalCount uint32 `json:"total_count"`
}

ListCertificatesResponse: list certificates response.

func (*ListCertificatesResponse) UnsafeAppend

func (r *ListCertificatesResponse) UnsafeAppend(res interface{}) (uint32, error)

UnsafeAppend should not be used Internal usage only

func (*ListCertificatesResponse) UnsafeGetTotalCount

func (r *ListCertificatesResponse) UnsafeGetTotalCount() uint32

UnsafeGetTotalCount should not be used Internal usage only

type ListFrontendsRequest

type ListFrontendsRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// Name: name of the frontend to filter for.
	Name *string `json:"-"`

	// OrderBy: sort order of frontends in the response.
	// Default value: created_at_asc
	OrderBy ListFrontendsRequestOrderBy `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: number of frontends to return.
	PageSize *uint32 `json:"-"`
}

ListFrontendsRequest: list frontends request.

type ListFrontendsRequestOrderBy

type ListFrontendsRequestOrderBy string

func (ListFrontendsRequestOrderBy) MarshalJSON

func (enum ListFrontendsRequestOrderBy) MarshalJSON() ([]byte, error)

func (ListFrontendsRequestOrderBy) String

func (enum ListFrontendsRequestOrderBy) String() string

func (*ListFrontendsRequestOrderBy) UnmarshalJSON

func (enum *ListFrontendsRequestOrderBy) UnmarshalJSON(data []byte) error

type ListFrontendsResponse

type ListFrontendsResponse struct {
	// Frontends: list of frontend objects of a given Load Balancer.
	Frontends []*Frontend `json:"frontends"`

	// TotalCount: total count of frontend objects, without pagination.
	TotalCount uint32 `json:"total_count"`
}

ListFrontendsResponse: list frontends response.

func (*ListFrontendsResponse) UnsafeAppend

func (r *ListFrontendsResponse) UnsafeAppend(res interface{}) (uint32, error)

UnsafeAppend should not be used Internal usage only

func (*ListFrontendsResponse) UnsafeGetTotalCount

func (r *ListFrontendsResponse) UnsafeGetTotalCount() uint32

UnsafeGetTotalCount should not be used Internal usage only

type ListIPsRequest

type ListIPsRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: number of IP addresses to return.
	PageSize *uint32 `json:"-"`

	// IPAddress: IP address to filter for.
	IPAddress *string `json:"-"`

	// OrganizationID: organization ID to filter for, only Load Balancer IP addresses from this Organization will be returned.
	OrganizationID *string `json:"-"`

	// ProjectID: project ID to filter for, only Load Balancer IP addresses from this Project will be returned.
	ProjectID *string `json:"-"`

	// IPType: IP type to filter for.
	// Default value: all
	IPType ListIPsRequestIPType `json:"-"`
}

ListIPsRequest: list i ps request.

type ListIPsRequestIPType

type ListIPsRequestIPType string

func (ListIPsRequestIPType) MarshalJSON

func (enum ListIPsRequestIPType) MarshalJSON() ([]byte, error)

func (ListIPsRequestIPType) String

func (enum ListIPsRequestIPType) String() string

func (*ListIPsRequestIPType) UnmarshalJSON

func (enum *ListIPsRequestIPType) UnmarshalJSON(data []byte) error

type ListIPsResponse

type ListIPsResponse struct {
	// IPs: list of IP address objects.
	IPs []*IP `json:"ips"`

	// TotalCount: total count of IP address objects, without pagination.
	TotalCount uint32 `json:"total_count"`
}

ListIPsResponse: list i ps response.

func (*ListIPsResponse) UnsafeAppend

func (r *ListIPsResponse) UnsafeAppend(res interface{}) (uint32, error)

UnsafeAppend should not be used Internal usage only

func (*ListIPsResponse) UnsafeGetTotalCount

func (r *ListIPsResponse) UnsafeGetTotalCount() uint32

UnsafeGetTotalCount should not be used Internal usage only

type ListLBPrivateNetworksRequest

type ListLBPrivateNetworksRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// OrderBy: sort order of Private Network objects in the response.
	// Default value: created_at_asc
	OrderBy ListPrivateNetworksRequestOrderBy `json:"-"`

	// PageSize: number of objects to return.
	PageSize *uint32 `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`
}

ListLBPrivateNetworksRequest: list lb private networks request.

type ListLBPrivateNetworksResponse

type ListLBPrivateNetworksResponse struct {
	// PrivateNetwork: list of Private Network objects attached to the Load Balancer.
	PrivateNetwork []*PrivateNetwork `json:"private_network"`

	// TotalCount: total number of objects in the response.
	TotalCount uint32 `json:"total_count"`
}

ListLBPrivateNetworksResponse: list lb private networks response.

func (*ListLBPrivateNetworksResponse) UnsafeAppend

func (r *ListLBPrivateNetworksResponse) UnsafeAppend(res interface{}) (uint32, error)

UnsafeAppend should not be used Internal usage only

func (*ListLBPrivateNetworksResponse) UnsafeGetTotalCount

func (r *ListLBPrivateNetworksResponse) UnsafeGetTotalCount() uint32

UnsafeGetTotalCount should not be used Internal usage only

type ListLBTypesRequest

type ListLBTypesRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: the number of items to return.
	PageSize *uint32 `json:"-"`
}

ListLBTypesRequest: list lb types request.

type ListLBTypesResponse

type ListLBTypesResponse struct {
	// LBTypes: list of Load Balancer commercial offer type objects.
	LBTypes []*LBType `json:"lb_types"`

	// TotalCount: total number of Load Balancer offer type objects.
	TotalCount uint32 `json:"total_count"`
}

ListLBTypesResponse: list lb types response.

func (*ListLBTypesResponse) UnsafeAppend

func (r *ListLBTypesResponse) UnsafeAppend(res interface{}) (uint32, error)

UnsafeAppend should not be used Internal usage only

func (*ListLBTypesResponse) UnsafeGetTotalCount

func (r *ListLBTypesResponse) UnsafeGetTotalCount() uint32

UnsafeGetTotalCount should not be used Internal usage only

type ListLBsRequest

type ListLBsRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// Name: load Balancer name to filter for.
	Name *string `json:"-"`

	// OrderBy: sort order of Load Balancers in the response.
	// Default value: created_at_asc
	OrderBy ListLBsRequestOrderBy `json:"-"`

	// PageSize: number of Load Balancers to return.
	PageSize *uint32 `json:"-"`

	// Page: page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// OrganizationID: organization ID to filter for, only Load Balancers from this Organization will be returned.
	OrganizationID *string `json:"-"`

	// ProjectID: project ID to filter for, only Load Balancers from this Project will be returned.
	ProjectID *string `json:"-"`

	// Tags: filter by tag, only Load Balancers with one or more matching tags will be returned.
	Tags []string `json:"-"`
}

ListLBsRequest: list l bs request.

type ListLBsRequestOrderBy

type ListLBsRequestOrderBy string

func (ListLBsRequestOrderBy) MarshalJSON

func (enum ListLBsRequestOrderBy) MarshalJSON() ([]byte, error)

func (ListLBsRequestOrderBy) String

func (enum ListLBsRequestOrderBy) String() string

func (*ListLBsRequestOrderBy) UnmarshalJSON

func (enum *ListLBsRequestOrderBy) UnmarshalJSON(data []byte) error

type ListLBsResponse

type ListLBsResponse struct {
	// LBs: list of Load Balancer objects.
	LBs []*LB `json:"lbs"`

	// TotalCount: the total number of Load Balancer objects.
	TotalCount uint32 `json:"total_count"`
}

ListLBsResponse: list l bs response.

func (*ListLBsResponse) UnsafeAppend

func (r *ListLBsResponse) UnsafeAppend(res interface{}) (uint32, error)

UnsafeAppend should not be used Internal usage only

func (*ListLBsResponse) UnsafeGetTotalCount

func (r *ListLBsResponse) UnsafeGetTotalCount() uint32

UnsafeGetTotalCount should not be used Internal usage only

type ListPrivateNetworksRequestOrderBy

type ListPrivateNetworksRequestOrderBy string

func (ListPrivateNetworksRequestOrderBy) MarshalJSON

func (enum ListPrivateNetworksRequestOrderBy) MarshalJSON() ([]byte, error)

func (ListPrivateNetworksRequestOrderBy) String

func (*ListPrivateNetworksRequestOrderBy) UnmarshalJSON

func (enum *ListPrivateNetworksRequestOrderBy) UnmarshalJSON(data []byte) error

type ListRoutesRequest

type ListRoutesRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// OrderBy: sort order of routes in the response.
	// Default value: created_at_asc
	OrderBy ListRoutesRequestOrderBy `json:"-"`

	// PageSize: the number of route objects to return.
	PageSize *uint32 `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// FrontendID: frontend ID to filter for, only Routes from this Frontend will be returned.
	FrontendID *string `json:"-"`
}

ListRoutesRequest: list routes request.

type ListRoutesRequestOrderBy

type ListRoutesRequestOrderBy string

func (ListRoutesRequestOrderBy) MarshalJSON

func (enum ListRoutesRequestOrderBy) MarshalJSON() ([]byte, error)

func (ListRoutesRequestOrderBy) String

func (enum ListRoutesRequestOrderBy) String() string

func (*ListRoutesRequestOrderBy) UnmarshalJSON

func (enum *ListRoutesRequestOrderBy) UnmarshalJSON(data []byte) error

type ListRoutesResponse

type ListRoutesResponse struct {
	// Routes: list of route objects.
	Routes []*Route `json:"routes"`

	// TotalCount: the total number of route objects.
	TotalCount uint32 `json:"total_count"`
}

ListRoutesResponse: list routes response.

func (*ListRoutesResponse) UnsafeAppend

func (r *ListRoutesResponse) UnsafeAppend(res interface{}) (uint32, error)

UnsafeAppend should not be used Internal usage only

func (*ListRoutesResponse) UnsafeGetTotalCount

func (r *ListRoutesResponse) UnsafeGetTotalCount() uint32

UnsafeGetTotalCount should not be used Internal usage only

type ListSubscriberRequest

type ListSubscriberRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// OrderBy: sort order of subscribers in the response.
	// Default value: created_at_asc
	OrderBy ListSubscriberRequestOrderBy `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: the number of items to return.
	PageSize *uint32 `json:"-"`

	// Name: subscriber name to search for.
	Name *string `json:"-"`

	// OrganizationID: filter subscribers by Organization ID.
	OrganizationID *string `json:"-"`

	// ProjectID: filter subscribers by Project ID.
	ProjectID *string `json:"-"`
}

ListSubscriberRequest: list subscriber request.

type ListSubscriberRequestOrderBy

type ListSubscriberRequestOrderBy string

func (ListSubscriberRequestOrderBy) MarshalJSON

func (enum ListSubscriberRequestOrderBy) MarshalJSON() ([]byte, error)

func (ListSubscriberRequestOrderBy) String

func (enum ListSubscriberRequestOrderBy) String() string

func (*ListSubscriberRequestOrderBy) UnmarshalJSON

func (enum *ListSubscriberRequestOrderBy) UnmarshalJSON(data []byte) error

type ListSubscriberResponse

type ListSubscriberResponse struct {
	// Subscribers: list of subscriber objects.
	Subscribers []*Subscriber `json:"subscribers"`

	// TotalCount: the total number of objects.
	TotalCount uint32 `json:"total_count"`
}

ListSubscriberResponse: list subscriber response.

func (*ListSubscriberResponse) UnsafeAppend

func (r *ListSubscriberResponse) UnsafeAppend(res interface{}) (uint32, error)

UnsafeAppend should not be used Internal usage only

func (*ListSubscriberResponse) UnsafeGetTotalCount

func (r *ListSubscriberResponse) UnsafeGetTotalCount() uint32

UnsafeGetTotalCount should not be used Internal usage only

type MigrateLBRequest

type MigrateLBRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// Type: load Balancer type to migrate to (use the List all Load Balancer offer types endpoint to get a list of available offer types).
	Type string `json:"type"`
}

MigrateLBRequest: migrate lb request.

type OnMarkedDownAction

type OnMarkedDownAction string

func (OnMarkedDownAction) MarshalJSON

func (enum OnMarkedDownAction) MarshalJSON() ([]byte, error)

func (OnMarkedDownAction) String

func (enum OnMarkedDownAction) String() string

func (*OnMarkedDownAction) UnmarshalJSON

func (enum *OnMarkedDownAction) UnmarshalJSON(data []byte) error

type PrivateNetwork

type PrivateNetwork struct {
	// LB: load Balancer object which is attached to the Private Network.
	LB *LB `json:"lb"`

	// IpamIDs: iPAM IDs of the booked IP addresses.
	IpamIDs []string `json:"ipam_ids"`

	// Deprecated: StaticConfig: object containing an array of a local IP address for the Load Balancer on this Private Network.
	// Precisely one of StaticConfig, DHCPConfig, IpamConfig must be set.
	StaticConfig *PrivateNetworkStaticConfig `json:"static_config,omitempty"`

	// Deprecated: DHCPConfig: object containing DHCP-assigned IP addresses.
	// Precisely one of StaticConfig, DHCPConfig, IpamConfig must be set.
	DHCPConfig *PrivateNetworkDHCPConfig `json:"dhcp_config,omitempty"`

	// Deprecated: IpamConfig: for internal use only.
	// Precisely one of StaticConfig, DHCPConfig, IpamConfig must be set.
	IpamConfig *PrivateNetworkIpamConfig `json:"ipam_config,omitempty"`

	// PrivateNetworkID: private Network ID.
	PrivateNetworkID string `json:"private_network_id"`

	// Status: status of Private Network connection.
	// Default value: unknown
	Status PrivateNetworkStatus `json:"status"`

	// CreatedAt: date on which the Private Network was created.
	CreatedAt *time.Time `json:"created_at"`

	// UpdatedAt: date on which the PN was last updated.
	UpdatedAt *time.Time `json:"updated_at"`
}

PrivateNetwork: private network.

type PrivateNetworkDHCPConfig

type PrivateNetworkDHCPConfig struct {
	// Deprecated
	IPID *string `json:"ip_id,omitempty"`
}

PrivateNetworkDHCPConfig: private network dhcp config.

type PrivateNetworkIpamConfig

type PrivateNetworkIpamConfig struct {
}

PrivateNetworkIpamConfig: private network ipam config.

type PrivateNetworkStaticConfig

type PrivateNetworkStaticConfig struct {
	// Deprecated: IPAddress: array of a local IP address for the Load Balancer on this Private Network.
	IPAddress *[]string `json:"ip_address,omitempty"`
}

PrivateNetworkStaticConfig: private network static config.

type PrivateNetworkStatus

type PrivateNetworkStatus string

func (PrivateNetworkStatus) MarshalJSON

func (enum PrivateNetworkStatus) MarshalJSON() ([]byte, error)

func (PrivateNetworkStatus) String

func (enum PrivateNetworkStatus) String() string

func (*PrivateNetworkStatus) UnmarshalJSON

func (enum *PrivateNetworkStatus) UnmarshalJSON(data []byte) error

type Protocol

type Protocol string

func (Protocol) MarshalJSON

func (enum Protocol) MarshalJSON() ([]byte, error)

func (Protocol) String

func (enum Protocol) String() string

func (*Protocol) UnmarshalJSON

func (enum *Protocol) UnmarshalJSON(data []byte) error

type ProxyProtocol

type ProxyProtocol string

func (ProxyProtocol) MarshalJSON

func (enum ProxyProtocol) MarshalJSON() ([]byte, error)

func (ProxyProtocol) String

func (enum ProxyProtocol) String() string

func (*ProxyProtocol) UnmarshalJSON

func (enum *ProxyProtocol) UnmarshalJSON(data []byte) error

type ReleaseIPRequest

type ReleaseIPRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// IPID: IP address ID.
	IPID string `json:"-"`
}

ReleaseIPRequest: release ip request.

type RemoveBackendServersRequest

type RemoveBackendServersRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// BackendID: backend ID.
	BackendID string `json:"-"`

	// ServerIP: list of IP addresses to remove from backend servers.
	ServerIP []string `json:"server_ip"`
}

RemoveBackendServersRequest: remove backend servers request.

type Route

type Route struct {
	// ID: route ID.
	ID string `json:"id"`

	// FrontendID: ID of the source frontend.
	FrontendID string `json:"frontend_id"`

	// BackendID: ID of the target backend.
	BackendID string `json:"backend_id"`

	// Match: 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.
	Match *RouteMatch `json:"match"`

	// CreatedAt: date on which the route was created.
	CreatedAt *time.Time `json:"created_at"`

	// UpdatedAt: date on which the route was last updated.
	UpdatedAt *time.Time `json:"updated_at"`
}

Route: route.

type RouteMatch

type RouteMatch struct {
	// Sni: 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.
	// Precisely one of Sni, HostHeader must be set.
	Sni *string `json:"sni,omitempty"`

	// HostHeader: value to match in the HTTP Host request header from an incoming connection. This field should be set for routes on HTTP Load Balancers.
	// Precisely one of Sni, HostHeader must be set.
	HostHeader *string `json:"host_header,omitempty"`
}

RouteMatch: route match.

type SSLCompatibilityLevel

type SSLCompatibilityLevel string

func (SSLCompatibilityLevel) MarshalJSON

func (enum SSLCompatibilityLevel) MarshalJSON() ([]byte, error)

func (SSLCompatibilityLevel) String

func (enum SSLCompatibilityLevel) String() string

func (*SSLCompatibilityLevel) UnmarshalJSON

func (enum *SSLCompatibilityLevel) UnmarshalJSON(data []byte) error

type SetACLsResponse

type SetACLsResponse struct {
	// ACLs: list of ACL objects.
	ACLs []*ACL `json:"acls"`

	// TotalCount: the total number of ACL objects.
	TotalCount uint32 `json:"total_count"`
}

SetACLsResponse: set ac ls response.

func (*SetACLsResponse) UnsafeAppend

func (r *SetACLsResponse) UnsafeAppend(res interface{}) (uint32, error)

UnsafeAppend should not be used Internal usage only

func (*SetACLsResponse) UnsafeGetTotalCount

func (r *SetACLsResponse) UnsafeGetTotalCount() uint32

UnsafeGetTotalCount should not be used Internal usage only

type SetBackendServersRequest

type SetBackendServersRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// BackendID: backend ID.
	BackendID string `json:"-"`

	// ServerIP: list of IP addresses for backend servers. Any other existing backend servers will be removed.
	ServerIP []string `json:"server_ip"`
}

SetBackendServersRequest: set backend servers request.

type StickySessionsType

type StickySessionsType string

func (StickySessionsType) MarshalJSON

func (enum StickySessionsType) MarshalJSON() ([]byte, error)

func (StickySessionsType) String

func (enum StickySessionsType) String() string

func (*StickySessionsType) UnmarshalJSON

func (enum *StickySessionsType) UnmarshalJSON(data []byte) error

type SubscribeToLBRequest

type SubscribeToLBRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// SubscriberID: subscriber ID.
	SubscriberID string `json:"subscriber_id"`
}

SubscribeToLBRequest: subscribe to lb request.

type Subscriber

type Subscriber struct {
	// ID: subscriber ID.
	ID string `json:"id"`

	// Name: subscriber name.
	Name string `json:"name"`

	// EmailConfig: email address of subscriber.
	// Precisely one of EmailConfig, WebhookConfig must be set.
	EmailConfig *SubscriberEmailConfig `json:"email_config,omitempty"`

	// WebhookConfig: webhook URI of subscriber.
	// Precisely one of EmailConfig, WebhookConfig must be set.
	WebhookConfig *SubscriberWebhookConfig `json:"webhook_config,omitempty"`
}

Subscriber: Subscriber.

type SubscriberEmailConfig

type SubscriberEmailConfig struct {
	// Email: email address to send alerts to.
	Email string `json:"email"`
}

SubscriberEmailConfig: subscriber email config.

type SubscriberWebhookConfig

type SubscriberWebhookConfig struct {
	// URI: URI to receive POST requests.
	URI string `json:"uri"`
}

SubscriberWebhookConfig: Webhook alert of subscriber.

type UnsubscribeFromLBRequest

type UnsubscribeFromLBRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`
}

UnsubscribeFromLBRequest: unsubscribe from lb request.

type UpdateACLRequest

type UpdateACLRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// ACLID: ACL ID.
	ACLID string `json:"-"`

	// Name: ACL name.
	Name string `json:"name"`

	// Action: action to take when incoming traffic matches an ACL filter.
	Action *ACLAction `json:"action"`

	// Match: ACL match filter object. One of `ip_subnet` or `http_filter` & `http_filter_value` are required.
	Match *ACLMatch `json:"match,omitempty"`

	// Index: priority of this ACL (ACLs are applied in ascending order, 0 is the first ACL executed).
	Index int32 `json:"index"`

	// Description: ACL description.
	Description *string `json:"description,omitempty"`
}

UpdateACLRequest: update acl request.

type UpdateBackendRequest

type UpdateBackendRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// BackendID: backend ID.
	BackendID string `json:"-"`

	// Name: backend name.
	Name string `json:"name"`

	// ForwardProtocol: protocol to be used by the backend when forwarding traffic to backend servers.
	// Default value: tcp
	ForwardProtocol Protocol `json:"forward_protocol"`

	// ForwardPort: port to be used by the backend when forwarding traffic to backend servers.
	ForwardPort int32 `json:"forward_port"`

	// ForwardPortAlgorithm: load balancing algorithm to be used when determining which backend server to forward new traffic to.
	// Default value: roundrobin
	ForwardPortAlgorithm ForwardPortAlgorithm `json:"forward_port_algorithm"`

	// StickySessions: 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.
	// Default value: none
	StickySessions StickySessionsType `json:"sticky_sessions"`

	// StickySessionsCookieName: cookie name for cookie-based sticky sessions.
	StickySessionsCookieName string `json:"sticky_sessions_cookie_name"`

	// Deprecated: SendProxyV2: deprecated in favor of proxy_protocol field.
	SendProxyV2 *bool `json:"send_proxy_v2,omitempty"`

	// TimeoutServer: maximum allowed time for a backend server to process a request.
	TimeoutServer *time.Duration `json:"timeout_server,omitempty"`

	// TimeoutConnect: maximum allowed time for establishing a connection to a backend server.
	TimeoutConnect *time.Duration `json:"timeout_connect,omitempty"`

	// TimeoutTunnel: maximum allowed tunnel inactivity time after Websocket is established (takes precedence over client and server timeout).
	TimeoutTunnel *time.Duration `json:"timeout_tunnel,omitempty"`

	// OnMarkedDownAction: action to take when a backend server is marked as down.
	// Default value: on_marked_down_action_none
	OnMarkedDownAction OnMarkedDownAction `json:"on_marked_down_action"`

	// ProxyProtocol: 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.
	// Default value: proxy_protocol_unknown
	ProxyProtocol ProxyProtocol `json:"proxy_protocol"`

	// FailoverHost: scaleway S3 bucket website to be served as failover if all backend servers are down, e.g. failover-website.s3-website.fr-par.scw.cloud.
	FailoverHost *string `json:"failover_host,omitempty"`

	// SslBridging: defines whether to enable SSL bridging between the Load Balancer and backend servers.
	SslBridging *bool `json:"ssl_bridging,omitempty"`

	// IgnoreSslServerVerify: defines whether the server certificate verification should be ignored.
	IgnoreSslServerVerify *bool `json:"ignore_ssl_server_verify,omitempty"`

	// RedispatchAttemptCount: whether to use another backend server on each attempt.
	RedispatchAttemptCount *int32 `json:"redispatch_attempt_count,omitempty"`

	// MaxRetries: number of retries when a backend server connection failed.
	MaxRetries *int32 `json:"max_retries,omitempty"`

	// MaxConnections: maximum number of connections allowed per backend server.
	MaxConnections *int32 `json:"max_connections,omitempty"`

	// TimeoutQueue: maximum time for a request to be left pending in queue when `max_connections` is reached.
	TimeoutQueue *scw.Duration `json:"timeout_queue,omitempty"`
}

UpdateBackendRequest: update backend request.

func (UpdateBackendRequest) MarshalJSON

func (m UpdateBackendRequest) MarshalJSON() ([]byte, error)

func (*UpdateBackendRequest) UnmarshalJSON

func (m *UpdateBackendRequest) UnmarshalJSON(b []byte) error

type UpdateCertificateRequest

type UpdateCertificateRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// CertificateID: certificate ID.
	CertificateID string `json:"-"`

	// Name: certificate name.
	Name string `json:"name"`
}

UpdateCertificateRequest: update certificate request.

type UpdateFrontendRequest

type UpdateFrontendRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// FrontendID: frontend ID.
	FrontendID string `json:"-"`

	// Name: frontend name.
	Name string `json:"name"`

	// InboundPort: port the frontend should listen on.
	InboundPort int32 `json:"inbound_port"`

	// BackendID: backend ID (ID of the backend the frontend should pass traffic to).
	BackendID string `json:"backend_id"`

	// TimeoutClient: maximum allowed inactivity time on the client side.
	TimeoutClient *time.Duration `json:"timeout_client,omitempty"`

	// Deprecated: CertificateID: certificate ID, deprecated in favor of certificate_ids array.
	CertificateID *string `json:"certificate_id,omitempty"`

	// CertificateIDs: list of SSL/TLS certificate IDs to bind to the frontend.
	CertificateIDs *[]string `json:"certificate_ids,omitempty"`

	// EnableHTTP3: defines whether to enable HTTP/3 protocol on the frontend.
	EnableHTTP3 bool `json:"enable_http3"`
}

UpdateFrontendRequest: update frontend request.

func (UpdateFrontendRequest) MarshalJSON

func (m UpdateFrontendRequest) MarshalJSON() ([]byte, error)

func (*UpdateFrontendRequest) UnmarshalJSON

func (m *UpdateFrontendRequest) UnmarshalJSON(b []byte) error

type UpdateHealthCheckRequest

type UpdateHealthCheckRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// BackendID: backend ID.
	BackendID string `json:"-"`

	// Port: port to use for the backend server health check.
	Port int32 `json:"port"`

	// CheckDelay: time to wait between two consecutive health checks.
	CheckDelay *time.Duration `json:"check_delay,omitempty"`

	// CheckTimeout: maximum time a backend server has to reply to the health check.
	CheckTimeout *time.Duration `json:"check_timeout,omitempty"`

	// CheckMaxRetries: number of consecutive unsuccessful health checks after which the server will be considered dead.
	CheckMaxRetries int32 `json:"check_max_retries"`

	// CheckSendProxy: defines whether proxy protocol should be activated for the health check.
	CheckSendProxy bool `json:"check_send_proxy"`

	// TCPConfig: object to configure a basic TCP health check.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	TCPConfig *HealthCheckTCPConfig `json:"tcp_config,omitempty"`

	// MysqlConfig: object to configure a MySQL health check. The check requires MySQL >=3.22, for older versions, use a TCP health check.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	MysqlConfig *HealthCheckMysqlConfig `json:"mysql_config,omitempty"`

	// PgsqlConfig: object to configure a PostgreSQL health check.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	PgsqlConfig *HealthCheckPgsqlConfig `json:"pgsql_config,omitempty"`

	// LdapConfig: object to configure an LDAP health check. The response is analyzed to find the LDAPv3 response message.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	LdapConfig *HealthCheckLdapConfig `json:"ldap_config,omitempty"`

	// RedisConfig: object to configure a Redis health check. The response is analyzed to find the +PONG response message.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	RedisConfig *HealthCheckRedisConfig `json:"redis_config,omitempty"`

	// HTTPConfig: object to configure an HTTP health check.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	HTTPConfig *HealthCheckHTTPConfig `json:"http_config,omitempty"`

	// HTTPSConfig: object to configure an HTTPS health check.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	HTTPSConfig *HealthCheckHTTPSConfig `json:"https_config,omitempty"`

	// TransientCheckDelay: time to wait between two consecutive health checks when a backend server is in a transient state (going UP or DOWN).
	TransientCheckDelay *scw.Duration `json:"transient_check_delay,omitempty"`
}

UpdateHealthCheckRequest: update health check request.

func (UpdateHealthCheckRequest) MarshalJSON

func (m UpdateHealthCheckRequest) MarshalJSON() ([]byte, error)

func (*UpdateHealthCheckRequest) UnmarshalJSON

func (m *UpdateHealthCheckRequest) UnmarshalJSON(b []byte) error

type UpdateIPRequest

type UpdateIPRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// IPID: IP address ID.
	IPID string `json:"-"`

	// Reverse: reverse DNS (domain name) for the IP address.
	Reverse *string `json:"reverse,omitempty"`

	// LBID: ID of the server on which to attach the flexible IP.
	LBID *string `json:"lb_id,omitempty"`
}

UpdateIPRequest: update ip request.

type UpdateLBRequest

type UpdateLBRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// Name: load Balancer name.
	Name string `json:"name"`

	// Description: load Balancer description.
	Description string `json:"description"`

	// Tags: list of tags for the Load Balancer.
	Tags []string `json:"tags"`

	// SslCompatibilityLevel: 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. Modern is suitable for services with clients that support TLS 1.3 and don't need backward compatibility. Old is compatible with a small number of very old clients and should be used only as a last resort.
	// Default value: ssl_compatibility_level_unknown
	SslCompatibilityLevel SSLCompatibilityLevel `json:"ssl_compatibility_level"`
}

UpdateLBRequest: update lb request.

type UpdateRouteRequest

type UpdateRouteRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// RouteID: route ID.
	RouteID string `json:"-"`

	// BackendID: ID of the target backend for the route.
	BackendID string `json:"backend_id"`

	// Match: 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.
	Match *RouteMatch `json:"match,omitempty"`
}

UpdateRouteRequest: update route request.

type UpdateSubscriberRequest

type UpdateSubscriberRequest struct {
	// Region: region to target. If none is passed will use default region from the config.
	Region scw.Region `json:"-"`

	// SubscriberID: subscriber ID.
	SubscriberID string `json:"-"`

	// Name: subscriber name.
	Name string `json:"name"`

	// EmailConfig: email address configuration.
	// Precisely one of EmailConfig, WebhookConfig must be set.
	EmailConfig *SubscriberEmailConfig `json:"email_config,omitempty"`

	// WebhookConfig: webhook URI configuration.
	// Precisely one of EmailConfig, WebhookConfig must be set.
	WebhookConfig *SubscriberWebhookConfig `json:"webhook_config,omitempty"`
}

UpdateSubscriberRequest: update subscriber request.

type WaitForLBRequest

type WaitForLBRequest struct {
	LBID          string
	Region        scw.Region
	Timeout       *time.Duration
	RetryInterval *time.Duration
}

WaitForLBRequest is used by WaitForLb method.

type ZonedAPI

type ZonedAPI struct {
	// contains filtered or unexported fields
}

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

func NewZonedAPI

func NewZonedAPI(client *scw.Client) *ZonedAPI

NewZonedAPI returns a ZonedAPI object from a Scaleway client.

func (*ZonedAPI) AddBackendServers

func (s *ZonedAPI) AddBackendServers(req *ZonedAPIAddBackendServersRequest, opts ...scw.RequestOption) (*Backend, error)

AddBackendServers: 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.

func (*ZonedAPI) AttachPrivateNetwork

func (s *ZonedAPI) AttachPrivateNetwork(req *ZonedAPIAttachPrivateNetworkRequest, opts ...scw.RequestOption) (*PrivateNetwork, error)

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

func (*ZonedAPI) CreateACL

func (s *ZonedAPI) CreateACL(req *ZonedAPICreateACLRequest, opts ...scw.RequestOption) (*ACL, error)

CreateACL: 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).

func (*ZonedAPI) CreateBackend

func (s *ZonedAPI) CreateBackend(req *ZonedAPICreateBackendRequest, opts ...scw.RequestOption) (*Backend, error)

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

func (*ZonedAPI) CreateCertificate

func (s *ZonedAPI) CreateCertificate(req *ZonedAPICreateCertificateRequest, opts ...scw.RequestOption) (*Certificate, error)

CreateCertificate: 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.

func (*ZonedAPI) CreateFrontend

func (s *ZonedAPI) CreateFrontend(req *ZonedAPICreateFrontendRequest, opts ...scw.RequestOption) (*Frontend, error)

CreateFrontend: 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.

func (*ZonedAPI) CreateIP

func (s *ZonedAPI) CreateIP(req *ZonedAPICreateIPRequest, opts ...scw.RequestOption) (*IP, error)

CreateIP: 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.

func (*ZonedAPI) CreateLB

func (s *ZonedAPI) CreateLB(req *ZonedAPICreateLBRequest, opts ...scw.RequestOption) (*LB, error)

CreateLB: 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.

func (*ZonedAPI) CreateRoute

func (s *ZonedAPI) CreateRoute(req *ZonedAPICreateRouteRequest, opts ...scw.RequestOption) (*Route, error)

CreateRoute: 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).

func (*ZonedAPI) CreateSubscriber

func (s *ZonedAPI) CreateSubscriber(req *ZonedAPICreateSubscriberRequest, opts ...scw.RequestOption) (*Subscriber, error)

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

func (*ZonedAPI) DeleteACL

func (s *ZonedAPI) DeleteACL(req *ZonedAPIDeleteACLRequest, opts ...scw.RequestOption) error

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

func (*ZonedAPI) DeleteBackend

func (s *ZonedAPI) DeleteBackend(req *ZonedAPIDeleteBackendRequest, opts ...scw.RequestOption) error

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

func (*ZonedAPI) DeleteCertificate

func (s *ZonedAPI) DeleteCertificate(req *ZonedAPIDeleteCertificateRequest, opts ...scw.RequestOption) error

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

func (*ZonedAPI) DeleteFrontend

func (s *ZonedAPI) DeleteFrontend(req *ZonedAPIDeleteFrontendRequest, opts ...scw.RequestOption) error

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

func (*ZonedAPI) DeleteLB

func (s *ZonedAPI) DeleteLB(req *ZonedAPIDeleteLBRequest, opts ...scw.RequestOption) error

DeleteLB: 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.

func (*ZonedAPI) DeleteRoute

func (s *ZonedAPI) DeleteRoute(req *ZonedAPIDeleteRouteRequest, opts ...scw.RequestOption) error

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

func (*ZonedAPI) DeleteSubscriber

func (s *ZonedAPI) DeleteSubscriber(req *ZonedAPIDeleteSubscriberRequest, opts ...scw.RequestOption) error

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

func (*ZonedAPI) DetachPrivateNetwork

func (s *ZonedAPI) DetachPrivateNetwork(req *ZonedAPIDetachPrivateNetworkRequest, opts ...scw.RequestOption) error

DetachPrivateNetwork: Detach a specified Load Balancer from a specified Private Network.

func (*ZonedAPI) GetACL

func (s *ZonedAPI) GetACL(req *ZonedAPIGetACLRequest, opts ...scw.RequestOption) (*ACL, error)

GetACL: 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.

func (*ZonedAPI) GetBackend

func (s *ZonedAPI) GetBackend(req *ZonedAPIGetBackendRequest, opts ...scw.RequestOption) (*Backend, error)

GetBackend: 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.

func (*ZonedAPI) GetCertificate

func (s *ZonedAPI) GetCertificate(req *ZonedAPIGetCertificateRequest, opts ...scw.RequestOption) (*Certificate, error)

GetCertificate: 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.

func (*ZonedAPI) GetFrontend

func (s *ZonedAPI) GetFrontend(req *ZonedAPIGetFrontendRequest, opts ...scw.RequestOption) (*Frontend, error)

GetFrontend: 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.

func (*ZonedAPI) GetIP

func (s *ZonedAPI) GetIP(req *ZonedAPIGetIPRequest, opts ...scw.RequestOption) (*IP, error)

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

func (*ZonedAPI) GetLB

func (s *ZonedAPI) GetLB(req *ZonedAPIGetLBRequest, opts ...scw.RequestOption) (*LB, error)

GetLB: 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.

func (*ZonedAPI) GetLBStats deprecated

func (s *ZonedAPI) GetLBStats(req *ZonedAPIGetLBStatsRequest, opts ...scw.RequestOption) (*LBStats, error)

Deprecated: GetLBStats: Get usage statistics of a given Load Balancer.

func (*ZonedAPI) GetRoute

func (s *ZonedAPI) GetRoute(req *ZonedAPIGetRouteRequest, opts ...scw.RequestOption) (*Route, error)

GetRoute: 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.

func (*ZonedAPI) GetSubscriber

func (s *ZonedAPI) GetSubscriber(req *ZonedAPIGetSubscriberRequest, opts ...scw.RequestOption) (*Subscriber, error)

GetSubscriber: 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.

func (*ZonedAPI) ListACLs

func (s *ZonedAPI) ListACLs(req *ZonedAPIListACLsRequest, opts ...scw.RequestOption) (*ListACLResponse, error)

ListACLs: 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.

func (*ZonedAPI) ListBackendStats

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

func (*ZonedAPI) ListBackends

ListBackends: 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.

func (*ZonedAPI) ListCertificates

ListCertificates: 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.

func (*ZonedAPI) ListFrontends

ListFrontends: 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.

func (*ZonedAPI) ListIPs

func (s *ZonedAPI) ListIPs(req *ZonedAPIListIPsRequest, opts ...scw.RequestOption) (*ListIPsResponse, error)

ListIPs: 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.

func (*ZonedAPI) ListLBPrivateNetworks

ListLBPrivateNetworks: 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.

func (*ZonedAPI) ListLBTypes

ListLBTypes: 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.

func (*ZonedAPI) ListLBs

func (s *ZonedAPI) ListLBs(req *ZonedAPIListLBsRequest, opts ...scw.RequestOption) (*ListLBsResponse, error)

ListLBs: 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.

func (*ZonedAPI) ListRoutes

ListRoutes: 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).

func (*ZonedAPI) ListSubscriber

ListSubscriber: 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.

func (*ZonedAPI) MigrateLB

func (s *ZonedAPI) MigrateLB(req *ZonedAPIMigrateLBRequest, opts ...scw.RequestOption) (*LB, error)

MigrateLB: 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.

func (*ZonedAPI) ReleaseIP

func (s *ZonedAPI) ReleaseIP(req *ZonedAPIReleaseIPRequest, opts ...scw.RequestOption) error

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

func (*ZonedAPI) RemoveBackendServers

func (s *ZonedAPI) RemoveBackendServers(req *ZonedAPIRemoveBackendServersRequest, opts ...scw.RequestOption) (*Backend, error)

RemoveBackendServers: 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.

func (*ZonedAPI) SetACLs

func (s *ZonedAPI) SetACLs(req *ZonedAPISetACLsRequest, opts ...scw.RequestOption) (*SetACLsResponse, error)

SetACLs: 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.

func (*ZonedAPI) SetBackendServers

func (s *ZonedAPI) SetBackendServers(req *ZonedAPISetBackendServersRequest, opts ...scw.RequestOption) (*Backend, error)

SetBackendServers: 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.

func (*ZonedAPI) SubscribeToLB

func (s *ZonedAPI) SubscribeToLB(req *ZonedAPISubscribeToLBRequest, opts ...scw.RequestOption) (*LB, error)

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

func (*ZonedAPI) UnsubscribeFromLB

func (s *ZonedAPI) UnsubscribeFromLB(req *ZonedAPIUnsubscribeFromLBRequest, opts ...scw.RequestOption) (*LB, error)

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

func (*ZonedAPI) UpdateACL

func (s *ZonedAPI) UpdateACL(req *ZonedAPIUpdateACLRequest, opts ...scw.RequestOption) (*ACL, error)

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

func (*ZonedAPI) UpdateBackend

func (s *ZonedAPI) UpdateBackend(req *ZonedAPIUpdateBackendRequest, opts ...scw.RequestOption) (*Backend, error)

UpdateBackend: 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.

func (*ZonedAPI) UpdateCertificate

func (s *ZonedAPI) UpdateCertificate(req *ZonedAPIUpdateCertificateRequest, opts ...scw.RequestOption) (*Certificate, error)

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

func (*ZonedAPI) UpdateFrontend

func (s *ZonedAPI) UpdateFrontend(req *ZonedAPIUpdateFrontendRequest, opts ...scw.RequestOption) (*Frontend, error)

UpdateFrontend: 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.

func (*ZonedAPI) UpdateHealthCheck

func (s *ZonedAPI) UpdateHealthCheck(req *ZonedAPIUpdateHealthCheckRequest, opts ...scw.RequestOption) (*HealthCheck, error)

UpdateHealthCheck: 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.

func (*ZonedAPI) UpdateIP

func (s *ZonedAPI) UpdateIP(req *ZonedAPIUpdateIPRequest, opts ...scw.RequestOption) (*IP, error)

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

func (*ZonedAPI) UpdateLB

func (s *ZonedAPI) UpdateLB(req *ZonedAPIUpdateLBRequest, opts ...scw.RequestOption) (*LB, error)

UpdateLB: 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.

func (*ZonedAPI) UpdateRoute

func (s *ZonedAPI) UpdateRoute(req *ZonedAPIUpdateRouteRequest, opts ...scw.RequestOption) (*Route, error)

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

func (*ZonedAPI) UpdateSubscriber

func (s *ZonedAPI) UpdateSubscriber(req *ZonedAPIUpdateSubscriberRequest, opts ...scw.RequestOption) (*Subscriber, error)

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

func (*ZonedAPI) WaitForLBCertificate

func (s *ZonedAPI) WaitForLBCertificate(req *ZonedAPIWaitForLBCertificateRequest, opts ...scw.RequestOption) (*Certificate, error)

WaitForLBCertificate waits for the certificate to be in a "terminal state"

func (*ZonedAPI) WaitForLBPN

func (s *ZonedAPI) WaitForLBPN(req *ZonedAPIWaitForLBPNRequest, opts ...scw.RequestOption) ([]*PrivateNetwork, error)

WaitForLBPN waits for the private_network attached status on a load balancer to be in a "terminal state" before returning. This function can be used to wait for an attached private_network to be ready for example.

func (*ZonedAPI) WaitForLb

func (s *ZonedAPI) WaitForLb(req *ZonedAPIWaitForLBRequest, opts ...scw.RequestOption) (*LB, error)

WaitForLb waits for the lb to be in a "terminal state" before returning. This function can be used to wait for a lb to be ready for example.

func (*ZonedAPI) WaitForLbInstances

func (s *ZonedAPI) WaitForLbInstances(req *ZonedAPIWaitForLBInstancesRequest, opts ...scw.RequestOption) (*LB, error)

WaitForLbInstances waits for the lb to be in a "terminal state" and the attached instances before returning.

func (*ZonedAPI) Zones

func (s *ZonedAPI) Zones() []scw.Zone

type ZonedAPIAddBackendServersRequest

type ZonedAPIAddBackendServersRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// BackendID: backend ID.
	BackendID string `json:"-"`

	// ServerIP: list of IP addresses to add to backend servers.
	ServerIP []string `json:"server_ip"`
}

ZonedAPIAddBackendServersRequest: zoned api add backend servers request.

type ZonedAPIAttachPrivateNetworkRequest

type ZonedAPIAttachPrivateNetworkRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// PrivateNetworkID: private Network ID.
	PrivateNetworkID string `json:"-"`

	// Deprecated: StaticConfig: object containing an array of a local IP address for the Load Balancer on this Private Network.
	// Precisely one of StaticConfig, DHCPConfig, IpamConfig must be set.
	StaticConfig *PrivateNetworkStaticConfig `json:"static_config,omitempty"`

	// Deprecated: DHCPConfig: defines whether to let DHCP assign IP addresses.
	// Precisely one of StaticConfig, DHCPConfig, IpamConfig must be set.
	DHCPConfig *PrivateNetworkDHCPConfig `json:"dhcp_config,omitempty"`

	// Deprecated: IpamConfig: for internal use only.
	// Precisely one of StaticConfig, DHCPConfig, IpamConfig must be set.
	IpamConfig *PrivateNetworkIpamConfig `json:"ipam_config,omitempty"`
}

ZonedAPIAttachPrivateNetworkRequest: zoned api attach private network request.

type ZonedAPICreateACLRequest

type ZonedAPICreateACLRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// FrontendID: frontend ID to attach the ACL to.
	FrontendID string `json:"-"`

	// Name: ACL name.
	Name string `json:"name"`

	// Action: action to take when incoming traffic matches an ACL filter.
	Action *ACLAction `json:"action"`

	// Match: ACL match filter object. One of `ip_subnet` or `http_filter` & `http_filter_value` are required.
	Match *ACLMatch `json:"match,omitempty"`

	// Index: priority of this ACL (ACLs are applied in ascending order, 0 is the first ACL executed).
	Index int32 `json:"index"`

	// Description: ACL description.
	Description string `json:"description"`
}

ZonedAPICreateACLRequest: Add an ACL to a Load Balancer frontend.

type ZonedAPICreateBackendRequest

type ZonedAPICreateBackendRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// Name: name for the backend.
	Name string `json:"name"`

	// ForwardProtocol: protocol to be used by the backend when forwarding traffic to backend servers.
	// Default value: tcp
	ForwardProtocol Protocol `json:"forward_protocol"`

	// ForwardPort: port to be used by the backend when forwarding traffic to backend servers.
	ForwardPort int32 `json:"forward_port"`

	// ForwardPortAlgorithm: load balancing algorithm to be used when determining which backend server to forward new traffic to.
	// Default value: roundrobin
	ForwardPortAlgorithm ForwardPortAlgorithm `json:"forward_port_algorithm"`

	// StickySessions: 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.
	// Default value: none
	StickySessions StickySessionsType `json:"sticky_sessions"`

	// StickySessionsCookieName: cookie name for cookie-based sticky sessions.
	StickySessionsCookieName string `json:"sticky_sessions_cookie_name"`

	// HealthCheck: object defining the health check to be carried out by the backend when checking the status and health of backend servers.
	HealthCheck *HealthCheck `json:"health_check"`

	// ServerIP: list of backend server IP addresses (IPv4 or IPv6) the backend should forward traffic to.
	ServerIP []string `json:"server_ip"`

	// Deprecated: SendProxyV2: deprecated in favor of proxy_protocol field.
	SendProxyV2 *bool `json:"send_proxy_v2,omitempty"`

	// TimeoutServer: maximum allowed time for a backend server to process a request.
	TimeoutServer *time.Duration `json:"timeout_server,omitempty"`

	// TimeoutConnect: maximum allowed time for establishing a connection to a backend server.
	TimeoutConnect *time.Duration `json:"timeout_connect,omitempty"`

	// TimeoutTunnel: maximum allowed tunnel inactivity time after Websocket is established (takes precedence over client and server timeout).
	TimeoutTunnel *time.Duration `json:"timeout_tunnel,omitempty"`

	// OnMarkedDownAction: action to take when a backend server is marked as down.
	// Default value: on_marked_down_action_none
	OnMarkedDownAction OnMarkedDownAction `json:"on_marked_down_action"`

	// ProxyProtocol: 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.
	// Default value: proxy_protocol_unknown
	ProxyProtocol ProxyProtocol `json:"proxy_protocol"`

	// FailoverHost: scaleway S3 bucket website to be served as failover if all backend servers are down, e.g. failover-website.s3-website.fr-par.scw.cloud.
	FailoverHost *string `json:"failover_host,omitempty"`

	// SslBridging: defines whether to enable SSL bridging between the Load Balancer and backend servers.
	SslBridging *bool `json:"ssl_bridging,omitempty"`

	// IgnoreSslServerVerify: defines whether the server certificate verification should be ignored.
	IgnoreSslServerVerify *bool `json:"ignore_ssl_server_verify,omitempty"`

	// RedispatchAttemptCount: whether to use another backend server on each attempt.
	RedispatchAttemptCount *int32 `json:"redispatch_attempt_count,omitempty"`

	// MaxRetries: number of retries when a backend server connection failed.
	MaxRetries *int32 `json:"max_retries,omitempty"`

	// MaxConnections: maximum number of connections allowed per backend server.
	MaxConnections *int32 `json:"max_connections,omitempty"`

	// TimeoutQueue: maximum time for a request to be left pending in queue when `max_connections` is reached.
	TimeoutQueue *scw.Duration `json:"timeout_queue,omitempty"`
}

ZonedAPICreateBackendRequest: zoned api create backend request.

func (ZonedAPICreateBackendRequest) MarshalJSON

func (m ZonedAPICreateBackendRequest) MarshalJSON() ([]byte, error)

func (*ZonedAPICreateBackendRequest) UnmarshalJSON

func (m *ZonedAPICreateBackendRequest) UnmarshalJSON(b []byte) error

type ZonedAPICreateCertificateRequest

type ZonedAPICreateCertificateRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// Name: name for the certificate.
	Name string `json:"name"`

	// Letsencrypt: object to define a new Let's Encrypt certificate to be generated.
	// Precisely one of Letsencrypt, CustomCertificate must be set.
	Letsencrypt *CreateCertificateRequestLetsencryptConfig `json:"letsencrypt,omitempty"`

	// CustomCertificate: object to define an existing custom certificate to be imported.
	// Precisely one of Letsencrypt, CustomCertificate must be set.
	CustomCertificate *CreateCertificateRequestCustomCertificate `json:"custom_certificate,omitempty"`
}

ZonedAPICreateCertificateRequest: zoned api create certificate request.

type ZonedAPICreateFrontendRequest

type ZonedAPICreateFrontendRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load Balancer ID (ID of the Load Balancer to attach the frontend to).
	LBID string `json:"-"`

	// Name: name for the frontend.
	Name string `json:"name"`

	// InboundPort: port the frontend should listen on.
	InboundPort int32 `json:"inbound_port"`

	// BackendID: backend ID (ID of the backend the frontend should pass traffic to).
	BackendID string `json:"backend_id"`

	// TimeoutClient: maximum allowed inactivity time on the client side.
	TimeoutClient *time.Duration `json:"timeout_client,omitempty"`

	// Deprecated: CertificateID: certificate ID, deprecated in favor of certificate_ids array.
	CertificateID *string `json:"certificate_id,omitempty"`

	// CertificateIDs: list of SSL/TLS certificate IDs to bind to the frontend.
	CertificateIDs *[]string `json:"certificate_ids,omitempty"`

	// EnableHTTP3: defines whether to enable HTTP/3 protocol on the frontend.
	EnableHTTP3 bool `json:"enable_http3"`
}

ZonedAPICreateFrontendRequest: zoned api create frontend request.

func (ZonedAPICreateFrontendRequest) MarshalJSON

func (m ZonedAPICreateFrontendRequest) MarshalJSON() ([]byte, error)

func (*ZonedAPICreateFrontendRequest) UnmarshalJSON

func (m *ZonedAPICreateFrontendRequest) UnmarshalJSON(b []byte) error

type ZonedAPICreateIPRequest

type ZonedAPICreateIPRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// Deprecated: OrganizationID: organization ID of the Organization where the IP address should be created.
	// Precisely one of ProjectID, OrganizationID must be set.
	OrganizationID *string `json:"organization_id,omitempty"`

	// ProjectID: project ID of the Project where the IP address should be created.
	// Precisely one of ProjectID, OrganizationID must be set.
	ProjectID *string `json:"project_id,omitempty"`

	// Reverse: reverse DNS (domain name) for the IP address.
	Reverse *string `json:"reverse,omitempty"`

	// IsIPv6: if true, creates a Flexible IP with an ipv6 address.
	IsIPv6 bool `json:"is_ipv6"`
}

ZonedAPICreateIPRequest: zoned api create ip request.

type ZonedAPICreateLBRequest

type ZonedAPICreateLBRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// Deprecated: OrganizationID: scaleway Organization to create the Load Balancer in.
	// Precisely one of ProjectID, OrganizationID must be set.
	OrganizationID *string `json:"organization_id,omitempty"`

	// ProjectID: scaleway Project to create the Load Balancer in.
	// Precisely one of ProjectID, OrganizationID must be set.
	ProjectID *string `json:"project_id,omitempty"`

	// Name: name for the Load Balancer.
	Name string `json:"name"`

	// Description: description for the Load Balancer.
	Description string `json:"description"`

	// Deprecated: IPID: ID of an existing flexible IP address to attach to the Load Balancer.
	IPID *string `json:"ip_id,omitempty"`

	// AssignFlexibleIP: defines whether to automatically assign a flexible public IP to lb. Default value is `false` (do not assign).
	AssignFlexibleIP *bool `json:"assign_flexible_ip,omitempty"`

	// AssignFlexibleIPv6: defines whether to automatically assign a flexible public IPv6 to the Load Balancer. Default value is `false` (do not assign).
	AssignFlexibleIPv6 *bool `json:"assign_flexible_ipv6,omitempty"`

	// IPIDs: list of IP IDs to attach to the Load Balancer.
	IPIDs []string `json:"ip_ids"`

	// Tags: list of tags for the Load Balancer.
	Tags []string `json:"tags"`

	// Type: load Balancer commercial offer type. Use the Load Balancer types endpoint to retrieve a list of available offer types.
	Type string `json:"type"`

	// SslCompatibilityLevel: 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. Modern is suitable for services with clients that support TLS 1.3 and do not need backward compatibility. Old is compatible with a small number of very old clients and should be used only as a last resort.
	// Default value: ssl_compatibility_level_unknown
	SslCompatibilityLevel SSLCompatibilityLevel `json:"ssl_compatibility_level"`
}

ZonedAPICreateLBRequest: zoned api create lb request.

type ZonedAPICreateRouteRequest

type ZonedAPICreateRouteRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// FrontendID: ID of the source frontend to create the route on.
	FrontendID string `json:"frontend_id"`

	// BackendID: ID of the target backend for the route.
	BackendID string `json:"backend_id"`

	// Match: 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.
	Match *RouteMatch `json:"match,omitempty"`
}

ZonedAPICreateRouteRequest: zoned api create route request.

type ZonedAPICreateSubscriberRequest

type ZonedAPICreateSubscriberRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// Name: subscriber name.
	Name string `json:"name"`

	// EmailConfig: email address configuration.
	// Precisely one of EmailConfig, WebhookConfig must be set.
	EmailConfig *SubscriberEmailConfig `json:"email_config,omitempty"`

	// WebhookConfig: webHook URI configuration.
	// Precisely one of EmailConfig, WebhookConfig must be set.
	WebhookConfig *SubscriberWebhookConfig `json:"webhook_config,omitempty"`

	// Deprecated: OrganizationID: organization ID to create the subscriber in.
	// Precisely one of ProjectID, OrganizationID must be set.
	OrganizationID *string `json:"organization_id,omitempty"`

	// ProjectID: project ID to create the subscriber in.
	// Precisely one of ProjectID, OrganizationID must be set.
	ProjectID *string `json:"project_id,omitempty"`
}

ZonedAPICreateSubscriberRequest: Create a new alert subscriber (webhook or email).

type ZonedAPIDeleteACLRequest

type ZonedAPIDeleteACLRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// ACLID: ACL ID.
	ACLID string `json:"-"`
}

ZonedAPIDeleteACLRequest: zoned api delete acl request.

type ZonedAPIDeleteBackendRequest

type ZonedAPIDeleteBackendRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// BackendID: ID of the backend to delete.
	BackendID string `json:"-"`
}

ZonedAPIDeleteBackendRequest: zoned api delete backend request.

type ZonedAPIDeleteCertificateRequest

type ZonedAPIDeleteCertificateRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// CertificateID: certificate ID.
	CertificateID string `json:"-"`
}

ZonedAPIDeleteCertificateRequest: zoned api delete certificate request.

type ZonedAPIDeleteFrontendRequest

type ZonedAPIDeleteFrontendRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// FrontendID: ID of the frontend to delete.
	FrontendID string `json:"-"`
}

ZonedAPIDeleteFrontendRequest: zoned api delete frontend request.

type ZonedAPIDeleteLBRequest

type ZonedAPIDeleteLBRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: ID of the Load Balancer to delete.
	LBID string `json:"-"`

	// ReleaseIP: 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.
	ReleaseIP bool `json:"release_ip"`
}

ZonedAPIDeleteLBRequest: zoned api delete lb request.

type ZonedAPIDeleteRouteRequest

type ZonedAPIDeleteRouteRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// RouteID: route ID.
	RouteID string `json:"-"`
}

ZonedAPIDeleteRouteRequest: zoned api delete route request.

type ZonedAPIDeleteSubscriberRequest

type ZonedAPIDeleteSubscriberRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// SubscriberID: subscriber ID.
	SubscriberID string `json:"-"`
}

ZonedAPIDeleteSubscriberRequest: zoned api delete subscriber request.

type ZonedAPIDetachPrivateNetworkRequest

type ZonedAPIDetachPrivateNetworkRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load balancer ID.
	LBID string `json:"-"`

	// PrivateNetworkID: set your instance private network id.
	PrivateNetworkID string `json:"-"`
}

ZonedAPIDetachPrivateNetworkRequest: zoned api detach private network request.

type ZonedAPIGetACLRequest

type ZonedAPIGetACLRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// ACLID: ACL ID.
	ACLID string `json:"-"`
}

ZonedAPIGetACLRequest: zoned api get acl request.

type ZonedAPIGetBackendRequest

type ZonedAPIGetBackendRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// BackendID: backend ID.
	BackendID string `json:"-"`
}

ZonedAPIGetBackendRequest: zoned api get backend request.

type ZonedAPIGetCertificateRequest

type ZonedAPIGetCertificateRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// CertificateID: certificate ID.
	CertificateID string `json:"-"`
}

ZonedAPIGetCertificateRequest: zoned api get certificate request.

type ZonedAPIGetFrontendRequest

type ZonedAPIGetFrontendRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// FrontendID: frontend ID.
	FrontendID string `json:"-"`
}

ZonedAPIGetFrontendRequest: zoned api get frontend request.

type ZonedAPIGetIPRequest

type ZonedAPIGetIPRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// IPID: IP address ID.
	IPID string `json:"-"`
}

ZonedAPIGetIPRequest: zoned api get ip request.

type ZonedAPIGetLBRequest

type ZonedAPIGetLBRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`
}

ZonedAPIGetLBRequest: zoned api get lb request.

type ZonedAPIGetLBStatsRequest

type ZonedAPIGetLBStatsRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// BackendID: ID of the backend.
	BackendID *string `json:"backend_id,omitempty"`
}

ZonedAPIGetLBStatsRequest: Get Load Balancer stats.

type ZonedAPIGetRouteRequest

type ZonedAPIGetRouteRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// RouteID: route ID.
	RouteID string `json:"-"`
}

ZonedAPIGetRouteRequest: zoned api get route request.

type ZonedAPIGetSubscriberRequest

type ZonedAPIGetSubscriberRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// SubscriberID: subscriber ID.
	SubscriberID string `json:"-"`
}

ZonedAPIGetSubscriberRequest: zoned api get subscriber request.

type ZonedAPIListACLsRequest

type ZonedAPIListACLsRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// FrontendID: frontend ID (ACLs attached to this frontend will be returned in the response).
	FrontendID string `json:"-"`

	// OrderBy: sort order of ACLs in the response.
	// Default value: created_at_asc
	OrderBy ListACLRequestOrderBy `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: the number of ACLs to return.
	PageSize *uint32 `json:"-"`

	// Name: ACL name to filter for.
	Name *string `json:"-"`
}

ZonedAPIListACLsRequest: zoned api list ac ls request.

type ZonedAPIListBackendStatsRequest

type ZonedAPIListBackendStatsRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: number of items to return.
	PageSize *uint32 `json:"-"`

	// BackendID: ID of the backend.
	BackendID *string `json:"-"`
}

ZonedAPIListBackendStatsRequest: zoned api list backend stats request.

type ZonedAPIListBackendsRequest

type ZonedAPIListBackendsRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// Name: name of the backend to filter for.
	Name *string `json:"-"`

	// OrderBy: sort order of backends in the response.
	// Default value: created_at_asc
	OrderBy ListBackendsRequestOrderBy `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: number of backends to return.
	PageSize *uint32 `json:"-"`
}

ZonedAPIListBackendsRequest: zoned api list backends request.

type ZonedAPIListCertificatesRequest

type ZonedAPIListCertificatesRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// OrderBy: sort order of certificates in the response.
	// Default value: created_at_asc
	OrderBy ListCertificatesRequestOrderBy `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: number of certificates to return.
	PageSize *uint32 `json:"-"`

	// Name: certificate name to filter for, only certificates of this name will be returned.
	Name *string `json:"-"`
}

ZonedAPIListCertificatesRequest: zoned api list certificates request.

type ZonedAPIListFrontendsRequest

type ZonedAPIListFrontendsRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// Name: name of the frontend to filter for.
	Name *string `json:"-"`

	// OrderBy: sort order of frontends in the response.
	// Default value: created_at_asc
	OrderBy ListFrontendsRequestOrderBy `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: number of frontends to return.
	PageSize *uint32 `json:"-"`
}

ZonedAPIListFrontendsRequest: zoned api list frontends request.

type ZonedAPIListIPsRequest

type ZonedAPIListIPsRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: number of IP addresses to return.
	PageSize *uint32 `json:"-"`

	// IPAddress: IP address to filter for.
	IPAddress *string `json:"-"`

	// OrganizationID: organization ID to filter for, only Load Balancer IP addresses from this Organization will be returned.
	OrganizationID *string `json:"-"`

	// ProjectID: project ID to filter for, only Load Balancer IP addresses from this Project will be returned.
	ProjectID *string `json:"-"`

	// IPType: IP type to filter for.
	// Default value: all
	IPType ListIPsRequestIPType `json:"-"`
}

ZonedAPIListIPsRequest: zoned api list i ps request.

type ZonedAPIListLBPrivateNetworksRequest

type ZonedAPIListLBPrivateNetworksRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// OrderBy: sort order of Private Network objects in the response.
	// Default value: created_at_asc
	OrderBy ListPrivateNetworksRequestOrderBy `json:"-"`

	// PageSize: number of objects to return.
	PageSize *uint32 `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`
}

ZonedAPIListLBPrivateNetworksRequest: zoned api list lb private networks request.

type ZonedAPIListLBTypesRequest

type ZonedAPIListLBTypesRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: the number of items to return.
	PageSize *uint32 `json:"-"`
}

ZonedAPIListLBTypesRequest: zoned api list lb types request.

type ZonedAPIListLBsRequest

type ZonedAPIListLBsRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// Name: load Balancer name to filter for.
	Name *string `json:"-"`

	// OrderBy: sort order of Load Balancers in the response.
	// Default value: created_at_asc
	OrderBy ListLBsRequestOrderBy `json:"-"`

	// PageSize: number of Load Balancers to return.
	PageSize *uint32 `json:"-"`

	// Page: page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// OrganizationID: organization ID to filter for, only Load Balancers from this Organization will be returned.
	OrganizationID *string `json:"-"`

	// ProjectID: project ID to filter for, only Load Balancers from this Project will be returned.
	ProjectID *string `json:"-"`

	// Tags: filter by tag, only Load Balancers with one or more matching tags will be returned.
	Tags []string `json:"-"`
}

ZonedAPIListLBsRequest: zoned api list l bs request.

type ZonedAPIListRoutesRequest

type ZonedAPIListRoutesRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// OrderBy: sort order of routes in the response.
	// Default value: created_at_asc
	OrderBy ListRoutesRequestOrderBy `json:"-"`

	// PageSize: the number of route objects to return.
	PageSize *uint32 `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// FrontendID: frontend ID to filter for, only Routes from this Frontend will be returned.
	FrontendID *string `json:"-"`
}

ZonedAPIListRoutesRequest: zoned api list routes request.

type ZonedAPIListSubscriberRequest

type ZonedAPIListSubscriberRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// OrderBy: sort order of subscribers in the response.
	// Default value: created_at_asc
	OrderBy ListSubscriberRequestOrderBy `json:"-"`

	// Page: the page number to return, from the paginated results.
	Page *int32 `json:"-"`

	// PageSize: the number of items to return.
	PageSize *uint32 `json:"-"`

	// Name: subscriber name to search for.
	Name *string `json:"-"`

	// OrganizationID: filter subscribers by Organization ID.
	OrganizationID *string `json:"-"`

	// ProjectID: filter subscribers by Project ID.
	ProjectID *string `json:"-"`
}

ZonedAPIListSubscriberRequest: zoned api list subscriber request.

type ZonedAPIMigrateLBRequest

type ZonedAPIMigrateLBRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// Type: load Balancer type to migrate to (use the List all Load Balancer offer types endpoint to get a list of available offer types).
	Type string `json:"type"`
}

ZonedAPIMigrateLBRequest: zoned api migrate lb request.

type ZonedAPIReleaseIPRequest

type ZonedAPIReleaseIPRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// IPID: IP address ID.
	IPID string `json:"-"`
}

ZonedAPIReleaseIPRequest: zoned api release ip request.

type ZonedAPIRemoveBackendServersRequest

type ZonedAPIRemoveBackendServersRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// BackendID: backend ID.
	BackendID string `json:"-"`

	// ServerIP: list of IP addresses to remove from backend servers.
	ServerIP []string `json:"server_ip"`
}

ZonedAPIRemoveBackendServersRequest: zoned api remove backend servers request.

type ZonedAPISetACLsRequest

type ZonedAPISetACLsRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// FrontendID: frontend ID.
	FrontendID string `json:"-"`

	// ACLs: list of ACLs for this frontend. Any other existing ACLs on this frontend will be removed.
	ACLs []*ACLSpec `json:"acls"`
}

ZonedAPISetACLsRequest: zoned api set ac ls request.

type ZonedAPISetBackendServersRequest

type ZonedAPISetBackendServersRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// BackendID: backend ID.
	BackendID string `json:"-"`

	// ServerIP: list of IP addresses for backend servers. Any other existing backend servers will be removed.
	ServerIP []string `json:"server_ip"`
}

ZonedAPISetBackendServersRequest: zoned api set backend servers request.

type ZonedAPISubscribeToLBRequest

type ZonedAPISubscribeToLBRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// SubscriberID: subscriber ID.
	SubscriberID string `json:"subscriber_id"`
}

ZonedAPISubscribeToLBRequest: zoned api subscribe to lb request.

type ZonedAPIUnsubscribeFromLBRequest

type ZonedAPIUnsubscribeFromLBRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`
}

ZonedAPIUnsubscribeFromLBRequest: zoned api unsubscribe from lb request.

type ZonedAPIUpdateACLRequest

type ZonedAPIUpdateACLRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// ACLID: ACL ID.
	ACLID string `json:"-"`

	// Name: ACL name.
	Name string `json:"name"`

	// Action: action to take when incoming traffic matches an ACL filter.
	Action *ACLAction `json:"action"`

	// Match: ACL match filter object. One of `ip_subnet` or `http_filter` & `http_filter_value` are required.
	Match *ACLMatch `json:"match,omitempty"`

	// Index: priority of this ACL (ACLs are applied in ascending order, 0 is the first ACL executed).
	Index int32 `json:"index"`

	// Description: ACL description.
	Description *string `json:"description,omitempty"`
}

ZonedAPIUpdateACLRequest: zoned api update acl request.

type ZonedAPIUpdateBackendRequest

type ZonedAPIUpdateBackendRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// BackendID: backend ID.
	BackendID string `json:"-"`

	// Name: backend name.
	Name string `json:"name"`

	// ForwardProtocol: protocol to be used by the backend when forwarding traffic to backend servers.
	// Default value: tcp
	ForwardProtocol Protocol `json:"forward_protocol"`

	// ForwardPort: port to be used by the backend when forwarding traffic to backend servers.
	ForwardPort int32 `json:"forward_port"`

	// ForwardPortAlgorithm: load balancing algorithm to be used when determining which backend server to forward new traffic to.
	// Default value: roundrobin
	ForwardPortAlgorithm ForwardPortAlgorithm `json:"forward_port_algorithm"`

	// StickySessions: 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.
	// Default value: none
	StickySessions StickySessionsType `json:"sticky_sessions"`

	// StickySessionsCookieName: cookie name for cookie-based sticky sessions.
	StickySessionsCookieName string `json:"sticky_sessions_cookie_name"`

	// Deprecated: SendProxyV2: deprecated in favor of proxy_protocol field.
	SendProxyV2 *bool `json:"send_proxy_v2,omitempty"`

	// TimeoutServer: maximum allowed time for a backend server to process a request.
	TimeoutServer *time.Duration `json:"timeout_server,omitempty"`

	// TimeoutConnect: maximum allowed time for establishing a connection to a backend server.
	TimeoutConnect *time.Duration `json:"timeout_connect,omitempty"`

	// TimeoutTunnel: maximum allowed tunnel inactivity time after Websocket is established (takes precedence over client and server timeout).
	TimeoutTunnel *time.Duration `json:"timeout_tunnel,omitempty"`

	// OnMarkedDownAction: action to take when a backend server is marked as down.
	// Default value: on_marked_down_action_none
	OnMarkedDownAction OnMarkedDownAction `json:"on_marked_down_action"`

	// ProxyProtocol: 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.
	// Default value: proxy_protocol_unknown
	ProxyProtocol ProxyProtocol `json:"proxy_protocol"`

	// FailoverHost: scaleway S3 bucket website to be served as failover if all backend servers are down, e.g. failover-website.s3-website.fr-par.scw.cloud.
	FailoverHost *string `json:"failover_host,omitempty"`

	// SslBridging: defines whether to enable SSL bridging between the Load Balancer and backend servers.
	SslBridging *bool `json:"ssl_bridging,omitempty"`

	// IgnoreSslServerVerify: defines whether the server certificate verification should be ignored.
	IgnoreSslServerVerify *bool `json:"ignore_ssl_server_verify,omitempty"`

	// RedispatchAttemptCount: whether to use another backend server on each attempt.
	RedispatchAttemptCount *int32 `json:"redispatch_attempt_count,omitempty"`

	// MaxRetries: number of retries when a backend server connection failed.
	MaxRetries *int32 `json:"max_retries,omitempty"`

	// MaxConnections: maximum number of connections allowed per backend server.
	MaxConnections *int32 `json:"max_connections,omitempty"`

	// TimeoutQueue: maximum time for a request to be left pending in queue when `max_connections` is reached.
	TimeoutQueue *scw.Duration `json:"timeout_queue,omitempty"`
}

ZonedAPIUpdateBackendRequest: zoned api update backend request.

func (ZonedAPIUpdateBackendRequest) MarshalJSON

func (m ZonedAPIUpdateBackendRequest) MarshalJSON() ([]byte, error)

func (*ZonedAPIUpdateBackendRequest) UnmarshalJSON

func (m *ZonedAPIUpdateBackendRequest) UnmarshalJSON(b []byte) error

type ZonedAPIUpdateCertificateRequest

type ZonedAPIUpdateCertificateRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// CertificateID: certificate ID.
	CertificateID string `json:"-"`

	// Name: certificate name.
	Name string `json:"name"`
}

ZonedAPIUpdateCertificateRequest: zoned api update certificate request.

type ZonedAPIUpdateFrontendRequest

type ZonedAPIUpdateFrontendRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// FrontendID: frontend ID.
	FrontendID string `json:"-"`

	// Name: frontend name.
	Name string `json:"name"`

	// InboundPort: port the frontend should listen on.
	InboundPort int32 `json:"inbound_port"`

	// BackendID: backend ID (ID of the backend the frontend should pass traffic to).
	BackendID string `json:"backend_id"`

	// TimeoutClient: maximum allowed inactivity time on the client side.
	TimeoutClient *time.Duration `json:"timeout_client,omitempty"`

	// Deprecated: CertificateID: certificate ID, deprecated in favor of certificate_ids array.
	CertificateID *string `json:"certificate_id,omitempty"`

	// CertificateIDs: list of SSL/TLS certificate IDs to bind to the frontend.
	CertificateIDs *[]string `json:"certificate_ids,omitempty"`

	// EnableHTTP3: defines whether to enable HTTP/3 protocol on the frontend.
	EnableHTTP3 bool `json:"enable_http3"`
}

ZonedAPIUpdateFrontendRequest: zoned api update frontend request.

func (ZonedAPIUpdateFrontendRequest) MarshalJSON

func (m ZonedAPIUpdateFrontendRequest) MarshalJSON() ([]byte, error)

func (*ZonedAPIUpdateFrontendRequest) UnmarshalJSON

func (m *ZonedAPIUpdateFrontendRequest) UnmarshalJSON(b []byte) error

type ZonedAPIUpdateHealthCheckRequest

type ZonedAPIUpdateHealthCheckRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// BackendID: backend ID.
	BackendID string `json:"-"`

	// Port: port to use for the backend server health check.
	Port int32 `json:"port"`

	// CheckDelay: time to wait between two consecutive health checks.
	CheckDelay *time.Duration `json:"check_delay,omitempty"`

	// CheckTimeout: maximum time a backend server has to reply to the health check.
	CheckTimeout *time.Duration `json:"check_timeout,omitempty"`

	// CheckMaxRetries: number of consecutive unsuccessful health checks after which the server will be considered dead.
	CheckMaxRetries int32 `json:"check_max_retries"`

	// CheckSendProxy: defines whether proxy protocol should be activated for the health check.
	CheckSendProxy bool `json:"check_send_proxy"`

	// TCPConfig: object to configure a basic TCP health check.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	TCPConfig *HealthCheckTCPConfig `json:"tcp_config,omitempty"`

	// MysqlConfig: object to configure a MySQL health check. The check requires MySQL >=3.22, for older versions, use a TCP health check.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	MysqlConfig *HealthCheckMysqlConfig `json:"mysql_config,omitempty"`

	// PgsqlConfig: object to configure a PostgreSQL health check.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	PgsqlConfig *HealthCheckPgsqlConfig `json:"pgsql_config,omitempty"`

	// LdapConfig: object to configure an LDAP health check. The response is analyzed to find the LDAPv3 response message.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	LdapConfig *HealthCheckLdapConfig `json:"ldap_config,omitempty"`

	// RedisConfig: object to configure a Redis health check. The response is analyzed to find the +PONG response message.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	RedisConfig *HealthCheckRedisConfig `json:"redis_config,omitempty"`

	// HTTPConfig: object to configure an HTTP health check.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	HTTPConfig *HealthCheckHTTPConfig `json:"http_config,omitempty"`

	// HTTPSConfig: object to configure an HTTPS health check.
	// Precisely one of TCPConfig, MysqlConfig, PgsqlConfig, LdapConfig, RedisConfig, HTTPConfig, HTTPSConfig must be set.
	HTTPSConfig *HealthCheckHTTPSConfig `json:"https_config,omitempty"`

	// TransientCheckDelay: time to wait between two consecutive health checks when a backend server is in a transient state (going UP or DOWN).
	TransientCheckDelay *scw.Duration `json:"transient_check_delay,omitempty"`
}

ZonedAPIUpdateHealthCheckRequest: zoned api update health check request.

func (ZonedAPIUpdateHealthCheckRequest) MarshalJSON

func (m ZonedAPIUpdateHealthCheckRequest) MarshalJSON() ([]byte, error)

func (*ZonedAPIUpdateHealthCheckRequest) UnmarshalJSON

func (m *ZonedAPIUpdateHealthCheckRequest) UnmarshalJSON(b []byte) error

type ZonedAPIUpdateIPRequest

type ZonedAPIUpdateIPRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// IPID: IP address ID.
	IPID string `json:"-"`

	// Reverse: reverse DNS (domain name) for the IP address.
	Reverse *string `json:"reverse,omitempty"`

	// LBID: ID of the server on which to attach the flexible IP.
	LBID *string `json:"lb_id,omitempty"`
}

ZonedAPIUpdateIPRequest: zoned api update ip request.

type ZonedAPIUpdateLBRequest

type ZonedAPIUpdateLBRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// LBID: load Balancer ID.
	LBID string `json:"-"`

	// Name: load Balancer name.
	Name string `json:"name"`

	// Description: load Balancer description.
	Description string `json:"description"`

	// Tags: list of tags for the Load Balancer.
	Tags []string `json:"tags"`

	// SslCompatibilityLevel: 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. Modern is suitable for services with clients that support TLS 1.3 and don't need backward compatibility. Old is compatible with a small number of very old clients and should be used only as a last resort.
	// Default value: ssl_compatibility_level_unknown
	SslCompatibilityLevel SSLCompatibilityLevel `json:"ssl_compatibility_level"`
}

ZonedAPIUpdateLBRequest: zoned api update lb request.

type ZonedAPIUpdateRouteRequest

type ZonedAPIUpdateRouteRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// RouteID: route ID.
	RouteID string `json:"-"`

	// BackendID: ID of the target backend for the route.
	BackendID string `json:"backend_id"`

	// Match: 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.
	Match *RouteMatch `json:"match,omitempty"`
}

ZonedAPIUpdateRouteRequest: zoned api update route request.

type ZonedAPIUpdateSubscriberRequest

type ZonedAPIUpdateSubscriberRequest struct {
	// Zone: zone to target. If none is passed will use default zone from the config.
	Zone scw.Zone `json:"-"`

	// SubscriberID: subscriber ID.
	SubscriberID string `json:"-"`

	// Name: subscriber name.
	Name string `json:"name"`

	// EmailConfig: email address configuration.
	// Precisely one of EmailConfig, WebhookConfig must be set.
	EmailConfig *SubscriberEmailConfig `json:"email_config,omitempty"`

	// WebhookConfig: webhook URI configuration.
	// Precisely one of EmailConfig, WebhookConfig must be set.
	WebhookConfig *SubscriberWebhookConfig `json:"webhook_config,omitempty"`
}

ZonedAPIUpdateSubscriberRequest: zoned api update subscriber request.

type ZonedAPIWaitForLBCertificateRequest

type ZonedAPIWaitForLBCertificateRequest struct {
	CertID        string
	Zone          scw.Zone
	Timeout       *time.Duration
	RetryInterval *time.Duration
}

ZonedAPIWaitForLBCertificateRequest is used by WaitForLbCertificate method.

type ZonedAPIWaitForLBInstancesRequest

type ZonedAPIWaitForLBInstancesRequest struct {
	LBID          string
	Zone          scw.Zone
	Timeout       *time.Duration
	RetryInterval *time.Duration
}

ZonedAPIWaitForLBInstancesRequest is used by WaitForLb method.

type ZonedAPIWaitForLBPNRequest

type ZonedAPIWaitForLBPNRequest struct {
	LBID          string
	Zone          scw.Zone
	Timeout       *time.Duration
	RetryInterval *time.Duration
}

ZonedAPIWaitForLBPNRequest is used by WaitForLBPN method.

type ZonedAPIWaitForLBRequest

type ZonedAPIWaitForLBRequest struct {
	LBID          string
	Zone          scw.Zone
	Timeout       *time.Duration
	RetryInterval *time.Duration
}

ZonedAPIWaitForLBRequest is used by WaitForLb method.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL