com.huawei.openstack4j.api.magnum.MagnumService Maven / Gradle / Ivy
/*******************************************************************************
* 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.magnum;
import java.util.List;
import com.huawei.openstack4j.common.RestService;
import com.huawei.openstack4j.model.common.ActionResponse;
import com.huawei.openstack4j.model.magnum.Bay;
import com.huawei.openstack4j.model.magnum.Baymodel;
import com.huawei.openstack4j.model.magnum.Carequest;
import com.huawei.openstack4j.model.magnum.Certificate;
import com.huawei.openstack4j.model.magnum.Cluster;
import com.huawei.openstack4j.model.magnum.Clustertemplate;
import com.huawei.openstack4j.model.magnum.Container;
import com.huawei.openstack4j.model.magnum.Mservice;
import com.huawei.openstack4j.model.magnum.Pod;
/**
* OpenStack Container Infrastructure Management service (Magnum) APIs
*
* @author Sohan Sangwan
*
*/
public interface MagnumService extends RestService {
/**
* Lists all Magnum Services: container infrastructure service status
* details
*
* @return list of Magnum Services
*/
List listMservices();
/**
* Lists all Baymodels
*
* @return list of Baymodels
*/
List listBaymodels();
/**
* Creates a new baymodel
*
* @param baymodel
* @return
*/
Baymodel createBaymodel(Baymodel baymodel);
/**
* Deletes a baymodel
*
* @param id
* @return
*/
ActionResponse deleteBaymodel(String id);
/**
* Gets all information of a baymodel
*
* @param id
*
* @return baymodel information
*/
Baymodel showBaymodel(String id);
/**
* Updates baymodel attributes
*
* @param id
* @param operations
*
* @return updated baymodel
*/
Baymodel updateBaymodel(String id, String operations);
/**
* Lists all Bays/clusters
*
* @return list of Bays
*/
List listBays();
/**
* Creates a new bay
*
* @param bay
* @return newly created bay
*/
Bay createBay(Bay bay);
/**
* Deletes a bay
*
* @param id
* @return
*/
ActionResponse deleteBay(String id);
/**
* Show a bay
*
* @param id
* @return bay
*/
Bay showBay(String id);
/**
* Update bay
*
* @param id
* @param operations
* @return
*/
Bay updateBay(String id, String operations);
// Containers
/**
* Lists all Containers
*
* @return list of Containers
*/
List listContainers();
/**
* Creates a new Container
*
* @param baymodel
* @return newly created Container
*/
Container createContainer(Container container);
/**
* Deletes a Container
*
* @param id
* @return success/failure response
*/
ActionResponse deleteContainer(String uuid);
/**
* Execute command in a Container
*
* @param id
* @param cmd
* @return output of the command
*/
String execCmdInContainer(String id, String cmd);
/**
* Get logs of a Container
*
* @param id
* @return logs
*/
String getContainerLogs(String id);
/**
* Pause a Container
*
* @param id
* @return paused Container
*/
Container pauseContainer(String id);
/**
* Unpause a Container
*
* @param id
* @return paused Container
*/
Container unpauseContainer(String id);
/**
* Reboot a Container
*
* @param id
* @return rebooted Container
*/
Container rebootContainer(String id);
/**
* Start a Container
*
* @param id
* @return Container
*/
Container startContainer(String id);
/**
* Stop a Container
*
* @param id
* @return Container
*/
Container stopContainer(String id);
/**
* Show a Container
*
* @param id
* @return Container
*/
Container showContainer(String id);
/**
* Update a container
*
* @param id
* @param operations
* @return
*/
Container updateContainer(String id, String operations);
/**
* Gets certificate
*
* @param uuid of a bay or cluster
* @return certificate
*/
Certificate getCertificate(String uuid);
/**
* Generates certificate
*
* @param ca request
* @return certificate
*/
Certificate signCertificate(Carequest ca);
/**
* Rotate the CA certificate for a bay/cluster and
* invalidate all user certificates.
*
* @param uuid of a bay or cluster
* @return status
*/
ActionResponse rotateCertificate(String uuid);
//New clusters APIs
/**
* Create new cluster based on cluster template
*
* @param cluster
* @return
*/
Cluster createCluster(Cluster cluster);
/**
* List all clusters
*
* @return
*/
List listClusters();
/**
* Get all information of a cluster in Magnum
*
* @param id of the cluster
* @return cluster
*/
Cluster showCluster(String id);
/**
* Delete a cluster.
*
* @param id of the cluster
* @return success status
*/
ActionResponse deleteCluster(String id);
/**
* Update information of one cluster attributes using operations
* including: ``add``, ``replace`` or ``remove``.
* The attributes to ``add`` and
* ``replace`` in the form of ``key=value`` while ``remove`` only needs the keys.
*
* @param id
* @param operations
* @return updated cluster
*/
Cluster updateCluster(String id, String operations);
//Cluster templates
/**
* Create new cluster template
* @param template
* @return newly created cluster template
*/
Clustertemplate createClustertemplate(Clustertemplate template);
/**
* List all cluster templates
*
* @return list of cluster templates
*/
List listClustertemplate();
/**
* Delete a cluster template
*
* @param id of the clustertemplate
* @return status
*/
ActionResponse deleteClustertemplate(String id);
/**
* Update information of one cluster template attributes using operations
* including: ``add``, ``replace`` or ``remove``. The attributes to ``add`` and
* ``replace`` in the form of ``key=value`` while ``remove`` only needs the keys.
*
* @param cluster template
*
* @return updated clustser template
*/
Clustertemplate updateClustertemplate(String id, String operations);
// Pod (group of containers) APIs
/**
* List all pods
*
* @return list of pods
*/
List listPods(String bayUuid);
/**
* Create a pod
*
* @param pod
* @return pod
*/
Pod createPod(Pod pod);
/**
* Delete a pod
*
* @param bayUuid
* @param id
* @return status
*/
ActionResponse deletePod(String bayUuid, String id);
/**
* Show a pod
*
* @param bayUuid
* @param id
* @return pod
*/
Pod showPod(String bayUuid, String id);
/**
* Update a pod
*
* @param bayUuid
* @param id
* @return pod
*/
Pod updatePod(String bayUuid, String id, String operations);
}