# # 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. # # TODO(Huanxuan Ao): Remove this file and "snapshot create", "snapshot delete", # "snapshot set", "snapshot show" and "snapshot unset" # commands two cycles after Ocata. """Volume v2 snapshot action implementations""" import copy import logging from osc_lib.cli import parseractions from osc_lib.command import command from osc_lib import exceptions from osc_lib import utils import six from openstackclient.i18n import _ deprecated = True LOG_DEP = logging.getLogger('deprecated') LOG = logging.getLogger(__name__) class CreateSnapshot(command.ShowOne): _description = _("Create new snapshot") def get_parser(self, prog_name): parser = super(CreateSnapshot, self).get_parser(prog_name) parser.add_argument( "volume", metavar="", help=_("Volume to snapshot (name or ID)") ) parser.add_argument( "--name", metavar="", help=_("Name of the snapshot") ) parser.add_argument( "--description", metavar="", help=_("Description of the snapshot") ) parser.add_argument( "--force", action="store_true", default=False, help=_("Create a snapshot attached to an instance. " "Default is False") ) parser.add_argument( "--property", metavar="", action=parseractions.KeyValueAction, help=_("Set a property to this snapshot " "(repeat option to set multiple properties)"), ) return parser def take_action(self, parsed_args): LOG_DEP.warning(_('This command has been deprecated. ' 'Please use "volume snapshot create" instead.')) volume_client = self.app.client_manager.volume volume_id = utils.find_resource( volume_client.volumes, parsed_args.volume).id snapshot = volume_client.volume_snapshots.create( volume_id, force=parsed_args.force, name=parsed_args.name, description=parsed_args.description, metadata=parsed_args.property, ) snapshot._info.update( {'properties': utils.format_dict(snapshot._info.pop('metadata'))} ) return zip(*sorted(six.iteritems(snapshot._info))) class DeleteSnapshot(command.Command): _description = _("Delete volume snapshot(s)") def get_parser(self, prog_name): parser = super(DeleteSnapshot, self).get_parser(prog_name) parser.add_argument( "snapshots", metavar="", nargs="+", help=_("Snapshot(s) to delete (name or ID)") ) return parser def take_action(self, parsed_args): LOG_DEP.warning(_('This command has been deprecated. ' 'Please use "volume snapshot delete" instead.')) volume_client = self.app.client_manager.volume result = 0 for i in parsed_args.snapshots: try: snapshot_id = utils.find_resource( volume_client.volume_snapshots, i).id volume_client.volume_snapshots.delete(snapshot_id) except Exception as e: result += 1 LOG.error(_("Failed to delete snapshot with " "name or ID '%(snapshot)s': %(e)s") % {'snapshot': i, 'e': e}) if result > 0: total = len(parsed_args.snapshots) msg = (_("%(result)s of %(total)s snapshots failed " "to delete.") % {'result': result, 'total': total}) raise exceptions.CommandError(msg) class ListSnapshot(command.Lister): _description = _("List snapshots") def get_parser(self, prog_name): parser = super(ListSnapshot, self).get_parser(prog_name) parser.add_argument( '--all-projects', action='store_true', default=False, help=_('Include all projects (admin only)'), ) parser.add_argument( '--long', action='store_true', default=False, help=_('List additional fields in output'), ) parser.add_argument( '--marker', metavar='', help=_('The last snapshot ID of the previous page'), ) parser.add_argument( '--limit', type=int, action=parseractions.NonNegativeAction, metavar='', help=_('Maximum number of snapshots to display'), ) return parser def take_action(self, parsed_args): LOG_DEP.warning(_('This command has been deprecated. ' 'Please use "volume snapshot list" instead.')) def _format_volume_id(volume_id): """Return a volume name if available :param volume_id: a volume ID :rtype: either the volume ID or name """ volume = volume_id if volume_id in volume_cache.keys(): volume = volume_cache[volume_id].name return volume if parsed_args.long: columns = ['ID', 'Name', 'Description', 'Status', 'Size', 'Created At', 'Volume ID', 'Metadata'] column_headers = copy.deepcopy(columns) column_headers[6] = 'Volume' column_headers[7] = 'Properties' else: columns = ['ID', 'Name', 'Description', 'Status', 'Size'] column_headers = copy.deepcopy(columns) # Cache the volume list volume_cache = {} try: for s in self.app.client_manager.volume.volumes.list(): volume_cache[s.id] = s except Exception: # Just forget it if there's any trouble pass search_opts = { 'all_tenants': parsed_args.all_projects, } data = self.app.client_manager.volume.volume_snapshots.list( search_opts=search_opts, marker=parsed_args.marker, limit=parsed_args.limit, ) return (column_headers, (utils.get_item_properties( s, columns, formatters={'Metadata': utils.format_dict, 'Volume ID': _format_volume_id}, ) for s in data)) class SetSnapshot(command.Command): _description = _("Set snapshot properties") def get_parser(self, prog_name): parser = super(SetSnapshot, self).get_parser(prog_name) parser.add_argument( 'snapshot', metavar='', help=_('Snapshot to modify (name or ID)') ) parser.add_argument( '--name', metavar='', help=_('New snapshot name') ) parser.add_argument( '--description', metavar='', help=_('New snapshot description') ) parser.add_argument( '--property', metavar='', action=parseractions.KeyValueAction, help=_('Property to add/change for this snapshot ' '(repeat option to set multiple properties)'), ) parser.add_argument( '--state', metavar='', choices=['available', 'error', 'creating', 'deleting', 'error-deleting'], help=_('New snapshot state. ("available", "error", "creating", ' '"deleting", or "error_deleting") (admin only) ' '(This option simply changes the state of the snapshot ' 'in the database with no regard to actual status, ' 'exercise caution when using)'), ) return parser def take_action(self, parsed_args): LOG_DEP.warning(_('This command has been deprecated. ' 'Please use "volume snapshot set" instead.')) volume_client = self.app.client_manager.volume snapshot = utils.find_resource(volume_client.volume_snapshots, parsed_args.snapshot) result = 0 if parsed_args.property: try: volume_client.volume_snapshots.set_metadata( snapshot.id, parsed_args.property) except Exception as e: LOG.error(_("Failed to set snapshot property: %s"), e) result += 1 if parsed_args.state: try: volume_client.volume_snapshots.reset_state( snapshot.id, parsed_args.state) except Exception as e: LOG.error(_("Failed to set snapshot state: %s"), e) result += 1 kwargs = {} if parsed_args.name: kwargs['name'] = parsed_args.name if parsed_args.description: kwargs['description'] = parsed_args.description if kwargs: try: volume_client.volume_snapshots.update( snapshot.id, **kwargs) except Exception as e: LOG.error(_("Failed to update snapshot name " "or description: %s"), e) result += 1 if result > 0: raise exceptions.CommandError(_("One or more of the " "set operations failed")) class ShowSnapshot(command.ShowOne): _description = _("Display snapshot details") def get_parser(self, prog_name): parser = super(ShowSnapshot, self).get_parser(prog_name) parser.add_argument( "snapshot", metavar="", help=_("Snapshot to display (name or ID)") ) return parser def take_action(self, parsed_args): LOG_DEP.warning(_('This command has been deprecated. ' 'Please use "volume snapshot show" instead.')) volume_client = self.app.client_manager.volume snapshot = utils.find_resource( volume_client.volume_snapshots, parsed_args.snapshot) snapshot._info.update( {'properties': utils.format_dict(snapshot._info.pop('metadata'))} ) return zip(*sorted(six.iteritems(snapshot._info))) class UnsetSnapshot(command.Command): _description = _("Unset snapshot properties") def get_parser(self, prog_name): parser = super(UnsetSnapshot, self).get_parser(prog_name) parser.add_argument( 'snapshot', metavar='', help=_('Snapshot to modify (name or ID)'), ) parser.add_argument( '--property', metavar='', action='append', default=[], help=_('Property to remove from snapshot ' '(repeat option to remove multiple properties)'), ) return parser def take_action(self, parsed_args): LOG_DEP.warning(_('This command has been deprecated. ' 'Please use "volume snapshot unset" instead.')) volume_client = self.app.client_manager.volume snapshot = utils.find_resource( volume_client.volume_snapshots, parsed_args.snapshot) if parsed_args.property: volume_client.volume_snapshots.delete_metadata( snapshot.id, parsed_args.property, )