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

@@ -0,0 +1,30 @@
+# -*- 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 Volume QuotaRules."""
+
+from googlecloudsdk.calliope import base
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class QuotaRules(base.Group):
+  """Create and manage Cloud NetApp Volume QuotaRules."""
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class QuotaRulesBeta(QuotaRules):
+  """Create and manage Cloud NetApp Volume QuotaRules."""

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

@@ -0,0 +1,106 @@
+# -*- 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 Volume Quota Rule."""
+
+from googlecloudsdk.api_lib.netapp.volumes.quota_rules import client as quota_rules_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp.volumes.quota_rules import flags as quota_rules_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 Volume Quota Rule."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Create a Cloud NetApp Volume Quota Rule.
+          """,
+      'EXAMPLES': """\
+          The following command creates a default `user` Quota Rule named NAME using the required arguments:
+
+              $ {command} NAME --location=us-central1 --volume=vol1 --type=DEFAULT_USER_QUOTA --disk-limit-mib=200
+
+
+          The following command creates a default `group` Quota Rule named NAME using the required arguments:
+
+              $ {command} NAME --location=us-central1 --volume=vol1 --type=DEFAULT_GROUP_QUOTA --disk-limit-mib=200
+
+
+          The following command creates an individual user Quota Rule named NAME for user with UID '100' using the required arguments:
+
+              $ {command} NAME --location=us-central1 --volume=vol1 --type=INDIVIDUAL_USER_QUOTA --target=100 --disk-limit-mib=200
+
+
+          The following command creates an individual group Quota Rule named NAME for group with GID '1001' using the required arguments:
+
+              $ {command} NAME --location=us-central1 --volume=vol1 --type=INDIVIDUAL_GROUP_QUOTA --target=1001 --disk-limit-mib=200
+
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    quota_rules_flags.AddQuotaRuleCreateArgs(parser)
+
+  def Run(self, args):
+    """Create a Cloud NetApp Volume Quota Rule in the current project."""
+    quota_rule_ref = args.CONCEPTS.quota_rule.Parse()
+
+    volume_ref = args.CONCEPTS.volume.Parse().RelativeName()
+    client = quota_rules_client.QuotaRulesClient(self._RELEASE_TRACK)
+
+    quota_rule_type = quota_rules_flags.GetQuotaRuleTypeEnumFromArg(
+        args.type, client.messages
+    )
+    labels = labels_util.ParseCreateArgs(
+        args, client.messages.QuotaRule.LabelsValue
+    )
+
+    quota_rule = client.ParseQuotaRuleConfig(
+        name=quota_rule_ref.RelativeName(),
+        quota_rule_type=quota_rule_type,
+        target=args.target,
+        disk_limit_mib=args.disk_limit_mib,
+        description=args.description,
+        labels=labels,
+    )
+
+    result = client.CreateQuotaRule(
+        quota_rule_ref, volume_ref, args.async_, quota_rule
+    )
+    if args.async_:
+      command = 'gcloud {} netapp volumes quota-rules list'.format(
+          self.ReleaseTrack().prefix
+      )
+      log.status.Print(
+          'Check the status of the new quota rule by listing all quota rules:\n'
+          '$ {} '.format(command)
+      )
+    return result
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class CreateBeta(Create):
+  """Create a Cloud NetApp Volume Quota Rule."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA

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

@@ -0,0 +1,89 @@
+# -*- 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 Volume Quota Rule."""
+
+from googlecloudsdk.api_lib.netapp.volumes.quota_rules import client as quota_rules_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp import flags
+from googlecloudsdk.command_lib.netapp.volumes.quota_rules import flags as quota_rules_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 Volume QuotaRule."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Delete a Cloud NetApp Volume QuotaRule.
+          """,
+      'EXAMPLES': """\
+          The following command deletes a QuotaRule named NAME using the required arguments:
+
+              $ {command} NAME --location=us-central1 --volume=vol1
+
+          To delete a QuotaRule named NAME asynchronously, run the following command:
+
+              $ {command} NAME --location=us-central1 --volume=vol1 --async
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Add args for deleting a Quota Rule."""
+    concept_parsers.ConceptParser([
+        flags.GetQuotaRulePresentationSpec('The Quota Rule to delete.')
+    ]).AddToParser(parser)
+    quota_rules_flags.AddQuotaRuleVolumeArg(parser)
+    flags.AddResourceAsyncFlag(parser)
+
+  def Run(self, args):
+    """Delete a Cloud NetApp Volume QuotaRule in the current project."""
+    quota_rule_ref = args.CONCEPTS.quota_rule.Parse()
+
+    if not args.quiet:
+      delete_warning = (
+          'You are about to delete a QuotaRule {}.\nAre you sure?'.format(
+              quota_rule_ref.RelativeName()
+          )
+      )
+      if not console_io.PromptContinue(message=delete_warning):
+        return None
+
+    client = quota_rules_client.QuotaRulesClient(self._RELEASE_TRACK)
+    result = client.DeleteQuotaRule(quota_rule_ref, args.async_)
+    if args.async_:
+      command = 'gcloud {} netapp volumes quota-rules list'.format(
+          self.ReleaseTrack().prefix
+      )
+      log.status.Print(
+          'Check the status of the deletion by listing all quota rules:\n  '
+          '$ {} '.format(command)
+      )
+    return result
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class DeleteBeta(Delete):
+  """Delete a Cloud NetApp Volume Quota Rule."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA

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

