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
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
# Copyright 2011 OpenStack Foundation
# Copyright 2011 Nebula, 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.
import urllib
import six
from keystoneclient import base
class Tenant(base.Resource):
"""Represents a Keystone tenant
Attributes:
* id: a uuid that identifies the tenant
* name: tenant name
* description: tenant description
* enabled: boolean to indicate if tenant is enabled
"""
def __repr__(self):
return "<Tenant %s>" % self._info
def delete(self):
return self.manager.delete(self)
def update(self, name=None, description=None, enabled=None):
# Preserve the existing settings; keystone legacy resets these?
new_name = name if name else self.name
if description is not None:
new_description = description
else:
new_description = self.description
new_enabled = enabled if enabled is not None else self.enabled
try:
retval = self.manager.update(self.id, tenant_name=new_name,
description=new_description,
enabled=new_enabled)
self = retval
except Exception:
retval = None
return retval
def add_user(self, user, role):
return self.manager.api.roles.add_user_role(base.getid(user),
base.getid(role),
self.id)
def remove_user(self, user, role):
return self.manager.api.roles.remove_user_role(base.getid(user),
base.getid(role),
self.id)
def list_users(self):
return self.manager.list_users(self.id)
class TenantManager(base.ManagerWithFind):
"""Manager class for manipulating Keystone tenants."""
resource_class = Tenant
def get(self, tenant_id):
return self._get("/tenants/%s" % tenant_id, "tenant")
def create(self, tenant_name, description=None, enabled=True, **kwargs):
"""Create a new tenant."""
params = {"tenant": {"name": tenant_name,
"description": description,
"enabled": enabled}}
#Allow Extras Passthru and ensure we don't clobber primary arguments.
for k, v in six.iteritems(kwargs):
if k not in params['tenant']:
params['tenant'][k] = v
return self._create('/tenants', params, "tenant")
def list(self, limit=None, marker=None):
"""Get a list of tenants.
:param integer limit: maximum number to return. (optional)
:param string marker: use when specifying a limit and making
multiple calls for querying. (optional)
:rtype: list of :class:`Tenant`
"""
params = {}
if limit:
params['limit'] = limit
if marker:
params['marker'] = marker
query = ""
if params:
query = "?" + urllib.urlencode(params)
reset = 0
if self.api.management_url is None:
# special casing to allow tenant lists on the auth_url
# for unscoped tokens
reset = 1
self.api.management_url = self.api.auth_url
tenant_list = self._list("/tenants%s" % query, "tenants")
if reset:
self.api.management_url = None
return tenant_list
def update(self, tenant_id, tenant_name=None, description=None,
enabled=None, **kwargs):
"""Update a tenant with a new name and description."""
body = {"tenant": {'id': tenant_id}}
if tenant_name is not None:
body['tenant']['name'] = tenant_name
if enabled is not None:
body['tenant']['enabled'] = enabled
if description is not None:
body['tenant']['description'] = description
#Allow Extras Passthru and ensure we don't clobber primary arguments.
for k, v in six.iteritems(kwargs):
if k not in body['tenant']:
body['tenant'][k] = v
# Keystone's API uses a POST rather than a PUT here.
return self._create("/tenants/%s" % tenant_id, body, "tenant")
def delete(self, tenant):
"""Delete a tenant."""
return self._delete("/tenants/%s" % (base.getid(tenant)))
def list_users(self, tenant):
"""List users for a tenant."""
return self.api.users.list(base.getid(tenant))
def add_user(self, tenant, user, role):
"""Add a user to a tenant with the given role."""
return self.api.roles.add_user_role(base.getid(user),
base.getid(role),
base.getid(tenant))
def remove_user(self, tenant, user, role):
"""Remove the specified role from the user on the tenant."""
return self.api.roles.remove_user_role(base.getid(user),
base.getid(role),
base.getid(tenant))
|
