feat(lbaas): maintenance window (#295)

Author: villevsv-upcloud

CHANGELOG.md

@@ -5,6 +5,9 @@ See updating [Changelog example here](https://keepachangelog.com/en/1.0.0/)
 
 ## [Unreleased]
 
+### Added
+- Managed Load Balancer: `MaintenanceDOW` and `MaintenanceTime` fields for controlling maintenance window occurrence
+
 ### Changed
 - **Breaking**, Managed Database: `ManagedDatabaseUserOpernSearchAccessControl` fields changed to pointers
 - **Breaking**, Managed Database: `ManagedDatabaseUserPGAccessControl` fields changed to pointers

upcloud/load_balancer.go

@@ -22,6 +22,7 @@ type (
 	LoadBalancerNetworkType                       string
 	LoadBalancerAddressFamily                     string
 	LoadBalancerNodeOperationalState              string
+	LoadBalancerMaintenanceDOW                    string
 )
 
 const (
@@ -125,6 +126,14 @@ const (
 	LoadBalancerNodeOperationalStateAgentUpgradeFinishing LoadBalancerNodeOperationalState = "agent-upgrade-finishing"
 	LoadBalancerNodeOperationalStateStopped               LoadBalancerNodeOperationalState = "stopped"
 	LoadBalancerNodeOperationalStateNotResponding         LoadBalancerNodeOperationalState = "not-responding"
+
+	LoadBalancerMaintenanceDOWMonday    LoadBalancerMaintenanceDOW = "monday"
+	LoadBalancerMaintenanceDOWTuesday   LoadBalancerMaintenanceDOW = "tuesday"
+	LoadBalancerMaintenanceDOWWednesday LoadBalancerMaintenanceDOW = "wednesday"
+	LoadBalancerMaintenanceDOWThursday  LoadBalancerMaintenanceDOW = "thursday"
+	LoadBalancerMaintenanceDOWFriday    LoadBalancerMaintenanceDOW = "friday"
+	LoadBalancerMaintenanceOWSaturday   LoadBalancerMaintenanceDOW = "saturday"
+	LoadBalancerMaintenanceDOWSunday    LoadBalancerMaintenanceDOW = "sunday"
 )
 
 // LoadBalancerPlan represents load balancer plan details
@@ -255,6 +264,8 @@ type LoadBalancer struct {
 	Nodes            []LoadBalancerNode           `json:"nodes,omitempty"`
 	CreatedAt        time.Time                    `json:"created_at,omitempty"`
 	UpdatedAt        time.Time                    `json:"updated_at,omitempty"`
+	MaintenanceDOW   LoadBalancerMaintenanceDOW   `json:"maintenance_dow,omitempty"`
+	MaintenanceTime  string                       `json:"maintenance_time,omitempty"`
 }
 
 // LoadBalancerMatcher represents rule matcher

upcloud/load_balancer_test.go

@@ -22,6 +22,8 @@ func TestMarshalLoadBalancer(t *testing.T) {
 			"updated_at": "2022-02-11T17:33:59.898714Z",
 			"uuid": "0aff6dac-143c-4300-9b33-ee2756f6592d",
 			"zone": "fi-hel1",
+			"maintenance_dow": "sunday",
+			"maintenance_time": "20:01:01Z",
 			"labels": [
 				{
 					"key": "managedby",
@@ -149,6 +151,8 @@ func TestMarshalLoadBalancer(t *testing.T) {
 		OperationalState: LoadBalancerOperationalStateRunning,
 		CreatedAt:        timeParse("2021-12-07T13:58:30.817272Z"),
 		UpdatedAt:        timeParse("2022-02-11T17:33:59.898714Z"),
+		MaintenanceDOW:   LoadBalancerMaintenanceDOWSunday,
+		MaintenanceTime:  "20:01:01Z",
 		Labels: []Label{
 			{
 				Key:   "managedby",

upcloud/request/load_balancer.go

@@ -60,6 +60,8 @@ type CreateLoadBalancerRequest struct {
 	Backends         []LoadBalancerBackend                `json:"backends"`
 	Resolvers        []LoadBalancerResolver               `json:"resolvers"`
 	Labels           []upcloud.Label                      `json:"labels,omitempty"`
+	MaintenanceDOW   upcloud.LoadBalancerMaintenanceDOW   `json:"maintenance_dow,omitempty"`
+	MaintenanceTime  string                               `json:"maintenance_time,omitempty"`
 }
 
 func (r *CreateLoadBalancerRequest) RequestURL() string {
@@ -68,11 +70,13 @@ func (r *CreateLoadBalancerRequest) RequestURL() string {
 
 // ModifyLoadBalancerRequest represents a request to modify load balancer
 type ModifyLoadBalancerRequest struct {
-	UUID             string           `json:"-"`
-	Name             string           `json:"name,omitempty"`
-	Plan             string           `json:"plan,omitempty"`
-	ConfiguredStatus string           `json:"configured_status,omitempty"`
-	Labels           *[]upcloud.Label `json:"labels,omitempty"`
+	UUID             string                             `json:"-"`
+	Name             string                             `json:"name,omitempty"`
+	Plan             string                             `json:"plan,omitempty"`
+	ConfiguredStatus string                             `json:"configured_status,omitempty"`
+	Labels           *[]upcloud.Label                   `json:"labels,omitempty"`
+	MaintenanceDOW   upcloud.LoadBalancerMaintenanceDOW `json:"maintenance_dow,omitempty"`
+	MaintenanceTime  string                             `json:"maintenance_time,omitempty"`
 }
 
 func (r *ModifyLoadBalancerRequest) RequestURL() string {

upcloud/request/load_balancer_test.go

@@ -92,7 +92,9 @@ func TestCreateLoadBalancerRequest(t *testing.T) {
 				"cache_valid": 180,
 				"cache_invalid": 10
 			}
-		]
+		],
+		"maintenance_dow": "sunday",
+		"maintenance_time": "20:01:01Z"
 	}
 	`
 	r := CreateLoadBalancerRequest{
@@ -128,6 +130,8 @@ func TestCreateLoadBalancerRequest(t *testing.T) {
 			CacheValid:   180,
 			CacheInvalid: 10,
 		}},
+		MaintenanceDOW:  upcloud.LoadBalancerMaintenanceDOWSunday,
+		MaintenanceTime: "20:01:01Z",
 	}
 	actual, err := json.Marshal(&r)
 	assert.NoError(t, err)