@@ -0,0 +1,64 @@
+# -*- 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 Volume Quota Rule."""
+
+from googlecloudsdk.api_lib.netapp.volumes.quota_rules import client as quota_rules_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp import flags
+from googlecloudsdk.command_lib.netapp.volumes.quota_rules import flags as quota_rules_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 Volume Quota Rule."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Describe a Cloud NetApp Volume Quota Rule.
+          """,
+      'EXAMPLES': """\
+          The following command describes a Quota Rule named NAME in the given location and volume:
+
+              $ {command} NAME --location=us-central1 --volume=vol1
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    concept_parsers.ConceptParser(
+        [flags.GetQuotaRulePresentationSpec('The Quota Rule to describe.')]
+    ).AddToParser(parser)
+    quota_rules_flags.AddQuotaRuleVolumeArg(parser, required=True)
+
+  def Run(self, args):
+    """Get a Cloud NetApp Volume Quota Rule in the current project."""
+    quota_rule_ref = args.CONCEPTS.quota_rule.Parse()
+
+    client = quota_rules_client.QuotaRulesClient(
+        release_track=self._RELEASE_TRACK
+    )
+    return client.GetQuotaRule(quota_rule_ref)
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class DescribeBeta(Describe):
+  """Describe a Cloud NetApp Volume Quota Rule."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA

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

@@ -0,0 +1,69 @@
+# -*- 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 Volume Quota Rules."""
+
+from googlecloudsdk.api_lib.netapp.volumes.quota_rules import client as quota_rules_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp import flags
+from googlecloudsdk.command_lib.netapp.volumes.quota_rules import flags as quota_rules_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 Volume QuotaRules."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Lists Cloud NetApp Volume QuotaRules.
+          """,
+      'EXAMPLES': """\
+          The following command lists all QuotaRules in the given location and volume:
+
+              $ {command} --location=us-central1 --volume=vol1
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    concept_parsers.ConceptParser([
+        flags.GetResourceListingLocationPresentationSpec(
+            'The location in which to list Volume QuotaRules.')
+    ]).AddToParser(parser)
+    quota_rules_flags.AddQuotaRuleVolumeArg(parser, required=True)
+
+  def Run(self, args):
+    """Run the list command."""
+    # Ensure that project is set before parsing location resource.
+    properties.VALUES.core.project.GetOrFail()
+
+    volume_ref = args.CONCEPTS.volume.Parse().RelativeName()
+    client = quota_rules_client.QuotaRulesClient(
+        release_track=self._RELEASE_TRACK
+    )
+    return list(client.ListQuotaRules(volume_ref, limit=args.limit))
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class ListBeta(List):
+  """List Cloud NetApp Volume QuotaRules."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA

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

@@ -0,0 +1,107 @@
+# -*- 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 Volume QuotaRule."""
+
+from googlecloudsdk.api_lib.netapp.volumes.quota_rules import client as quota_rules_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp.volumes.quota_rules import flags as quota_rules_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 Volume QuotaRule."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Update a Cloud NetApp Volume QuotaRule and its specified parameters.
+          """,
+      'EXAMPLES': """\
+          The following command updates a QuotaRule named NAME and its specified parameters:
+
+              $ {command} NAME --location=us-central1 --description="new" --disk-limit-mib=100 --update-labels=key2=val2 --volume=vol1
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    quota_rules_flags.AddQuotaRuleUpdateArgs(parser)
+
+  def Run(self, args):
+    """Update a Cloud NetApp Volume QuotaRule in the current project."""
+    quota_rule_ref = args.CONCEPTS.quota_rule.Parse()
+
+    client = quota_rules_client.QuotaRulesClient(self._RELEASE_TRACK)
+    labels_diff = labels_util.Diff.FromUpdateArgs(args)
+    original_quota_rule = client.GetQuotaRule(quota_rule_ref)
+
+    # Update labels
+    if labels_diff.MayHaveUpdates():
+      labels = labels_diff.Apply(
+          client.messages.QuotaRule.LabelsValue, original_quota_rule.labels
+      ).GetOrNone()
+    else:
+      labels = None
+
+    quota_rule = client.ParseUpdatedQuotaRuleConfig(
+        original_quota_rule,
+        disk_limit_mib=args.disk_limit_mib,
+        description=args.description,
+        labels=labels,
+    )
+
+    updated_fields = []
+    # add possible updated quota rule fields
+    # TODO(b/243601146) add config mapping and separate config file for update
+    if args.IsSpecified('description'):
+      updated_fields.append('description')
+    # Need a check for labels is not None. GetOrNone returns None if there are
+    # no updates to labels. If that's the case, make sure not to include the
+    # labels field in the field mask of the update command. Otherwise, it's
+    # possible to inadvertently clear the labels on the resource.
+    if (labels is not None) and (
+        args.IsSpecified('update_labels')
+        or args.IsSpecified('remove_labels')
+        or args.IsSpecified('clear_labels')
+    ):
+      updated_fields.append('labels')
+    if args.IsSpecified('disk_limit_mib'):
+      updated_fields.append('diskLimitMib')
+
+    update_mask = ','.join(updated_fields)
+    result = client.UpdateQuotaRule(
+        quota_rule_ref, quota_rule, update_mask, args.async_
+    )
+    if args.async_:
+      command = 'gcloud {} netapp volumes quota-rules list'.format(
+          self.ReleaseTrack().prefix
+      )
+      log.status.Print(
+          'Check the status of the updated quota rule by listing all quota'
+          ' rules:\n  $ {} '.format(command)
+      )
+    return result
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class UpdateBeta(Update):
+  """Update a Cloud NetApp Volume Quota Rule."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA