mirror of
https://github.com/apache/cloudstack.git
synced 2025-10-26 08:42:29 +01:00
111 lines
4.1 KiB
Java
111 lines
4.1 KiB
Java
/**
|
|
* Copyright (C) 2010 Cloud.com, Inc. All rights reserved.
|
|
*
|
|
* This software is licensed under the GNU General Public License v3 or later.
|
|
*
|
|
* It is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or any later version.
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
*/
|
|
package com.cloud.storage;
|
|
|
|
import java.net.UnknownHostException;
|
|
import java.util.List;
|
|
|
|
import com.cloud.api.commands.CancelPrimaryStorageMaintenanceCmd;
|
|
import com.cloud.api.commands.CreateStoragePoolCmd;
|
|
import com.cloud.api.commands.CreateVolumeCmd;
|
|
import com.cloud.api.commands.DeletePoolCmd;
|
|
import com.cloud.api.commands.PreparePrimaryStorageForMaintenanceCmd;
|
|
import com.cloud.api.commands.UpdateStoragePoolCmd;
|
|
import com.cloud.exception.ConcurrentOperationException;
|
|
import com.cloud.exception.InsufficientCapacityException;
|
|
import com.cloud.exception.PermissionDeniedException;
|
|
import com.cloud.exception.ResourceAllocationException;
|
|
import com.cloud.exception.ResourceInUseException;
|
|
import com.cloud.exception.ResourceUnavailableException;
|
|
|
|
public interface StorageService {
|
|
/**
|
|
* Create StoragePool based on uri
|
|
*
|
|
* @param cmd
|
|
* the command object that specifies the zone, cluster/pod, URI, details, etc. to use to create the storage pool.
|
|
* @return
|
|
* @throws ResourceInUseException
|
|
* @throws IllegalArgumentException
|
|
* @throws UnknownHostException
|
|
* @throws ResourceUnavailableException
|
|
* TODO
|
|
*/
|
|
StoragePool createPool(CreateStoragePoolCmd cmd) throws ResourceInUseException, IllegalArgumentException, UnknownHostException, ResourceUnavailableException;
|
|
|
|
/**
|
|
* Creates the database object for a volume based on the given criteria
|
|
*
|
|
* @param cmd
|
|
* the API command wrapping the criteria (account/domainId [admin only], zone, diskOffering, snapshot, name)
|
|
* @return the volume object
|
|
* @throws PermissionDeniedException
|
|
*/
|
|
Volume allocVolume(CreateVolumeCmd cmd) throws ResourceAllocationException;
|
|
|
|
/**
|
|
* Creates the volume based on the given criteria
|
|
*
|
|
* @param cmd
|
|
* the API command wrapping the criteria (account/domainId [admin only], zone, diskOffering, snapshot, name)
|
|
* @return the volume object
|
|
*/
|
|
Volume createVolume(CreateVolumeCmd cmd);
|
|
|
|
boolean deleteVolume(long volumeId) throws ConcurrentOperationException;
|
|
|
|
/**
|
|
* Delete the storage pool
|
|
*
|
|
* @param cmd
|
|
* - the command specifying poolId
|
|
* @return success or failure
|
|
*/
|
|
boolean deletePool(DeletePoolCmd cmd);
|
|
|
|
/**
|
|
* Enable maintenance for primary storage
|
|
*
|
|
* @param cmd
|
|
* - the command specifying primaryStorageId
|
|
* @return the primary storage pool
|
|
* @throws ResourceUnavailableException
|
|
* TODO
|
|
* @throws InsufficientCapacityException
|
|
* TODO
|
|
*/
|
|
public StoragePool preparePrimaryStorageForMaintenance(Long primaryStorageId) throws ResourceUnavailableException, InsufficientCapacityException;
|
|
|
|
/**
|
|
* Complete maintenance for primary storage
|
|
*
|
|
* @param cmd
|
|
* - the command specifying primaryStorageId
|
|
* @return the primary storage pool
|
|
* @throws ResourceUnavailableException
|
|
* TODO
|
|
*/
|
|
public StoragePool cancelPrimaryStorageForMaintenance(CancelPrimaryStorageMaintenanceCmd cmd) throws ResourceUnavailableException;
|
|
|
|
public StoragePool updateStoragePool(UpdateStoragePoolCmd cmd) throws IllegalArgumentException;
|
|
|
|
public StoragePool getStoragePool(long id);
|
|
|
|
Volume migrateVolume(Long volumeId, Long storagePoolId) throws ConcurrentOperationException;
|
|
}
|