feat: Add new gcloud commands, API clients, and third-party libraries across various services.

gcloud auth application-default login/google-cloud-sdk/lib/surface/access_approval/requests/__init__.py

@@ -0,0 +1,31 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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 group for Access Approval requests."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+class AccessApproval(base.Group):
+  """Manage Access Approval requests.
+
+  Approval requests are created by Google personnel to request approval from
+  Access Approval customers prior to making administrative accesses to their
+  resources. Customers can act on these requests using the commands in this
+  command group.
+  """

gcloud auth application-default login/google-cloud-sdk/lib/surface/access_approval/requests/approve.py

@@ -0,0 +1,59 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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 approving an access approval request."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+import textwrap
+
+from googlecloudsdk.api_lib.access_approval import requests
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.access_approval import request_name
+
+
+class Approve(base.Command):
+  """Approve an Access Approval request.
+
+  Approve an Access Approval request. This will raise an error if the request
+  does not exist or is not in a pending state.
+  """
+
+  detailed_help = {
+      'EXAMPLES':
+          textwrap.dedent("""\
+        To approve an approval request using its name (e.g. projects/12345/approvalRequests/abc123), run:
+
+          $ {command} projects/12345/approvalRequests/abc123
+        """),
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Add command-specific args."""
+    request_name.Args(parser)
+
+  def Run(self, args):
+    """This is what gets called when the user runs this command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      Some value that we want to have printed later.
+    """
+    return requests.Approve(request_name.GetName(args))

gcloud auth application-default login/google-cloud-sdk/lib/surface/access_approval/requests/dismiss.py

@@ -0,0 +1,60 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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 dismissing and access approval request."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+import textwrap
+
+from googlecloudsdk.api_lib.access_approval import requests
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.access_approval import request_name
+
+
+class Dismiss(base.Command):
+  """Dismiss an Access Approval request.
+
+  Dismiss an Access Approval request. Note: this does not deny access to the
+  resource if another request has been made and approved for the same resource.
+  This will raise an error if the request does not exist.
+  """
+
+  detailed_help = {
+      'EXAMPLES':
+          textwrap.dedent("""\
+        To dismiss an approval request using its name (e.g. projects/12345/approvalRequests/abc123), run:
+
+          $ {command} projects/12345/approvalRequests/abc123
+        """),
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Add command-specific args."""
+    request_name.Args(parser)
+
+  def Run(self, args):
+    """This is what gets called when the user runs this command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      Some value that we want to have printed later.
+    """
+    return requests.Dismiss(request_name.GetName(args))

gcloud auth application-default login/google-cloud-sdk/lib/surface/access_approval/requests/get.py

@@ -0,0 +1,58 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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 to get an access approval request."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+import textwrap
+
+from googlecloudsdk.api_lib.access_approval import requests
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.access_approval import request_name
+
+
+class Get(base.DescribeCommand):
+  """Get an Access Approval request.
+
+  Get an Access Approval Request. Raise error if the request does not exist.
+  """
+
+  detailed_help = {
+      'EXAMPLES':
+          textwrap.dedent("""\
+        To get an approval request using its name (e.g. projects/my-project-123/approvalRequests/abc123), run:
+
+          $ {command} projects/my-project-123/approvalRequests/abc123
+        """),
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Add command-specific args."""
+    request_name.Args(parser)
+
+  def Run(self, args):
+    """This is what gets called when the user runs this command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      Some value that we want to have printed later.
+    """
+    return requests.Get(request_name.GetName(args))

gcloud auth application-default login/google-cloud-sdk/lib/surface/access_approval/requests/invalidate.py

@@ -0,0 +1,59 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 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 invalidating an access approval request."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+import textwrap
+
+from googlecloudsdk.api_lib.access_approval import requests
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.access_approval import request_name
+
+
+class Invalidate(base.Command):
+  """Invalidate an Access Approval request.
+
+  Invalidate an Access Approval request. This will raise an error if the request
+  does not exist or is not in an approved state.
+  """
+
+  detailed_help = {
+      'EXAMPLES':
+          textwrap.dedent("""\
+        To invalidate an approval request using its name (e.g. projects/12345/approvalRequests/abc123), run:
+
+          $ {command} projects/12345/approvalRequests/abc123
+        """),
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Add command-specific args."""
+    request_name.Args(parser)
+
+  def Run(self, args):
+    """This is what gets called when the user runs this command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      Some value that we want to have printed later.
+    """
+    return requests.Invalidate(request_name.GetName(args))

gcloud auth application-default login/google-cloud-sdk/lib/surface/access_approval/requests/list.py

@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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 access approval list requests."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+import textwrap
+
+from googlecloudsdk.api_lib.access_approval import requests
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.access_approval import parent
+
+
+class List(base.ListCommand):
+  """List Access Approval requests.
+
+  List Access Approval requests by parent (project/folder/organization).
+  """
+
+  detailed_help = {
+      'EXAMPLES':
+          textwrap.dedent("""\
+        To list all approval requests owned by project my-project-123, run:
+
+          $ {command} --project=my-project-123 --state=all
+
+        To list pending approval requests owned by organization 999, run:
+
+          $ {command} --organization=999
+
+        or
+
+          $ {command} --organization=999 --state=pending
+
+        Note that the user needs to have permission
+        accessapproval.requests.list on the project/folder/organization
+        """),
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Add command-specific args."""
+    parent.Args(parser)
+    parser.add_argument(
+        '--state',
+        default='pending',
+        help='filter for request state')
+    base.URI_FLAG.RemoveFromParser(parser)
+
+  def Run(self, args):
+    """This is what gets called when the user runs this command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      Some value that we want to have printed later.
+    """
+    p = parent.GetParent(args)
+    return requests.List(parent=p, filter=(
+        args.state.upper() if args.state else None))