python-keystoneclient/keystoneclient/v3/ec2.py

99 lines
3.7 KiB
Python

# 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 keystoneclient import base
class EC2(base.Resource):
"""Represents an EC2 resource.
Attributes:
* id: a string that identifies the EC2 resource.
* user_id: the ID field of a pre-existing user in the backend.
* project_id: the ID field of a pre-existing project in the backend.
* access: a string representing access key of the access/secret pair.
* secret: a string representing the secret of the access/secret pair.
"""
def __repr__(self):
"""Return string representation of EC2 resource information."""
return "<EC2 %s>" % self._info
class EC2Manager(base.ManagerWithFind):
resource_class = EC2
def create(self, user_id, project_id):
"""Create a new access/secret pair.
:param user_id: the ID of the user having access/secret pair.
:type user_id: str or :class:`keystoneclient.v3.users.User`
:param project_id: the ID of the project having access/secret pair.
:type project_id: str or :class:`keystoneclient.v3.projects.Project`
:returns: the created access/secret pair returned from server.
:rtype: :class:`keystoneclient.v3.ec2.EC2`
"""
# NOTE(jamielennox): Yes, this uses tenant_id as a key even though we
# are in the v3 API.
return self._post('/users/%s/credentials/OS-EC2' % user_id,
body={'tenant_id': project_id},
response_key="credential")
def get(self, user_id, access):
"""Retrieve an access/secret pair for a given access key.
:param user_id: the ID of the user whose access/secret pair will be
retrieved from the server.
:type user_id: str or :class:`keystoneclient.v3.users.User`
:param str access: the access key whose access/secret pair will be
retrieved from the server.
:returns: the specified access/secret pair returned from server.
:rtype: :class:`keystoneclient.v3.ec2.EC2`
"""
url = "/users/%s/credentials/OS-EC2/%s" % (user_id, base.getid(access))
return self._get(url, response_key="credential")
def list(self, user_id):
"""List access/secret pairs for a given user.
:param str user_id: the ID of the user having access/secret pairs will
be listed.
:returns: a list of access/secret pairs.
:rtype: list of :class:`keystoneclient.v3.ec2.EC2`
"""
return self._list("/users/%s/credentials/OS-EC2" % user_id,
response_key="credentials")
def delete(self, user_id, access):
"""Delete an access/secret pair.
:param user_id: the ID of the user whose access/secret pair will be
deleted on the server.
:type user_id: str or :class:`keystoneclient.v3.users.User`
:param str access: the access key whose access/secret pair will be
deleted on the server.
:returns: Response object with 204 status.
:rtype: :class:`requests.models.Response`
"""
return self._delete("/users/%s/credentials/OS-EC2/%s" %
(user_id, base.getid(access)))