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/multi_migs/__init__.py

@@ -0,0 +1,31 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2025 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 reading and manipulating multi-migs."""
+
+from googlecloudsdk.calliope import base
+
+
+@base.Hidden
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA, base.ReleaseTrack.ALPHA)
+class MultiMigs(base.Group):
+  """Manage multi-MIGs.
+
+  Multi-MIG is a regional resource that provides infrastructure level
+  coordination of VMs provisioning across multiple Managed Instance Groups
+  (MIGs).
+  """
+
+  category = base.COMPUTE_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/multi_migs/create.py

@@ -0,0 +1,119 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2025 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 creating multi-MIGs."""
+
+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.multi_migs import utils as api_utils
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute.multi_migs import utils
+
+
+DETAILED_HELP = {
+    'brief': 'Create a Compute Engine multi-MIG',
+    'DESCRIPTION': """\
+        *{command}* creates a Compute Engine multi-MIG.
+    """,
+    'EXAMPLES': """\
+      Running:
+
+              $ {command} example-multimig --workload-policy=example-policy
+
+      will create a multi-MIG called 'example-multimig'
+      with a workload policy called 'example-policy' in the region and project which were set by `gcloud config set`.
+
+      You can provide full path to multi-MIG name to override the region and
+      project or use `--region` and `--project` flags.
+
+      Example:
+
+              $ {command} projects/example-project/regions/us-central1/multiMigs/example-multimig --workload-policy=example-policy --description="Multi-MIG with workload policy"
+
+      will create a multi-MIG called 'example-multimig'
+      in the region `us-central1` and project 'example-project' with a
+      workload policy called 'projects/example-project/regions/us-central1/resourcePolicies/example-policy' and a description of 'Multi-MIG with workload policy'.
+    """,
+}
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class Create(base.CreateCommand):
+  """Create a multi-MIG."""
+
+  detailed_help = DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    utils.AddMultiMigNameArgToParser(
+        parser, base.ReleaseTrack.ALPHA.name.lower()
+    )
+    parser.add_argument(
+        '--description',
+        help='Sets description to multi-MIG.',
+    )
+    parser.add_argument(
+        '--workload-policy',
+        help='Specifies a workload policy for multi-MIG.',
+    )
+
+  def Run(self, args):
+    """Creates a multi-MIG.
+
+    Args:
+      args: the argparse arguments that this command was invoked with.
+
+    Returns:
+      List containing one resource.
+    """
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+    resources = holder.resources
+    multi_mig_ref = args.CONCEPTS.multi_mig.Parse()
+    multi_mig = client.messages.MultiMig(
+        name=multi_mig_ref.Name(),
+        description=args.description,
+        region=multi_mig_ref.region,
+        resourcePolicies=utils.MakeResourcePolicy(
+            args, resources, client.messages, multi_mig_ref
+        ),
+    )
+    return api_utils.Insert(client, multi_mig, multi_mig_ref)
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class CreateAlpha(Create):
+  """Create a multi-MIG."""
+
+  @classmethod
+  def Args(cls, parser):
+    utils.AddMultiMigNameArgToParser(
+        parser, base.ReleaseTrack.ALPHA.name.lower()
+    )
+    parser.add_argument(
+        '--description',
+        help='Sets description to multi-MIG.',
+    )
+    parser.add_argument(
+        '--workload-policy',
+        help=(
+            'Taking the resource policy ID and specifies a workload policy'
+            ' for multi-MIG.'
+        ),
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/multi_migs/delete.py

@@ -0,0 +1,73 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2025 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 deleting multi-MIGs."""
+
+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 utils
+from googlecloudsdk.api_lib.compute.multi_migs import utils as api_utils
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute.multi_migs import utils as flags
+
+
+DETAILED_HELP = {
+    'EXAMPLES': """\
+      To delete a multi-MIG with the name 'example-multimig' run:
+
+        $ {command} example-multimig
+      """,
+}
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class Delete(base.DeleteCommand):
+  """Delete a multi-MIG.
+
+  *{command}* deletes a multi-MIG.
+  """
+
+  detailed_help = DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddMultiMigNameArgToParser(
+        parser, base.ReleaseTrack.BETA.name.lower()
+    )
+
+  def Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+
+    multi_mig_ref = args.CONCEPTS.multi_mig.Parse()
+
+    utils.PromptForDeletion([multi_mig_ref])
+
+    return api_utils.Delete(client, multi_mig_ref)
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class DeleteAlpha(Delete):
+  """Delete a multi-MIG."""
+
+  @classmethod
+  def Args(cls, parser):
+    flags.AddMultiMigNameArgToParser(
+        parser, base.ReleaseTrack.ALPHA.name.lower()
+    )

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

@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2025 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 multi-MIGs."""
+
+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.multi_migs import utils as api_utils
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute.multi_migs import utils as flags
+
+
+DETAILED_HELP = {
+    'EXAMPLES': """\
+  To describe a multi-MIG with the name 'example-multimig', run:
+
+    $ {command} example-multimig
+  """,
+}
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class DescribeBeta(base.DescribeCommand):
+  """Describe a multi-MIG.
+
+  *{command}* describes a multi-MIG.
+  """
+
+  detailed_help = DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddMultiMigNameArgToParser(
+        parser, base.ReleaseTrack.BETA.name.lower()
+    )
+
+  def Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+
+    multi_mig_ref = args.CONCEPTS.multi_mig.Parse()
+
+    return api_utils.Get(client, multi_mig_ref)
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class DescribeAlpha(DescribeBeta):
+  """Describe a multi-MIG."""
+
+  @classmethod
+  def Args(cls, parser):
+    flags.AddMultiMigNameArgToParser(
+        parser, base.ReleaseTrack.ALPHA.name.lower()
+    )

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

@@ -0,0 +1,67 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2025 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 list all multi-MIGs for a selected region."""
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.api_lib.compute import utils
+from googlecloudsdk.api_lib.compute.multi_migs import utils as api_utils
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute import flags as compute_flags
+from googlecloudsdk.command_lib.compute.multi_migs import utils as format_utils
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To list all multi-MIGs for a selected region, run:
+
+          $ {command}
+        """,
+}
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class ListBeta(base.ListCommand):
+  """List multi-MIGs for a selected region."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    parser.display_info.AddFormat(format_utils.DEFAULT_LIST_FORMAT)
+    parser.display_info.AddUriFunc(utils.MakeGetUriFunc())
+    compute_flags.AddRegionFlag(
+        parser,
+        resource_type='multi-MIG',
+        operation_type='list',
+    )
+
+  def Run(self, args):
+    """Run the list command."""
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+    return api_utils.List(client, args)
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class ListAlpha(ListBeta):
+  """List multi-MIGs for a selected region."""
+
+  @classmethod
+  def Args(cls, parser):
+    super(ListAlpha, cls).Args(parser)
+    parser.display_info.AddFormat(format_utils.ALPHA_LIST_FORMAT)

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

@@ -0,0 +1,31 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2025 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 reading and manipulating multi-MIGs members."""
+
+from googlecloudsdk.calliope import base
+
+
+@base.Hidden
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Members(base.Group):
+  """Manage multi-MIG members.
+
+  This command group allows you to manage the members of a Multi-MIG. A
+  Multi-MIG member is a sub-resource that represents a Managed Instance Group
+  (MIG) that is attached to a Multi-MIG.
+  """
+
+  category = base.COMPUTE_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/multi_migs/members/describe.yaml

