File: //snap/google-cloud-cli/396/lib/surface/compute/instances/perform_maintenance.py
# -*- coding: utf-8 -*- #
# Copyright 2021 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 perform maintenance on Google Compute Engine instance."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
from googlecloudsdk.api_lib.compute import base_classes
from googlecloudsdk.api_lib.compute import exceptions
from googlecloudsdk.api_lib.compute import utils
from googlecloudsdk.calliope import base
from googlecloudsdk.command_lib.compute import flags
from googlecloudsdk.command_lib.compute.instances import flags as instance_flags
class PerformMaintenanceError(exceptions.Error):
"""Exception thrown when there is a problem with performing maintenance on an instance."""
@base.DefaultUniverseOnly
@base.ReleaseTracks(
base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA, base.ReleaseTrack.GA
)
class PerformMaintenance(base.UpdateCommand):
"""Perform maintenance of Google Compute Engine instance."""
@staticmethod
def Args(parser):
instance_flags.INSTANCES_ARG.AddArgument(parser)
def Run(self, args):
holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
client = holder.client
messages = holder.client.messages
instance_refs = instance_flags.INSTANCES_ARG.ResolveAsResource(
args, holder.resources, scope_lister=flags.GetDefaultScopeLister(client)
)
requests = []
for instance_ref in instance_refs:
request_protobuf = messages.ComputeInstancesPerformMaintenanceRequest(
**instance_ref.AsDict()
)
request = (
client.apitools_client.instances,
'PerformMaintenance',
request_protobuf,
)
requests.append(request)
errors = []
holder.client.MakeRequests(requests, errors_to_collect=errors)
if errors:
utils.RaiseException(
errors,
PerformMaintenanceError,
error_message='Could not perform maintenance for resource:',
)
PerformMaintenance.detailed_help = {
'brief':
'Perform maintenance of Google Compute Engine instance',
'EXAMPLES':
"""\
To perform customer-triggered maintenance on an instance named ``{0}''
located in zone ``{1}'', run:
$ {2} {0} --zone={1}
""".format('test-instance', 'us-east1-d', '{command}')
}