All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.solidfire.element.api.QoS Maven / Gradle / Ivy

The newest version!
/*
 * Copyright © 2014-2016 NetApp, Inc. All Rights Reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
/*
 * DO NOT EDIT THIS CODE BY HAND! It has been generated with jsvcgen.
 */
package com.solidfire.element.api;

import com.solidfire.gson.Gson;
import com.solidfire.core.client.Attributes;
import com.solidfire.gson.annotations.SerializedName;
import com.solidfire.core.annotation.Since;
import com.solidfire.core.javautil.Optional;
import java.io.Serializable;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Objects;

/**
 * QoS  
 * Quality of Service (QoS) values are used on SolidFire volumes to provision performance expectations.
 * Minimum, maximum and burst QoS values can be set within the ranges specified in the QoS table below.
 * 
 * Volumes created without specified QoS values are created with the Default values listed below.
 * Default values can be found by running the GetDefaultQoS method.
 * 
 * minIOPS Min: 100/50 (v7.0/v8.0), Default: 100, Max: 15,000
 * maxIOPS Min: 100/50 (v7.0/v8.0), Default: 15,000, Max: 100,000
 * burstIOPS Min: 100/50 (v7.0/v8.0), Default: 15,000, Max: 100,000
 **/

public class QoS implements Serializable {

    public static final long serialVersionUID = 1023223855695272644L;
    @SerializedName("minIOPS") private Optional minIOPS;
    @SerializedName("maxIOPS") private Optional maxIOPS;
    @SerializedName("burstIOPS") private Optional burstIOPS;
    @SerializedName("burstTime") private Optional burstTime;
    @SerializedName("curve") private Optional curve;
    // empty constructor
    @Since("7.0")
    public QoS() {}

    
    // parameterized constructor
    @Since("7.0")
    public QoS(
        Optional minIOPS,
        Optional maxIOPS,
        Optional burstIOPS,
        Optional burstTime,
        Optional curve
    )
    {
        this.minIOPS = (minIOPS == null) ? Optional.empty() : minIOPS;
        this.maxIOPS = (maxIOPS == null) ? Optional.empty() : maxIOPS;
        this.burstIOPS = (burstIOPS == null) ? Optional.empty() : burstIOPS;
        this.burstTime = (burstTime == null) ? Optional.empty() : burstTime;
        this.curve = (curve == null) ? Optional.empty() : curve;
    }

    /** 
     * Desired minimum 4KB IOPS to guarantee.
     * The allowed IOPS will only drop below this level if all volumes have been capped
     * at their minimum IOPS value and there is still insufficient performance capacity.
     **/
    public Optional getMinIOPS() { return this.minIOPS; }
   
    public void setMinIOPS(Optional minIOPS) { 
        this.minIOPS = (minIOPS == null) ? Optional.empty() : minIOPS;
    }
    /** 
     * Desired maximum 4KB IOPS allowed over an extended period of time.
     **/
    public Optional getMaxIOPS() { return this.maxIOPS; }
   
    public void setMaxIOPS(Optional maxIOPS) { 
        this.maxIOPS = (maxIOPS == null) ? Optional.empty() : maxIOPS;
    }
    /** 
     * Maximum "peak" 4KB IOPS allowed for short periods of time.
     * Allows for bursts of I/O activity over the normal max IOPS value.
     **/
    public Optional getBurstIOPS() { return this.burstIOPS; }
   
    public void setBurstIOPS(Optional burstIOPS) { 
        this.burstIOPS = (burstIOPS == null) ? Optional.empty() : burstIOPS;
    }
    /** 
     * The length of time burst IOPS is allowed.
     * The value returned is represented in time units of seconds.
     * Note: this value is calculated by the system based on IOPS set for QoS.
     **/
    public Optional getBurstTime() { return this.burstTime; }
   
    public void setBurstTime(Optional burstTime) { 
        this.burstTime = (burstTime == null) ? Optional.empty() : burstTime;
    }
    /** 
     * The curve is a set of key-value pairs.
     * The keys are I/O sizes in bytes.
     * The values represent the cost performing an IOP at a specific I/O size.
     * The curve is calculated relative to a 4096 byte operation set at 100 IOPS.
     **/
    public Optional getCurve() { return this.curve; }
   
