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

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/reservations/blocks/__init__.py

@@ -0,0 +1,35 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 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.
+"""Commands for Compute Engine reservation blocks."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class ReservationBlocks(base.Group):
+  """Manage Compute Engine reservation blocks."""
+  category = base.COMPUTE_CATEGORY
+
+  detailed_help = {
+      'DESCRIPTION': """
+        Manage Compute Engine reservation blocks.
+      """,
+  }

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/reservations/blocks/describe.py

@@ -0,0 +1,89 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 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 describing reservation blocks."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute import flags as compute_flags
+from googlecloudsdk.command_lib.compute import scope as compute_scope
+from googlecloudsdk.command_lib.compute.reservations import resource_args
+from googlecloudsdk.command_lib.compute.reservations.blocks import flags
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class Describe(base.DescribeCommand):
+  """Describe a Compute Engine reservation block."""
+
+  @staticmethod
+  def Args(parser):
+    Describe.ReservationArg = (
+        resource_args.GetReservationResourceArg()
+    )
+    Describe.ReservationArg.AddArgument(parser, operation_type='describe')
+    flags.AddDescribeFlags(parser)
+    flags.AddFullViewFlag(parser)
+
+  def Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+
+    reservation_ref = Describe.ReservationArg.ResolveAsResource(
+        args,
+        holder.resources,
+        default_scope=compute_scope.ScopeEnum.ZONE,
+        scope_lister=compute_flags.GetDefaultScopeLister(client))
+
+    view_enum = self.GetViewEnum(client, args)
+
+    request = client.messages.ComputeReservationBlocksGetRequest(
+        reservation=reservation_ref.reservation,
+        zone=reservation_ref.zone,
+        project=reservation_ref.project,
+        reservationBlock=args.block_name,
+        view=view_enum,
+    )
+
+    return client.MakeRequests([(client.apitools_client.reservationBlocks,
+                                 'Get', request)])[0]
+
+  def GetViewEnum(self, client, args):
+    view_enum = None
+    if args.IsSpecified('full_view'):
+      if args.full_view == 'BLOCK_VIEW_FULL':
+        view_enum = (
+            client.messages.ComputeReservationBlocksGetRequest.ViewValueValuesEnum.FULL
+        )
+      if args.full_view == 'BLOCK_VIEW_BASIC':
+        view_enum = (
+            client.messages.ComputeReservationBlocksGetRequest.ViewValueValuesEnum.BASIC
+        )
+    return view_enum
+
+
+Describe.detailed_help = {
+    'EXAMPLES':
+        """\
+    To describe a reservation block in reservation my-reservation in my-zone
+    with block name my-reservation-block-0001, run:
+
+      $ {command} my-reservation --zone=my-zone --block-name=my-reservation-block-0001
+    """,
+}

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/reservations/blocks/list.py

@@ -0,0 +1,102 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 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 listing reservation blocks."""
+
+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 request_helper
+from googlecloudsdk.api_lib.compute import utils
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute import flags
+from googlecloudsdk.command_lib.compute import scope as compute_scope
+from googlecloudsdk.command_lib.compute.reservations import resource_args
+
+DETAILED_HELP = {
+    'DESCRIPTION':
+        """\
+        {command} displays all Compute Engine reservation blocks in a densely
+        deployed reservation.
+      """,
+    'EXAMPLES':
+        """\
+        To list all reservation blocks in a densely deployed reservation in
+        table form, run:
+
+        $ {command} my-reservation --zone=us-central1-a --project=my-project
+
+        To list the URIs of all reservation blocks in a densely deployed
+        reservation, run:
+
+        $ {command} my-reservation --zone=us-central1-a --project=my-project --uri
+    """
+}
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class List(base.ListCommand):
+  """List Compute Engine reservation blocks."""
+
+  detailed_help = DETAILED_HELP
+
+  @classmethod
+  def Args(cls, parser):
+    List.ReservationArg = resource_args.GetReservationResourceArg()
+    List.ReservationArg.AddArgument(parser)
+
+  def _Run(self, args, holder):
+    client = holder.client
+
+    reservation_ref = (List.ReservationArg.
+                       ResolveAsResource(
+                           args,
+                           holder.resources,
+                           default_scope=compute_scope.ScopeEnum.ZONE,
+                           scope_lister=flags.GetDefaultScopeLister(client)))
+
+    service = client.apitools_client.reservationBlocks
+    request = (client.messages.
+               ComputeReservationBlocksListRequest(
+                   reservation=reservation_ref.reservation,
+                   zone=reservation_ref.zone,
+                   project=reservation_ref.project))
+
+    errors = []
+    results = list(request_helper.MakeRequests(
+        requests=[(service, 'List', request)],
+        http=client.apitools_client.http,
+        batch_url=client.batch_url,
+        errors=errors))
+
+    if errors:
+      utils.RaiseToolException(errors)
+    return results
+
+  def Run(self, args):
+    """Creates and issues a reservationBlocks.list request.
+
+    Args:
+      args: the argparse arguments that this command was invoked with.
+
+    Returns:
+      List of reservation blocks.
+    """
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    return self._Run(args, holder)

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/reservations/blocks/perform_maintenance.py

@@ -0,0 +1,78 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 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 performing maintenance on a reservation block."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute import flags as compute_flags
+from googlecloudsdk.command_lib.compute import scope as compute_scope
+from googlecloudsdk.command_lib.compute.reservations import resource_args
+from googlecloudsdk.command_lib.compute.reservations import util
+from googlecloudsdk.command_lib.compute.reservations.blocks import flags
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class PerformMaintenance(base.UpdateCommand):
+  """Perform maintenance on a reservation block within a reservation."""
+
+  @staticmethod
+  def Args(parser):
+    resource_args.GetReservationResourceArg().AddArgument(
+        parser, operation_type='perform-maintenance')
+    flags.AddDescribeFlags(parser)
+    flags.AddScopeFlags(parser)
+
+  def Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+
+    reservation_ref = resource_args.GetReservationResourceArg(
+    ).ResolveAsResource(
+        args,
+        holder.resources,
+        default_scope=compute_scope.ScopeEnum.ZONE,
+        scope_lister=compute_flags.GetDefaultScopeLister(client))
+
+    request = (
+        client.messages.ComputeReservationBlocksPerformMaintenanceRequest(
+            reservation=reservation_ref.reservation,
+            zone=reservation_ref.zone,
+            project=reservation_ref.project,
+            reservationBlock=args.block_name,
+            reservationsBlocksPerformMaintenanceRequest=
+            client.messages.ReservationsBlocksPerformMaintenanceRequest(
+                maintenanceScope=util.MakeReservationBlocksMaintenanceScope(
+                    client.messages, args.scope))
+        )
+    )
+
+    return client.MakeRequests([(client.apitools_client.reservationBlocks,
+                                 'PerformMaintenance', request)])
+
+PerformMaintenance.detailed_help = {
+    'EXAMPLES':
+        """\
+    To perform maintenance on a reservation block in reservation my-reservation
+    in my-zone with block name my-reservation-block-0001 with scope all, run:
+
+      $ {command} my-reservation --zone=my-zone --block-name=my-reservation-block-0001 --scope=all
+    """,
+}