v1.0.0

pkg/cloudapi/bservice/disable.go

@@ -7,11 +7,14 @@ import (
 	"strconv"
 )
 
+// Request struct for disable service
 type DisableRequest struct {
+	// ID of the service to disable
+	// Required: true
 	ServiceID uint64 `url:"serviceId"`
 }
 
-func (bsrq DisableRequest) Validate() error {
+func (bsrq DisableRequest) validate() error {
 	if bsrq.ServiceID == 0 {
 		return errors.New("field ServiceID can not be empty or equal to 0")
 	}
@@ -19,16 +22,26 @@ func (bsrq DisableRequest) Validate() error {
 	return nil
 }
 
+// Disable disables service.
+// Disabling a service technically means setting model status
+// of all computes and service itself to DISABLED and stopping all computes.
 func (b BService) Disable(ctx context.Context, req DisableRequest) (bool, error) {
-	if err := req.Validate(); err != nil {
+	err := req.validate()
+	if err != nil {
 		return false, err
 	}
 
 	url := "/cloudapi/bservice/delete"
+
 	res, err := b.client.DecortApiCall(ctx, http.MethodPost, url, req)
 	if err != nil {
 		return false, err
 	}
 
-	return strconv.ParseBool(string(res))
+	result, err := strconv.ParseBool(string(res))
+	if err != nil {
+		return false, err
+	}
+
+	return result, nil
 }