com.qcloud.cos.model.StorageClass Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of cos_api Show documentation
qcloud cos sdk for inner tencentyun
The newest version!
package com.qcloud.cos.model;

/**
 * 
 * Specifies constants that define COS storage classes. The standard storage class
 * is the default storage class.
 * 
 * 
 * Qcloud COS offers multiple storage classes for different customers' needs. The
 * STANDARD storage class is the default storage class, and means that
 * redundant copies of data will be stored in different locations.
 * 
 * 
 * The REDUCED_REDUNDANCY storage class offers customers who are using Qcloud COS
 * for storing non-critical, reproducible data a low-cost highly available,
 * but less redundant, storage option.
 * 
 */
public enum StorageClass {

    /**
     * The default COS class. This storage class
     * is recommended for critical, non-reproducible data.  The standard
     * storage class is a highly available and highly redundant storage option
     * provided for an affordable price.
     */
    Standard("Standard"),

    /**
     * STANDARD_IA
     */
    Standard_IA("Standard_IA"),

    /**
     * The Qcloud NEARLINE storage class.
     * This storage class means your object's data is stored in Qcloud NEARLINE,
     * and Qcloud COS stores a reference to the data in the NEARLINE COS bucket.
     */
    NearLine("Nearline");

    /**
     * Returns the Qcloud COS {@link StorageClass} enumeration value representing the
     * specified Qcloud COS StorageClass ID string.
     * If the specified string doesn't map to a known Qcloud COS storage class,
     * an IllegalArgumentException is thrown.
     *
     * @param Cos StorageClassString
     *            The Qcloud COS storage class ID string.
     *
     * @return The Qcloud COS StorageClass enumeration value representing the
     *         specified Qcloud COS storage class ID.
     *
     * @throws IllegalArgumentException
     *             If the specified value does not map to one of the known
     *             Qcloud COS storage classes.
     */
    public static StorageClass fromValue(String cosStorageClassString) throws IllegalArgumentException {
        for (StorageClass storageClass : StorageClass.values()) {
            if (storageClass.toString().equals(cosStorageClassString)) return storageClass;
        }

        throw new IllegalArgumentException(
                "Cannot create enum from " + cosStorageClassString + " value!");
    }

    private final String storageClassId;

    private StorageClass(String id) {
        this.storageClassId = id;
    }

    /* (non-Javadoc)
     * @see java.lang.Enum#toString()
     */
    @Override
    public String toString() {
        return storageClassId;
    }

}