a425702689
23f13437dd deprecated the
purely volume or volume-snapshot related CLIs and python
API bindings during Kilo. python-cinderclient should be
used for the python API bindings now, and python-openstackclient
should be used for the CLI for those operations.
The alternate_service_type context manager is also removed
since it was only used for proxying through to the volume API
endpoint.
Since the proxy for creating volumes is removed, we have to
add python-cinderclient for testing the volume attachment
CLIs/APIs that are left intact.
Change-Id: I09a6501603667350f49b1b1fa130353a6d5272a2
102 lines
3.6 KiB
Python
102 lines
3.6 KiB
Python
# Copyright 2011 Denali Systems, 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.
|
|
|
|
"""
|
|
Volume interface (1.1 extension).
|
|
"""
|
|
|
|
from novaclient import base
|
|
|
|
|
|
class Volume(base.Resource):
|
|
"""
|
|
A volume is an extra block level storage to the OpenStack
|
|
instances.
|
|
"""
|
|
NAME_ATTR = 'display_name'
|
|
|
|
def __repr__(self):
|
|
return "<Volume: %s>" % self.id
|
|
|
|
|
|
class VolumeManager(base.Manager):
|
|
"""
|
|
Manage :class:`Volume` resources. This is really about volume attachments.
|
|
"""
|
|
resource_class = Volume
|
|
|
|
def create_server_volume(self, server_id, volume_id, device=None):
|
|
"""
|
|
Attach a volume identified by the volume ID to the given server ID
|
|
|
|
:param server_id: The ID of the server
|
|
:param volume_id: The ID of the volume to attach.
|
|
:param device: The device name (optional)
|
|
:rtype: :class:`Volume`
|
|
"""
|
|
body = {'volumeAttachment': {'volumeId': volume_id}}
|
|
if device is not None:
|
|
body['volumeAttachment']['device'] = device
|
|
return self._create("/servers/%s/os-volume_attachments" % server_id,
|
|
body, "volumeAttachment")
|
|
|
|
def update_server_volume(self, server_id, attachment_id, new_volume_id):
|
|
"""
|
|
Update the volume identified by the attachment ID, that is attached to
|
|
the given server ID
|
|
|
|
:param server_id: The ID of the server
|
|
:param attachment_id: The ID of the attachment
|
|
:param new_volume_id: The ID of the new volume to attach
|
|
:rtype: :class:`Volume`
|
|
"""
|
|
body = {'volumeAttachment': {'volumeId': new_volume_id}}
|
|
return self._update("/servers/%s/os-volume_attachments/%s" %
|
|
(server_id, attachment_id,),
|
|
body, "volumeAttachment")
|
|
|
|
def get_server_volume(self, server_id, attachment_id):
|
|
"""
|
|
Get the volume identified by the attachment ID, that is attached to
|
|
the given server ID
|
|
|
|
:param server_id: The ID of the server
|
|
:param attachment_id: The ID of the attachment
|
|
:rtype: :class:`Volume`
|
|
"""
|
|
return self._get("/servers/%s/os-volume_attachments/%s" % (server_id,
|
|
attachment_id,), "volumeAttachment")
|
|
|
|
def get_server_volumes(self, server_id):
|
|
"""
|
|
Get a list of all the attached volumes for the given server ID
|
|
|
|
:param server_id: The ID of the server
|
|
:rtype: list of :class:`Volume`
|
|
"""
|
|
return self._list("/servers/%s/os-volume_attachments" % server_id,
|
|
"volumeAttachments")
|
|
|
|
def delete_server_volume(self, server_id, attachment_id):
|
|
"""
|
|
Detach a volume identified by the attachment ID from the given server
|
|
|
|
:param server_id: The ID of the server
|
|
:param attachment_id: The ID of the attachment
|
|
:returns: An instance of novaclient.base.TupleWithMeta
|
|
"""
|
|
return self._delete("/servers/%s/os-volume_attachments/%s" %
|
|
(server_id, attachment_id,))
|