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
|
# 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.
from positional import positional
from keystoneclient import base
from keystoneclient import exceptions
from keystoneclient.i18n import _
VALID_INTERFACES = ['public', 'admin', 'internal']
class Endpoint(base.Resource):
"""Represents an Identity endpoint.
Attributes:
* id: a uuid that identifies the endpoint
* interface: 'public', 'admin' or 'internal' network interface
* region: geographic location of the endpoint
* service_id: service to which the endpoint belongs
* url: fully qualified service endpoint
* enabled: determines whether the endpoint appears in the catalog
"""
pass
class EndpointManager(base.CrudManager):
"""Manager class for manipulating Identity endpoints."""
resource_class = Endpoint
collection_key = 'endpoints'
key = 'endpoint'
def _validate_interface(self, interface):
if interface is not None and interface not in VALID_INTERFACES:
msg = _('"interface" must be one of: %s')
msg = msg % ', '.join(VALID_INTERFACES)
raise exceptions.ValidationError(msg)
@positional(1, enforcement=positional.WARN)
def create(self, service, url, interface=None, region=None, enabled=True,
**kwargs):
self._validate_interface(interface)
return super(EndpointManager, self).create(
service_id=base.getid(service),
interface=interface,
url=url,
region=region,
enabled=enabled,
**kwargs)
def get(self, endpoint):
return super(EndpointManager, self).get(
endpoint_id=base.getid(endpoint))
@positional(enforcement=positional.WARN)
def list(self, service=None, interface=None, region=None, enabled=None,
region_id=None, **kwargs):
"""List endpoints.
If ``**kwargs`` are provided, then filter endpoints with
attributes matching ``**kwargs``.
"""
# NOTE(lhcheng): region filter is not supported by keystone,
# region_id should be used instead. Consider removing the
# region argument in the next release.
self._validate_interface(interface)
return super(EndpointManager, self).list(
service_id=base.getid(service),
interface=interface,
region_id=region_id or base.getid(region),
enabled=enabled,
**kwargs)
@positional(enforcement=positional.WARN)
def update(self, endpoint, service=None, url=None, interface=None,
region=None, enabled=None, **kwargs):
self._validate_interface(interface)
return super(EndpointManager, self).update(
endpoint_id=base.getid(endpoint),
service_id=base.getid(service),
interface=interface,
url=url,
region=region,
enabled=enabled,
**kwargs)
def delete(self, endpoint):
return super(EndpointManager, self).delete(
endpoint_id=base.getid(endpoint))
|
