com.huawei.openstack4j.api.compute.HostAggregateService Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of openstack4j Show documentation
Huawei Cloud Open API SDK for Java
There is a newer version: 1.0.26
/*******************************************************************************
 * 	Copyright 2016 ContainX and OpenStack4j                                          
 * 	                                                                                 
 * 	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.                                                                     
 *******************************************************************************/
package com.huawei.openstack4j.api.compute;

import java.util.List;
import java.util.Map;

import com.huawei.openstack4j.common.RestService;
import com.huawei.openstack4j.model.common.ActionResponse;
import com.huawei.openstack4j.model.compute.HostAggregate;
/**
 * Host aggregate Operations API
 * 
 * @author liujunpeng
 */
public interface HostAggregateService extends RestService {

    /**
     * List all aggregates (detailed) that the current tenant has access to
     *
     * @return list of all aggregates
     */
    List list();

    /**
     * Returns list of Aggregates filtered by parameters.
     * 
     * @param filteringParams map (name, value) of filtering parameters
     * @return 
     */
    List list(Map filteringParams);


    /**
     * Get the specified HostAggregate by ID
     *
     * @param hostAggregateId the aggregate identifier
     * @return the Aggregate or null if not found
     */
    HostAggregate get(String aggregateId);

	/**
	 * Delete of the aggregate
	 * 
	 * @param aggregateId  the aggregate identifier
	 * @return the action response
	 */
	ActionResponse delete(String aggregateId);

	/**
	 * Create a hostAggregate
	 * @param name
	 * @param availabilityZone
	 * @return HostAggregate
	 */
	HostAggregate create(String name,String availabilityZone);
	
	/**
	 * Updates the name, and optionally the availability zone, for a specified aggregate.
	 * @param hostAggregateId the aggregate identifier
	 * @param name
	 * @param availabilityZone
	 * @return HostAggregate
	 */
	HostAggregate update(String hostAggregateId,String name,String availabilityZone);

	/**
	 * Sets metadata for an aggregate.
	 * @param hostAggregateId the aggregate identifier
	 * @param metadata
	 * @return HostAggregate
	 */
	HostAggregate setMetadata(String hostAggregateId,Map metadata);

	/**
	 * Add host to aggregate
	 * @param hostAggregateId The ID associated with an aggregate.
	 * @param host Host ID to add to an aggregate, which is a collection of multiple groups of hosts that share common resources like storage and network.
	 * @return HostAggregate
	 */
	HostAggregate addHost(String hostAggregateId,String host);
	
	/**
	 * remove host from aggregate
	 * @param hostAggregateId The ID associated with an aggregate.
	 * @param host Host ID to add to an aggregate, which is a collection of multiple groups of hosts that share common resources like storage and network.
	 * @return HostAggregate
	 */
	HostAggregate removeHost(String hostAggregateId,String host);
}