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

gcloud auth application-default login/google-cloud-sdk/lib/surface/netapp/host_groups/__init__.py

@@ -0,0 +1,36 @@
+# -*- 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 group for Cloud NetApp Host Groups."""
+
+from googlecloudsdk.calliope import base
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class HostGroups(base.Group):
+  """Create and manage Cloud NetApp Host Groups."""
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class HostGroupsBeta(HostGroups):
+  """Create and manage Cloud NetApp Host Groups."""
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class HostGroupsAlpha(HostGroupsBeta):
+  """Create and manage Cloud NetApp Host Groups."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/netapp/host_groups/create.py

@@ -0,0 +1,97 @@
+# -*- 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.
+
+"""Create a Cloud NetApp Host Group."""
+
+from googlecloudsdk.api_lib.netapp.host_groups import client as host_groups_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp.host_groups import flags as host_groups_flags
+from googlecloudsdk.command_lib.util.args import labels_util
+from googlecloudsdk.core import log
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Create(base.CreateCommand):
+  """Create a Cloud NetApp Host Group."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Create a Cloud NetApp Host Group.
+          """,
+      'EXAMPLES': """\
+          The following command creates a Host Group named NAME using the required arguments:
+
+              $ {command} NAME --location=us-central1 --type=ISCSI_INITIATOR --hosts=host1,host2 --os-type=LINUX
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    host_groups_flags.AddHostGroupCreateArgs(parser)
+
+  def Run(self, args):
+    """Create a Cloud NetApp Host Group in the current project."""
+    host_group_ref = args.CONCEPTS.host_group.Parse()
+
+    client = host_groups_client.HostGroupsClient(self._RELEASE_TRACK)
+
+    host_group_type = host_groups_flags.GetHostGroupTypeEnumFromArg(
+        args.type, client.messages
+    )
+    os_type = host_groups_flags.GetHostGroupOsTypeEnumFromArg(
+        args.os_type, client.messages
+    )
+    labels = labels_util.ParseCreateArgs(
+        args, client.messages.HostGroup.LabelsValue
+    )
+
+    host_group = client.ParseHostGroupConfig(
+        name=host_group_ref.RelativeName(),
+        host_group_type=host_group_type,
+        hosts=args.hosts,
+        os_type=os_type,
+        description=args.description,
+        labels=labels,
+    )
+
+    result = client.CreateHostGroup(host_group_ref, args.async_, host_group)
+    if args.async_:
+      command = 'gcloud {} netapp host-groups list'.format(
+          self.ReleaseTrack().prefix
+      )
+      log.status.Print(
+          'Check the status of the new host group by listing all host groups:\n'
+          '$ {} '.format(command)
+      )
+    return result
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class CreateBeta(Create):
+  """Create a Cloud NetApp Host Group."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class CreateAlpha(CreateBeta):
+  """Create a Cloud NetApp Host Group."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.ALPHA

gcloud auth application-default login/google-cloud-sdk/lib/surface/netapp/host_groups/delete.py