@@ -0,0 +1,22 @@
+- release_tracks: [ALPHA]
+  help_text:
+    brief: Describe a member of a multi-MIG.
+    description: Describe a member of a multi-MIG.
+    examples: |
+      To describe a multi-MIG member with the name 'example-member' for the multi-MIG with the name 'example-multimig', run:
+
+        $ {command} example-member --multi-mig=example-multimig
+
+      or pass the full resource name:
+
+        $ {command} projects/my-project/regions/us-central1/multiMigs/example-multimig/multiMigMembers/example-member
+
+  request:
+    collection: compute.regionMultiMigMembers
+    ALPHA:
+      api_version: alpha
+
+  arguments:
+    resource:
+      help_text: The name of the multi-MIG member.
+      spec: !REF googlecloudsdk.command_lib.compute.multi_migs.resources:member

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/multi_migs/members/list.yaml

@@ -0,0 +1,36 @@
+- release_tracks: [ALPHA]
+  help_text:
+    brief: List members of a multi-MIG
+    description: List members of a multi-MIG
+    examples: |
+      The following command lists the members of a multi-MIG for the 'example-multi-mig':
+
+        $ {command} --multi-mig=example-multi-mig
+
+      you can also pass the full resource name:
+
+        $ {command} projects/my-project/regions/us-central1/multiMigs/example-multimig
+
+  request:
+    collection: compute.regionMultiMigMembers
+    ALPHA:
+      api_version: alpha
+
+  response:
+    id_field: name
+
+  arguments:
+    resource:
+      help_text: |
+        The mutli-MIG to list members for.
+
+      spec: !REF googlecloudsdk.command_lib.compute.multi_migs.resources:multi_mig
+      is_positional: false
+
+  output:
+    format: |
+      table(
+      name.basename(),
+      region.basename(),
+      status.instance_group_manager
+      )