1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
# 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 novaclient import api_versions
from novaclient import base
from novaclient import exceptions
from novaclient.i18n import _
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)
Note the API server has a configurable default limit.
If no limit is specified here or limit is larger than
default, the default limit will be used.
: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)
return self._list('/os-server-groups', 'server_groups',
filters=qparams)
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)
@api_versions.wraps("2.0", "2.63")
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')
@api_versions.wraps("2.64")
def create(self, name, policy, rules=None):
"""Create (allocate) a server group.
:param name: The name of the server group.
:param policy: Policy name to associate with the server group.
:param rules: The rules of policy which is a dict, can be applied to
the policy, now only ``max_server_per_host`` for ``anti-affinity``
policy would be supported (optional).
:rtype: list of :class:`ServerGroup`
"""
body = {'server_group': {
'name': name, 'policy': policy
}}
if rules:
key = 'max_server_per_host'
try:
if key in rules:
rules[key] = int(rules[key])
except ValueError:
msg = _("Invalid '%(key)s' value: %(value)s")
raise exceptions.CommandError(msg % {
'key': key, 'value': rules[key]})
body['server_group']['rules'] = rules
return self._create('/os-server-groups', body, 'server_group')
|
