¡@

Home 

OpenStack Study: admin_actions.py

OpenStack Index

**** CubicPower OpenStack Study ****

# Copyright 2011 OpenStack Foundation

#

# 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 webob

from webob import exc

from nova.api.openstack import common

from nova.api.openstack import extensions

from nova.api.openstack import wsgi

from nova import compute

from nova.compute import vm_states

from nova import exception

from nova.openstack.common.gettextutils import _

from nova.openstack.common import log as logging

LOG = logging.getLogger(__name__)

ALIAS = "os-admin-actions"

# States usable in resetState action

state_map = dict(active=vm_states.ACTIVE, error=vm_states.ERROR)

**** CubicPower OpenStack Study ****

def authorize(context, action_name):

    action = 'v3:%s:%s' % (ALIAS, action_name)

    extensions.extension_authorizer('compute', action)(context)

**** CubicPower OpenStack Study ****

class AdminActionsController(wsgi.Controller):

**** CubicPower OpenStack Study ****

    def __init__(self, *args, **kwargs):

        super(AdminActionsController, self).__init__(*args, **kwargs)

        self.compute_api = compute.API()

    @extensions.expected_errors((404, 409))

    @wsgi.action('reset_network')

**** CubicPower OpenStack Study ****

    def _reset_network(self, req, id, body):

        """Permit admins to reset networking on a server."""

        context = req.environ['nova.context']

        authorize(context, 'reset_network')

        try:

            instance = common.get_instance(self.compute_api, context, id,

                                           want_objects=True)

            self.compute_api.reset_network(context, instance)

        except exception.InstanceIsLocked as e:

            raise exc.HTTPConflict(explanation=e.format_message())

        return webob.Response(status_int=202)

    @extensions.expected_errors((404, 409))

    @wsgi.action('inject_network_info')

**** CubicPower OpenStack Study ****

    def _inject_network_info(self, req, id, body):

        """Permit admins to inject network info into a server."""

        context = req.environ['nova.context']

        authorize(context, 'inject_network_info')

        try:

            instance = common.get_instance(self.compute_api, context, id,

                                           want_objects=True)

            self.compute_api.inject_network_info(context, instance)

        except exception.InstanceIsLocked as e:

            raise exc.HTTPConflict(explanation=e.format_message())

        return webob.Response(status_int=202)

    @extensions.expected_errors((400, 404))

    @wsgi.action('reset_state')

**** CubicPower OpenStack Study ****

    def _reset_state(self, req, id, body):

        """Permit admins to reset the state of a server."""

        context = req.environ["nova.context"]

        authorize(context, 'reset_state')

        # Identify the desired state from the body

        try:

            state = state_map[body["reset_state"]["state"]]

        except (TypeError, KeyError):

            msg = _("Desired state must be specified.  Valid states "

                    "are: %s") % ', '.join(sorted(state_map.keys()))

            raise exc.HTTPBadRequest(explanation=msg)

        instance = common.get_instance(self.compute_api, context, id,

                                       want_objects=True)

        instance.vm_state = state

        instance.task_state = None

        instance.save(admin_state_reset=True)

        return webob.Response(status_int=202)

**** CubicPower OpenStack Study ****

class AdminActions(extensions.V3APIExtensionBase):

"""Enable admin-only server actions

Actions include: pause, unpause, suspend, resume, migrate,

reset_network, inject_network_info, lock, unlock, create_backup

"""

name = "AdminActions"

alias = ALIAS

namespace = "http://docs.openstack.org/compute/ext/%s/api/v3" % ALIAS

version = 1

**** CubicPower OpenStack Study ****

    def get_controller_extensions(self):

        controller = AdminActionsController()

        extension = extensions.ControllerExtension(self, 'servers', controller)

        return [extension]

**** CubicPower OpenStack Study ****

    def get_resources(self):

        return []