@@ -0,0 +1,92 @@
+# -*- 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.
+"""Delete a Cloud NetApp Host Group."""
+
+from googlecloudsdk.api_lib.netapp.host_groups import client as host_groups_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp import flags
+from googlecloudsdk.command_lib.util.concepts import concept_parsers
+from googlecloudsdk.core import log
+from googlecloudsdk.core.console import console_io
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Delete(base.DeleteCommand):
+  """Delete a Cloud NetApp Host Group."""
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Delete a Cloud NetApp Host Group.
+          """,
+      'EXAMPLES': """\
+          The following command deletes a Host Group named NAME:
+
+              $ {command} NAME --location=us-central1
+
+          To delete a Host Group named NAME asynchronously, run the following command:
+
+              $ {command} NAME --location=us-central1 --async
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Add args for deleting a Host Group."""
+    concept_parsers.ConceptParser([
+        flags.GetHostGroupPresentationSpec('The Host Group to delete.')
+    ]).AddToParser(parser)
+    flags.AddResourceAsyncFlag(parser)
+
+  def Run(self, args):
+    """Delete a Cloud NetApp Host Group in the current project."""
+    host_group_ref = args.CONCEPTS.host_group.Parse()
+
+    if not args.quiet:
+      delete_warning = (
+          'You are about to delete a Host Group {}.\nAre you sure?'.format(
+              host_group_ref.RelativeName()
+          )
+      )
+      if not console_io.PromptContinue(message=delete_warning):
+        return None
+
+    client = host_groups_client.HostGroupsClient(self.ReleaseTrack())
+    result = client.DeleteHostGroup(host_group_ref, args.async_)
+    if args.async_:
+      command = 'gcloud {} netapp host-groups list'.format(
+          self.ReleaseTrack().prefix
+      )
+      log.status.Print(
+          'Check the status of the deletion by listing all host groups:\n  '
+          '$ {} '.format(command)
+      )
+    return result
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class DeleteBeta(Delete):
+  """Delete a Cloud NetApp Host Group."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class DeleteAlpha(DeleteBeta):
+  """Delete a Cloud NetApp Host Group."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.ALPHA

gcloud auth application-default login/google-cloud-sdk/lib/surface/netapp/host_groups/describe.py

@@ -0,0 +1,68 @@
+# -*- 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.
+"""Describe a Cloud NetApp Host Group."""
+
+from googlecloudsdk.api_lib.netapp.host_groups import client as host_groups_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp import flags
+from googlecloudsdk.command_lib.util.concepts import concept_parsers
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Describe(base.DescribeCommand):
+  """Describe a Cloud NetApp Host Group."""
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Describe a Cloud NetApp Host Group.
+          """,
+      'EXAMPLES': """\
+          The following command describes a Host Group named NAME in the given location:
+
+              $ {command} NAME --location=us-central1
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    concept_parsers.ConceptParser(
+        [flags.GetHostGroupPresentationSpec('The Host Group to describe.')]
+    ).AddToParser(parser)
+
+  def Run(self, args):
+    """Get a Cloud NetApp Host Group in the current project."""
+    host_group_ref = args.CONCEPTS.host_group.Parse()
+
+    client = host_groups_client.HostGroupsClient(
+        release_track=self.ReleaseTrack()
+    )
+    return client.GetHostGroup(host_group_ref)
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class DescribeBeta(Describe):
+  """Describe a Cloud NetApp Host Group."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class DescribeAlpha(DescribeBeta):
+  """Describe a Cloud NetApp Host Group."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.ALPHA

gcloud auth application-default login/google-cloud-sdk/lib/surface/netapp/host_groups/list.py

@@ -0,0 +1,76 @@
+# -*- 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.
+
+"""List Cloud NetApp Host Groups."""
+
+from googlecloudsdk.api_lib.netapp.host_groups import client as host_groups_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp import flags
+from googlecloudsdk.command_lib.util.concepts import concept_parsers
+from googlecloudsdk.core import properties
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class List(base.ListCommand):
+  """List Cloud NetApp Host Groups."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Lists Cloud NetApp Host Groups.
+          """,
+      'EXAMPLES': """\
+          The following command lists all Host Groups in the given location:
+
+              $ {command} --location=us-central1
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    concept_parsers.ConceptParser([
+        flags.GetResourceListingLocationPresentationSpec(
+            'The location in which to list Host Groups.'
+        )
+    ]).AddToParser(parser)
+
+  def Run(self, args):
+    """Run the list command."""
+    # Ensure that project is set before parsing location resource.
+    properties.VALUES.core.project.GetOrFail()
+
+    location_ref = args.CONCEPTS.location.Parse().RelativeName()
+    client = host_groups_client.HostGroupsClient(
+        release_track=self._RELEASE_TRACK
+    )
+    return client.ListHostGroups(location_ref)
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class ListBeta(List):
+  """List Cloud NetApp Host Groups."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class ListAlpha(ListBeta):
+  """List Cloud NetApp Host Groups."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.ALPHA

gcloud auth application-default login/google-cloud-sdk/lib/surface/netapp/host_groups/update.py

@@ -0,0 +1,110 @@
+# -*- 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.
+
+"""Updates a Cloud NetApp Host Group."""
+
+from googlecloudsdk.api_lib.netapp.host_groups import client as host_groups_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp.host_groups import flags as host_groups_flags
+from googlecloudsdk.command_lib.util.args import labels_util
+from googlecloudsdk.core import log
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Update(base.UpdateCommand):
+  """Update a Cloud NetApp Host Group."""
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Update a Cloud NetApp Host Group and its specified parameters.
+          """,
+      'EXAMPLES': """\
+          The following command updates a Host Group named NAME and its specified parameters:
+
+              $ {command} NAME --location=us-central1 --description="new description" --hosts="host3,host4" --update-labels=key2=val2
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    host_groups_flags.AddHostGroupUpdateArgs(parser)
+
+  def Run(self, args):
+    """Update a Cloud NetApp Host Group in the current project."""
+    host_group_ref = args.CONCEPTS.host_group.Parse()
+
+    client = host_groups_client.HostGroupsClient(self.ReleaseTrack())
+    labels_diff = labels_util.Diff.FromUpdateArgs(args)
+    original_host_group = client.GetHostGroup(host_group_ref)
+
+    # Update labels
+    if labels_diff.MayHaveUpdates():
+      labels = labels_diff.Apply(
+          client.messages.HostGroup.LabelsValue, original_host_group.labels
+      ).GetOrNone()
+    else:
+      labels = None
+
+    host_group = client.ParseUpdatedHostGroupConfig(
+        original_host_group,
+        hosts=args.hosts,
+        description=args.description,
+        labels=labels,
+    )
+
+    updated_fields = []
+    if args.IsSpecified('description'):
+      updated_fields.append('description')
+    if args.IsSpecified('hosts'):
+      updated_fields.append('hosts')
+    if (labels is not None) and (
+        args.IsSpecified('update_labels')
+        or args.IsSpecified('remove_labels')
+        or args.IsSpecified('clear_labels')
+    ):
+      updated_fields.append('labels')
+
+    update_mask = ','.join(updated_fields)
+    result = client.UpdateHostGroup(
+        host_group_ref, host_group, update_mask, args.async_
+    )
+    if args.async_:
+      command = 'gcloud {} netapp host-groups describe {} --location {}'.format(
+          self.ReleaseTrack().prefix,
+          host_group_ref.Name(),
+          host_group_ref.locationsId,
+      )
+      log.status.Print(
+          'Check the status of the updated host group by describing it:\n  '
+          '$ {} '.format(command)
+      )
+    return result
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class UpdateBeta(Update):
+  """Update a Cloud NetApp Host Group."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class UpdateAlpha(UpdateBeta):
+  """Update a Cloud NetApp Host Group."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.ALPHA