• Home
• com.solidfire
• element-api
• 1.0.0-RC1
• source code
• QoS.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

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

/*
 * Copyright © 2015 SolidFire, 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.javautil.Optional;

import com.solidfire.client.ApiException;
import com.solidfire.javautil.Optional;

import java.net.URL;
import java.util.Arrays;
import java.util.Objects;
import com.solidfire.annotation.Since;

import static com.solidfire.javautil.Optional.of;


/**
 * Quality of Service (QoS) values are used on SolidFire volumes to provision performance expectations.
 **/
public class QoS {

    private final Optional minIOPS;
    private final Optional maxIOPS;
    private final Optional burstIOPS;
    private final Optional burstTime;

    /**
     * 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.
     * 


     * 
     * 
     * 
     * 
     * 
     * 
Name
Min Allowed
(v7.0/v8.0)
Default
Max Allowed
minIOPS
100/50
100
15,000
maxIOPS
100/50
15,000
100,000
burstIOPS
100/50
15,000
100,000
     * @param minIOPS (optional) Desired minimum 4KB IOPS to guarantee.
     * @param maxIOPS (optional) Desired maximum 4KB IOPS allowed over an extended period of time.
     * @param burstIOPS (optional) Maximum "peak" 4KB IOPS allowed for short periods of time.
     * @param burstTime (optional) The length of time burstIOPS is allowed.
     * @since 7.0
     **/
    @Since("7.0")
    public QoS(Optional minIOPS, Optional maxIOPS, Optional burstIOPS, Optional burstTime) {
        this.minIOPS = minIOPS;
        this.maxIOPS = maxIOPS;
        this.burstIOPS = burstIOPS;
        this.burstTime = burstTime;
    }


    /**
     * Desired minimum 4KB IOPS to guarantee.
     * The allowed IOPS will only drop below this level if all volumes have been capped
     * at their minIOPS value and there is still insufficient performance capacity.
     **/
    public Optional getMinIOPS() {
        return this.minIOPS;
    }

    /**
     * Desired maximum 4KB IOPS allowed over an extended period of time.
     **/
    public Optional getMaxIOPS() {
        return this.maxIOPS;
    }

    /**
     * Maximum "peak" 4KB IOPS allowed for short periods of time.
     * Allows for bursts of I/O activity over the normal maxIOPS value.
     **/
    public Optional getBurstIOPS() {
        return this.burstIOPS;
    }

    /**
     * The length of time burstIOPS 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;
    }

    @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 );
    }

    @Override
    public int hashCode() {

        return Objects.hash( minIOPS, maxIOPS, burstIOPS, burstTime );
    }


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

        if(null != minIOPS && minIOPS.isPresent())
            sb.append(" minIOPS : ").append(minIOPS.get()).append(",");
        if(null != maxIOPS && maxIOPS.isPresent())
            sb.append(" maxIOPS : ").append(maxIOPS.get()).append(",");
        if(null != burstIOPS && burstIOPS.isPresent())
            sb.append(" burstIOPS : ").append(burstIOPS.get()).append(",");
        if(null != burstTime && burstTime.isPresent())
            sb.append(" burstTime : ").append(burstTime.get());
        sb.append( " }" );

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

        return sb.toString();
    }
}