File: //snap/google-cloud-cli/394/lib/surface/compute/instances/remove_metadata.py
# -*- coding: utf-8 -*- #
# Copyright 2014 Google LLC. 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.
"""Command for removing metadata."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
from apitools.base.py import encoding
from googlecloudsdk.api_lib.compute import base_classes
from googlecloudsdk.api_lib.compute import metadata_utils
from googlecloudsdk.calliope import arg_parsers
from googlecloudsdk.calliope import base
from googlecloudsdk.calliope import exceptions as calliope_exceptions
from googlecloudsdk.command_lib.compute.instances import flags
from googlecloudsdk.core import log
DETAILED_HELP = {
'DESCRIPTION':
"""\
{command} can be used to remove instance metadata entries.
""",
'EXAMPLES':
"""\
To remove metadata keys ``{0}'' and ``{1}'' along with their data from
an instance named ``{3}'', run:
$ {2} {3} --keys={0},{1}
""".format('important-data', 'useless-data', '{command}',
'test-instance')
}
class InstancesRemoveMetadata(base.UpdateCommand):
"""Remove instance metadata.
"""
@staticmethod
def Args(parser):
flags.INSTANCE_ARG.AddArgument(
parser, operation_type='set metadata on')
group = parser.add_mutually_exclusive_group()
group.add_argument(
'--all',
action='store_true',
default=False,
help='If provided, all metadata entries are removed.')
group.add_argument(
'--keys',
type=arg_parsers.ArgList(min_length=1),
metavar='KEY',
help='The keys of the entries to remove.')
def CreateReference(self, client, resources, args):
return flags.INSTANCE_ARG.ResolveAsResource(
args, resources, scope_lister=flags.GetInstanceZoneScopeLister(client))
def GetGetRequest(self, client, instance_ref):
return (client.apitools_client.instances,
'Get',
client.messages.ComputeInstancesGetRequest(**instance_ref.AsDict()))
def GetSetRequest(self, client, instance_ref, replacement):
return (client.apitools_client.instances,
'SetMetadata',
client.messages.ComputeInstancesSetMetadataRequest(
metadata=replacement.metadata,
**instance_ref.AsDict()))
def Modify(self, client, args, existing):
new_object = encoding.CopyProtoMessage(existing)
existing_metadata = getattr(existing, 'metadata', None)
new_object.metadata = metadata_utils.RemoveEntries(
client.messages,
existing_metadata=existing_metadata,
keys=args.keys,
remove_all=args.all)
if metadata_utils.MetadataEqual(existing_metadata, new_object.metadata):
return None
else:
return new_object
def Run(self, args):
if not args.all and not args.keys:
raise calliope_exceptions.OneOfArgumentsRequiredException(
['--keys', '--all'],
'One of [--all] or [--keys] must be provided.')
holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
client = holder.client
instance_ref = self.CreateReference(client, holder.resources, args)
get_request = self.GetGetRequest(client, instance_ref)
objects = client.MakeRequests([get_request])
new_object = self.Modify(client, args, objects[0])
# If existing object is equal to the proposed object or if
# Modify() returns None, then there is no work to be done, so we
# print the resource and return.
if not new_object or objects[0] == new_object:
log.status.Print(
'No change requested; skipping update for [{0}].'.format(
objects[0].name))
return objects
return client.MakeRequests(
[self.GetSetRequest(client, instance_ref, new_object)])
InstancesRemoveMetadata.detailed_help = DETAILED_HELP