python-novaclient/novaclient/v2/server_groups.py

99 lines
3.2 KiB
Python

# Copyright (c) 2014 VMware, Inc.
# 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.
"""
Server group interface.
"""
from six.moves.urllib import parse
from novaclient import base
class ServerGroup(base.Resource):
"""
A server group.
"""
def __repr__(self):
return '<ServerGroup: %s>' % self.id
def delete(self):
"""
Delete this server group.
:returns: An instance of novaclient.base.TupleWithMeta
"""
return self.manager.delete(self.id)
class ServerGroupsManager(base.ManagerWithFind):
"""
Manage :class:`ServerGroup` resources.
"""
resource_class = ServerGroup
def list(self, all_projects=False, limit=None, offset=None):
"""Get a list of all server groups.
:param all_projects: Lists server groups for all projects. (optional)
:param limit: Maximum number of server groups to return. (optional)
:param offset: Use with `limit` to return a slice of server
groups. `offset` is where to start in the groups
list. (optional)
:returns: list of :class:`ServerGroup`.
"""
qparams = {}
if all_projects:
qparams['all_projects'] = bool(all_projects)
if limit:
qparams['limit'] = int(limit)
if offset:
qparams['offset'] = int(offset)
qparams = sorted(qparams.items(), key=lambda x: x[0])
query_string = "?%s" % parse.urlencode(qparams) if qparams else ""
return self._list('/os-server-groups%s' % query_string,
'server_groups')
def get(self, id):
"""Get a specific server group.
:param id: The ID of the :class:`ServerGroup` to get.
:rtype: :class:`ServerGroup`
"""
return self._get('/os-server-groups/%s' % id,
'server_group')
def delete(self, id):
"""Delete a specific server group.
:param id: The ID of the :class:`ServerGroup` to delete.
:returns: An instance of novaclient.base.TupleWithMeta
"""
return self._delete('/os-server-groups/%s' % id)
def create(self, name, policies):
"""Create (allocate) a server group.
:param name: The name of the server group.
:param policies: Policy name or a list of exactly one policy name to
associate with the server group.
:rtype: list of :class:`ServerGroup`
"""
policies = policies if isinstance(policies, list) else [policies]
body = {'server_group': {'name': name,
'policies': policies}}
return self._create('/os-server-groups', body, 'server_group')