File: //snap/google-cloud-cli/396/lib/surface/compute/health_checks/update/https.py
# -*- coding: utf-8 -*- #
# Copyright 2015 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 updating health checks."""
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 health_checks_utils
from googlecloudsdk.calliope import base
from googlecloudsdk.command_lib.compute import scope as compute_scope
from googlecloudsdk.command_lib.compute.health_checks import exceptions
from googlecloudsdk.command_lib.compute.health_checks import flags
from googlecloudsdk.core import exceptions as core_exceptions
from googlecloudsdk.core import log
def _DetailedHelp():
return {
'brief':
'Update a HTTPS health check.',
'DESCRIPTION':
"""\
*{command}* is used to update an existing HTTPS health check. Only
arguments passed in will be updated on the health check. Other
attributes will remain unaffected.
""",
}
def _Args(
parser,
include_log_config,
include_weighted_load_balancing,
include_source_regions,
):
"""Adds all the args in the parser."""
health_check_arg = flags.HealthCheckArgument('HTTPS')
health_check_arg.AddArgument(parser, operation_type='update')
health_checks_utils.AddHttpRelatedUpdateArgs(parser,
include_weighted_load_balancing)
health_checks_utils.AddProtocolAgnosticUpdateArgs(parser, 'HTTPS')
health_checks_utils.AddHttpRelatedResponseArg(parser)
if include_source_regions:
health_checks_utils.AddHealthCheckSourceRegionsRelatedArgs(parser)
if include_log_config:
health_checks_utils.AddHealthCheckLoggingRelatedArgs(parser)
def _GetGetRequest(client, health_check_ref):
"""Returns a request for fetching the existing health check."""
return (client.apitools_client.healthChecks, 'Get',
client.messages.ComputeHealthChecksGetRequest(
healthCheck=health_check_ref.Name(),
project=health_check_ref.project))
def _GetSetRequest(client, health_check_ref, replacement):
"""Returns a request for updating the health check."""
return (client.apitools_client.healthChecks, 'Update',
client.messages.ComputeHealthChecksUpdateRequest(
healthCheck=health_check_ref.Name(),
healthCheckResource=replacement,
project=health_check_ref.project))
def _GetRegionalGetRequest(client, health_check_ref):
"""Returns a request for fetching the existing health check."""
return (client.apitools_client.regionHealthChecks, 'Get',
client.messages.ComputeRegionHealthChecksGetRequest(
healthCheck=health_check_ref.Name(),
project=health_check_ref.project,
region=health_check_ref.region))
def _GetRegionalSetRequest(client, health_check_ref, replacement):
"""Returns a request for updating the health check."""
return (client.apitools_client.regionHealthChecks, 'Update',
client.messages.ComputeRegionHealthChecksUpdateRequest(
healthCheck=health_check_ref.Name(),
healthCheckResource=replacement,
project=health_check_ref.project,
region=health_check_ref.region))
def _Modify(
client,
args,
existing_check,
include_log_config,
include_weighted_load_balancing,
include_source_regions,
):
"""Returns a modified HealthCheck message."""
# We do not support using 'update https' with a health check of a
# different protocol.
if (existing_check.type !=
client.messages.HealthCheck.TypeValueValuesEnum.HTTPS):
raise core_exceptions.Error(
'update https subcommand applied to health check with protocol ' +
existing_check.type.name)
# Description, PortName, and Host are the only attributes that can be
# cleared by passing in an empty string (but we don't want to set it to
# an empty string).
if args.description:
description = args.description
elif args.description is None:
description = existing_check.description
else:
description = None
if args.host:
host = args.host
elif args.host is None:
host = existing_check.httpsHealthCheck.host
else:
host = None
port, port_name, port_specification = health_checks_utils. \
HandlePortRelatedFlagsForUpdate(args, existing_check.httpsHealthCheck)
if include_weighted_load_balancing:
weight_report_mode = existing_check.httpsHealthCheck.weightReportMode
if args.IsSpecified('weight_report_mode'):
weight_report_mode = client.messages.HTTPSHealthCheck.WeightReportModeValueValuesEnum(
args.weight_report_mode)
proxy_header = existing_check.httpsHealthCheck.proxyHeader
if args.proxy_header is not None:
proxy_header = (
client.messages.HTTPSHealthCheck.ProxyHeaderValueValuesEnum(
args.proxy_header))
if args.response:
response = args.response
elif args.response is None:
response = existing_check.httpsHealthCheck.response
else:
response = None
https_health_check = client.messages.HTTPSHealthCheck(
host=host,
port=port,
portName=port_name,
requestPath=(args.request_path or
existing_check.httpsHealthCheck.requestPath),
portSpecification=port_specification,
proxyHeader=proxy_header,
response=response)
if include_weighted_load_balancing:
https_health_check.weightReportMode = weight_report_mode
new_health_check = client.messages.HealthCheck(
name=existing_check.name,
description=description,
type=client.messages.HealthCheck.TypeValueValuesEnum.HTTPS,
httpsHealthCheck=https_health_check,
checkIntervalSec=(args.check_interval or existing_check.checkIntervalSec),
timeoutSec=args.timeout or existing_check.timeoutSec,
healthyThreshold=(args.healthy_threshold or
existing_check.healthyThreshold),
unhealthyThreshold=(args.unhealthy_threshold or
existing_check.unhealthyThreshold),
)
if include_log_config:
new_health_check.logConfig = health_checks_utils.ModifyLogConfig(
client, args, existing_check.logConfig)
if include_source_regions:
source_regions = existing_check.sourceRegions
if args.IsSpecified('source_regions'):
source_regions = args.source_regions
new_health_check.sourceRegions = source_regions
return new_health_check
def _ValidateArgs(
args,
include_log_config,
include_weighted_load_balancing,
include_source_regions,
):
"""Validates given args and raises exception if any args are invalid."""
health_checks_utils.CheckProtocolAgnosticArgs(args)
args_unset = not (args.port or args.request_path or args.check_interval or
args.timeout or args.healthy_threshold or
args.unhealthy_threshold or args.proxy_header or
args.use_serving_port)
if include_log_config:
args_unset = (args.enable_logging is None and args_unset)
source_regions_modified = False
if include_source_regions and args.IsSpecified('source_regions'):
source_regions_modified = True
weight_report_mode_modified = False
if include_weighted_load_balancing and args.IsSpecified('weight_report_mode'):
weight_report_mode_modified = True
if (
args.description is None
and args.host is None
and args.response is None
and args.port_name is None
and not weight_report_mode_modified
and not source_regions_modified
and args_unset
):
raise exceptions.ArgumentError('At least one property must be modified.')
def _Run(
args,
holder,
include_log_config,
include_weighted_load_balancing,
include_source_regions,
):
"""Issues the requests necessary for updating the health check."""
client = holder.client
_ValidateArgs(
args,
include_log_config,
include_weighted_load_balancing,
include_source_regions,
)
health_check_arg = flags.HealthCheckArgument('HTTPS')
health_check_ref = health_check_arg.ResolveAsResource(
args, holder.resources, default_scope=compute_scope.ScopeEnum.GLOBAL)
if health_checks_utils.IsRegionalHealthCheckRef(health_check_ref):
get_request = _GetRegionalGetRequest(client, health_check_ref)
else:
get_request = _GetGetRequest(client, health_check_ref)
objects = client.MakeRequests([get_request])
new_object = _Modify(
client,
args,
objects[0],
include_log_config,
include_weighted_load_balancing,
include_source_regions,
)
# 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 objects[0] == new_object:
log.status.Print('No change requested; skipping update for [{0}].'.format(
objects[0].name))
return objects
if health_checks_utils.IsRegionalHealthCheckRef(health_check_ref):
set_request = _GetRegionalSetRequest(client, health_check_ref, new_object)
else:
set_request = _GetSetRequest(client, health_check_ref, new_object)
return client.MakeRequests([set_request])
@base.ReleaseTracks(base.ReleaseTrack.GA)
@base.DefaultUniverseOnly
class Update(base.UpdateCommand):
"""Update a HTTPS health check."""
_include_log_config = True
_include_weighted_load_balancing = False
_include_source_regions = True
detailed_help = _DetailedHelp()
@classmethod
def Args(cls, parser):
_Args(
parser,
cls._include_log_config,
cls._include_weighted_load_balancing,
cls._include_source_regions,
)
def Run(self, args):
holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
return _Run(
args,
holder,
self._include_log_config,
self._include_weighted_load_balancing,
self._include_source_regions,
)
@base.ReleaseTracks(base.ReleaseTrack.BETA)
class UpdateBeta(Update):
_include_weighted_load_balancing = False
@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
class UpdateAlpha(UpdateBeta):
_include_weighted_load_balancing = True