# Copyright 2011 OpenStack Foundation # Copyright 2013 Rackspace Hosting # All Rights Reserved. # # 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. import json from troveclient import base from troveclient import common from troveclient.v1 import clusters from troveclient.v1 import configurations from troveclient.v1 import datastores from troveclient.v1 import flavors from troveclient.v1 import instances class RootHistory(base.Resource): def __repr__(self): return ("" % (self.id, self.created, self.user)) class Management(base.ManagerWithFind): """Manage :class:`Instances` resources.""" resource_class = instances.Instance def show(self, instance): """Get details of one instance. :rtype: :class:`Instance`. """ return self._get("/mgmt/instances/%s" % base.getid(instance), 'instance') def index(self, **kwargs): """A wrapper for list method.""" return self.list(**kwargs) def list(self, limit=None, marker=None, deleted=False, **kwargs): """Get all the database instances.""" url = "/mgmt/instances" kwargs["deleted"] = deleted return self._paginated(url, "instances", limit, marker, query_strings=kwargs) def root_enabled_history(self, instance): """Get root access history of one instance.""" url = "/mgmt/instances/%s/root" % base.getid(instance) resp, body = self.api.client.get(url) if not body: raise Exception("Call to " + url + " did not return a body.") return RootHistory(self, body['root_history']) def _action(self, instance_id, body): """Perform a server "action" -- reboot/rebuild/resize/etc.""" url = "/mgmt/instances/%s/action" % instance_id resp, body = self.api.client.post(url, body=body) common.check_for_exceptions(resp, body, url) def stop(self, instance_id): body = {'stop': {}} self._action(instance_id, body) def reboot(self, instance_id): """Reboot the underlying OS. :param instance_id: The :class:`Instance` (or its ID) to share onto. """ body = {'reboot': {}} self._action(instance_id, body) def migrate(self, instance_id, host=None): """Migrate the instance. :param instance_id: The :class:`Instance` (or its ID) to share onto. """ if host: body = {'migrate': {'host': host}} else: body = {'migrate': {}} self._action(instance_id, body) def update(self, instance_id): """Update the guest agent via apt-get.""" body = {'update': {}} self._action(instance_id, body) def reset_task_status(self, instance_id): """Set the task status to NONE.""" body = {'reset-task-status': {}} self._action(instance_id, body) class MgmtClusters(base.ManagerWithFind): """Manage :class:`Cluster` resources.""" resource_class = clusters.Cluster # Appease the abc gods def list(self): pass def show(self, cluster): """Get details of one cluster.""" return self._get("/mgmt/clusters/%s" % base.getid(cluster), 'cluster') def index(self, deleted=None, limit=None, marker=None): """Show an overview of all local clusters. Optionally, filter by deleted status. :rtype: list of :class:`Cluster`. """ form = '' if deleted is not None: if deleted: form = "?deleted=true" else: form = "?deleted=false" url = "/mgmt/clusters%s" % form return self._paginated(url, "clusters", limit, marker) def _action(self, cluster_id, body): """Perform a cluster action, e.g. reset-task.""" url = "/mgmt/clusters/%s/action" % cluster_id resp, body = self.api.client.post(url, body=body) common.check_for_exceptions(resp, body, url) def reset_task(self, cluster_id): """Reset the current cluster task to NONE.""" body = {'reset-task': {}} self._action(cluster_id, body) class MgmtFlavors(base.ManagerWithFind): """Manage :class:`Flavor` resources.""" resource_class = flavors.Flavor def __repr__(self): return "" % id(self) # Appease the abc gods def list(self): pass def create(self, name, ram, disk, vcpus, flavorid="auto", ephemeral=None, swap=None, rxtx_factor=None, service_type=None): """Create a new flavor.""" body = {"flavor": { "flavor_id": flavorid, "name": name, "ram": ram, "disk": disk, "vcpu": vcpus, "ephemeral": 0, "swap": 0, "rxtx_factor": "1.0", "is_public": "True" }} if ephemeral: body["flavor"]["ephemeral"] = ephemeral if swap: body["flavor"]["swap"] = swap if rxtx_factor: body["flavor"]["rxtx_factor"] = rxtx_factor if service_type: body["flavor"]["service_type"] = service_type return self._create("/mgmt/flavors", body, "flavor") class MgmtConfigurationParameters(configurations.ConfigurationParameters): def create(self, version, name, restart_required, data_type, max_size=None, min_size=None): """Mgmt call to create a new configuration parameter.""" body = { "configuration-parameter": { "name": name, "restart_required": int(restart_required), "data_type": data_type, } } if max_size is not None: body["configuration-parameter"]["max_size"] = max_size if min_size is not None: body["configuration-parameter"]["min_size"] = min_size url = "/mgmt/datastores/versions/%s/parameters" % version resp, body = self.api.client.post(url, body=body) common.check_for_exceptions(resp, body, url) def list_all_parameter_by_version(self, version): """List all configuration parameters deleted or not.""" return self._list("/mgmt/datastores/versions/%s/parameters" % version, "configuration-parameters") def get_any_parameter_by_version(self, version, key): """Get any configuration parameter deleted or not.""" return self._get("/mgmt/datastores/versions/%s/parameters/%s" % (version, key)) def modify(self, version, name, restart_required, data_type, max_size=None, min_size=None): """Mgmt call to modify an existing configuration parameter.""" body = { "configuration-parameter": { "name": name, "restart_required": int(restart_required), "data_type": data_type, } } if max_size is not None: body["configuration-parameter"]["max_size"] = max_size if min_size is not None: body["configuration-parameter"]["min_size"] = min_size output = { 'version': version, 'parameter_name': name } url = ("/mgmt/datastores/versions/%(version)s/" "parameters/%(parameter_name)s" % output) resp, body = self.api.client.put(url, body=body) common.check_for_exceptions(resp, body, url) def delete(self, version, name): """Mgmt call to delete a configuration parameter.""" output = { 'version_id': version, 'parameter_name': name } url = ("/mgmt/datastores/versions/%(version_id)s/" "parameters/%(parameter_name)s" % output) resp, body = self.api.client.delete(url) common.check_for_exceptions(resp, body, url) class MgmtDatastoreVersions(base.ManagerWithFind): """Manage :class:`DatastoreVersion` resources.""" resource_class = datastores.DatastoreVersion def list(self, limit=None, marker=None): """List all datastore versions.""" return self._paginated("/mgmt/datastore-versions", "versions", limit, marker) def get(self, datastore_version_id): """Get details of a datastore version.""" return self._get("/mgmt/datastore-versions/%s" % datastore_version_id, "version") def create(self, name, datastore_name, datastore_manager, image, packages=None, active='true', default='false'): packages = packages or [] """Create a new datastore version.""" body = {"version": { "name": name, "datastore_name": datastore_name, "datastore_manager": datastore_manager, "image": image, "packages": packages, "active": json.loads(active), "default": json.loads(default) }} return self._create("/mgmt/datastore-versions", body, None, True) def edit(self, datastore_version_id, datastore_manager=None, image=None, packages=None, active=None, default=None): packages = packages or [] """Update a datastore-version.""" body = {} if datastore_manager is not None: body['datastore_manager'] = datastore_manager if image: body['image'] = image if packages: body['packages'] = packages if active is not None: body['active'] = json.loads(active) if default is not None: body['default'] = json.loads(default) url = ("/mgmt/datastore-versions/%s" % datastore_version_id) resp, body = self.api.client.patch(url, body=body) common.check_for_exceptions(resp, body, url) def delete(self, datastore_version_id): """Delete a datastore version.""" url = ("/mgmt/datastore-versions/%s" % datastore_version_id) resp, body = self.api.client.delete(url) common.check_for_exceptions(resp, body, url)