    public void setCurve(Optional curve) { 
        this.curve = (curve == null) ? Optional.empty() : curve;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;

        QoS that = (QoS) o;

        return 
            Objects.equals(minIOPS, that.minIOPS) && 
            Objects.equals(maxIOPS, that.maxIOPS) && 
            Objects.equals(burstIOPS, that.burstIOPS) && 
            Objects.equals(burstTime, that.burstTime) && 
            Objects.equals(curve, that.curve);
    }

    @Override
    public int hashCode() {
        return Objects.hash( minIOPS,maxIOPS,burstIOPS,burstTime,curve );
    }


    public java.util.Map toMap() {
        java.util.Map map = new HashMap<>();
        map.put("minIOPS", minIOPS);
        map.put("maxIOPS", maxIOPS);
        map.put("burstIOPS", burstIOPS);
        map.put("burstTime", burstTime);
        map.put("curve", curve);
        return map;
    }

    @Override
    public String toString() {
        final StringBuilder sb = new StringBuilder();
        Gson gson = new Gson();
        sb.append( "{ " );

        if(null != minIOPS && minIOPS.isPresent()){
            sb.append(" minIOPS : ").append(gson.toJson(minIOPS)).append(",");
        }
        else{
            sb.append(" minIOPS : ").append("null").append(",");
        }
        if(null != maxIOPS && maxIOPS.isPresent()){
            sb.append(" maxIOPS : ").append(gson.toJson(maxIOPS)).append(",");
        }
        else{
            sb.append(" maxIOPS : ").append("null").append(",");
        }
        if(null != burstIOPS && burstIOPS.isPresent()){
            sb.append(" burstIOPS : ").append(gson.toJson(burstIOPS)).append(",");
        }
        else{
            sb.append(" burstIOPS : ").append("null").append(",");
        }
        if(null != burstTime && burstTime.isPresent()){
            sb.append(" burstTime : ").append(gson.toJson(burstTime)).append(",");
        }
        else{
            sb.append(" burstTime : ").append("null").append(",");
        }
        if(null != curve && curve.isPresent()){
            sb.append(" curve : ").append(gson.toJson(curve)).append(",");
        }
        else{
            sb.append(" curve : ").append("null").append(",");
        }
        sb.append( " }" );

        if(sb.lastIndexOf(", }") != -1)
            sb.deleteCharAt(sb.lastIndexOf(", }"));

        return sb.toString();
    }

    public static Builder builder() {
        return new Builder();
    }

    public final Builder asBuilder() {
        return new Builder().buildFrom(this);
    }

    public static class Builder {
        private Optional minIOPS;
        private Optional maxIOPS;
        private Optional burstIOPS;
        private Optional burstTime;
        private Optional curve;

        private Builder() { }

        public QoS build() {
            return new QoS (
                         this.minIOPS,
                         this.maxIOPS,
                         this.burstIOPS,
                         this.burstTime,
                         this.curve);
        }

        private QoS.Builder buildFrom(final QoS req) {
            this.minIOPS = req.minIOPS;
            this.maxIOPS = req.maxIOPS;
            this.burstIOPS = req.burstIOPS;
            this.burstTime = req.burstTime;
            this.curve = req.curve;

            return this;
        }

        public QoS.Builder optionalMinIOPS(final Long minIOPS) {
            this.minIOPS = (minIOPS == null) ? Optional.empty() : Optional.of(minIOPS);
            return this;
        }

        public QoS.Builder optionalMaxIOPS(final Long maxIOPS) {
            this.maxIOPS = (maxIOPS == null) ? Optional.empty() : Optional.of(maxIOPS);
            return this;
        }

        public QoS.Builder optionalBurstIOPS(final Long burstIOPS) {
            this.burstIOPS = (burstIOPS == null) ? Optional.empty() : Optional.of(burstIOPS);
            return this;
        }

        public QoS.Builder optionalBurstTime(final Long burstTime) {
            this.burstTime = (burstTime == null) ? Optional.empty() : Optional.of(burstTime);
            return this;
        }

        public QoS.Builder optionalCurve(final Attributes curve) {
            this.curve = (curve == null) ? Optional.empty() : Optional.of(curve);
            return this;
        }

    }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy