v1.0.0

pkg/cloudbroker/disks/resize.go

@@ -7,12 +7,18 @@ import (
 	"strconv"
 )
 
+// Request struct for resize disk
 type ResizeRequest struct {
+	// ID of the disk to resize
+	// Required: true
 	DiskID uint64 `url:"diskId"`
-	Size   uint64 `url:"size"`
+
+	// New size of the disk in GB
+	// Required: true
+	Size uint64 `url:"size"`
 }
 
-func (drq ResizeRequest) Validate() error {
+func (drq ResizeRequest) validate() error {
 	if drq.DiskID == 0 {
 		return errors.New("validation-error: field DiskID must be set")
 	}
@@ -22,8 +28,12 @@ func (drq ResizeRequest) Validate() error {
 	return nil
 }
 
+// Resize resize disk
+// Returns 200 if disk is resized online, else will return 202,
+// in that case please stop and start your machine after changing the disk size, for your changes to be reflected.
+// This method will not be used for disks, assigned to computes. Only unassigned disks and disks, assigned with "old" virtual machines.
 func (d Disks) Resize(ctx context.Context, req ResizeRequest) (bool, error) {
-	err := req.Validate()
+	err := req.validate()
 	if err != nil {
 		return false, err
 	}
@@ -41,11 +51,14 @@ func (d Disks) Resize(ctx context.Context, req ResizeRequest) (bool, error) {
 	}
 
 	return result, nil
-
 }
 
+// Resize2 resize disk
+// Returns 200 if disk is resized online, else will return 202,
+// in that case please stop and start your machine after changing the disk size, for your changes to be reflected.
+// This method will not be used for disks, assigned to "old" virtual machines. Only unassigned disks and disks, assigned with computes.
 func (d Disks) Resize2(ctx context.Context, req ResizeRequest) (bool, error) {
-	err := req.Validate()
+	err := req.validate()
 	if err != nil {
 		return false, err
 	}
@@ -63,5 +76,4 @@ func (d Disks) Resize2(ctx context.Context, req ResizeRequest) (bool, error) {
 	}
 
 	return result, nil
-
 }