mirror of https://github.com/apache/cloudstack.git
115 lines
4.3 KiB
Java
115 lines
4.3 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.network.element;
|
|
|
|
import java.util.Map;
|
|
|
|
import com.cloud.deploy.DeployDestination;
|
|
import com.cloud.exception.ConcurrentOperationException;
|
|
import com.cloud.exception.InsufficientCapacityException;
|
|
import com.cloud.exception.InsufficientNetworkCapacityException;
|
|
import com.cloud.exception.ResourceUnavailableException;
|
|
import com.cloud.network.Network;
|
|
import com.cloud.network.Network.Capability;
|
|
import com.cloud.network.Network.Provider;
|
|
import com.cloud.network.Network.Service;
|
|
import com.cloud.offering.NetworkOffering;
|
|
import com.cloud.utils.component.Adapter;
|
|
import com.cloud.vm.NicProfile;
|
|
import com.cloud.vm.ReservationContext;
|
|
import com.cloud.vm.VirtualMachine;
|
|
import com.cloud.vm.VirtualMachineProfile;
|
|
|
|
/**
|
|
* Represents one network element that exists in a network.
|
|
*/
|
|
public interface NetworkElement extends Adapter {
|
|
|
|
Map<Service, Map<Capability, String>> getCapabilities();
|
|
|
|
Provider getProvider();
|
|
|
|
/**
|
|
* Implement the network configuration as specified.
|
|
* @param config fully specified network configuration.
|
|
* @param offering network offering that originated the network configuration.
|
|
* @return true if network configuration is now usable; false if not; null if not handled by this element.
|
|
* @throws InsufficientNetworkCapacityException TODO
|
|
*/
|
|
boolean implement(Network network, NetworkOffering offering, DeployDestination dest, ReservationContext context) throws ConcurrentOperationException, ResourceUnavailableException, InsufficientCapacityException;
|
|
|
|
/**
|
|
* Prepare for a nic to be added into this network.
|
|
* @param network
|
|
* @param nic
|
|
* @param vm
|
|
* @param dest
|
|
* @param context
|
|
* @return
|
|
* @throws ConcurrentOperationException
|
|
* @throws ResourceUnavailableException
|
|
* @throws InsufficientNetworkCapacityException
|
|
*/
|
|
boolean prepare(Network network, NicProfile nic, VirtualMachineProfile<? extends VirtualMachine> vm, DeployDestination dest, ReservationContext context) throws ConcurrentOperationException, ResourceUnavailableException, InsufficientCapacityException;
|
|
|
|
/**
|
|
* A nic is released from this network.
|
|
* @param network
|
|
* @param nic
|
|
* @param vm
|
|
* @param context
|
|
* @return
|
|
* @throws ConcurrentOperationException
|
|
* @throws ResourceUnavailableException
|
|
*/
|
|
boolean release(Network network, NicProfile nic, VirtualMachineProfile<? extends VirtualMachine> vm, ReservationContext context) throws ConcurrentOperationException, ResourceUnavailableException;
|
|
|
|
/**
|
|
* The network is being shutdown.
|
|
* @param network
|
|
* @param context
|
|
* @return
|
|
* @throws ConcurrentOperationException
|
|
* @throws ResourceUnavailableException
|
|
*/
|
|
boolean shutdown(Network network, ReservationContext context) throws ConcurrentOperationException, ResourceUnavailableException;
|
|
|
|
/**
|
|
* The network is being restarted.
|
|
* @param network
|
|
* @param context
|
|
* @param cleanup If need to clean up old network elements
|
|
* @return
|
|
* @throws ConcurrentOperationException
|
|
* @throws ResourceUnavailableException
|
|
*/
|
|
boolean restart(Network network, ReservationContext context, boolean cleanup) throws ConcurrentOperationException, ResourceUnavailableException, InsufficientCapacityException;
|
|
|
|
/**
|
|
* The network is being destroyed.
|
|
* @param network
|
|
* @return
|
|
* @throws ConcurrentOperationException
|
|
*/
|
|
boolean destroy(Network network) throws ConcurrentOperationException, ResourceUnavailableException;
|
|
}
|