File: //snap/google-cloud-cli/current/lib/surface/functions/add_invoker_policy_binding.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.
"""Add an invoker binding to the IAM policy of a Google Cloud Function."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
from googlecloudsdk.api_lib.functions.v1 import util as api_util_v1
from googlecloudsdk.calliope import base
from googlecloudsdk.calliope import parser_extensions
from googlecloudsdk.command_lib.functions import flags
from googlecloudsdk.command_lib.functions import util
from googlecloudsdk.command_lib.functions.v2.add_invoker_policy_binding import command as command_v2
from googlecloudsdk.command_lib.iam import iam_util
_DETAILED_HELP = {
    'DESCRIPTION': """\
      Adds an invoker role IAM policy binding that allows the specified member
      to invoke the specified function.
      For Cloud Functions (1st gen), this adds the Cloud Functions Invoker
      binding to the IAM policy of the specified function.
      For Cloud Functions (2nd gen), this adds the Cloud Run Invoker binding to
      the IAM policy of the specified function's underlying Cloud Run service.
      """,
    'EXAMPLES': """\
          To add the invoker role policy binding for `FUNCTION-1` for member
          `MEMBER-1` run:
            $ {command} FUNCTION-1 --member=MEMBER-1
          """,
}
@base.ReleaseTracks(base.ReleaseTrack.GA)
class AddInvokerPolicyBinding(util.FunctionResourceCommand):
  """Adds an invoker binding to the IAM policy of a Google Cloud Function.
  This command applies to Cloud Functions 2nd gen only.
  """
  detailed_help = _DETAILED_HELP
  @staticmethod
  def Args(parser):
    """Registers flags for this command."""
    flags.AddFunctionResourceArg(parser, 'to add the invoker binding to')
    flags.AddGen2Flag(parser, 'to add the invoker binding to', hidden=True)
    iam_util.AddMemberFlag(parser, 'to add to the IAM policy', False)
  def _RunV1(self, args: parser_extensions.Namespace):
    return api_util_v1.AddFunctionIamPolicyBinding(
        args.CONCEPTS.name.Parse().RelativeName(),
        member=args.member,
        role='roles/cloudfunctions.invoker',
    )
  def _RunV2(self, args):
    return command_v2.Run(args, self.ReleaseTrack())
@base.ReleaseTracks(base.ReleaseTrack.BETA)
class AddInvokerPolicyBindingBeta(AddInvokerPolicyBinding):
  """Adds an invoker binding to the IAM policy of a Google Cloud Function.
  This command applies to Cloud Functions 2nd gen only.
  """
@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
class AddInvokerPolicyBindingAlpha(AddInvokerPolicyBindingBeta):
  """Add an invoker binding to the IAM policy of a Google Cloud Function.
  This command applies to Cloud Functions 2nd Gen only.
  """