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

gcloud auth application-default login/google-cloud-sdk/lib/surface/endpoints/quota/__init__.py

@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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.
+"""Package for the endpoints/quota CLI subcommands."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Quota(base.Group):
+  """Manage service consumer quota."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/endpoints/quota/create.py

@@ -0,0 +1,116 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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 command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.services import scm
+from googlecloudsdk.api_lib.services import services_util
+from googlecloudsdk.calliope import arg_parsers
+from googlecloudsdk.calliope import base
+
+
+class Create(base.SilentCommand):
+  """Create a quota override for a consumer.
+
+  This command creates a quota override for a consumer. The supported
+  consumers are projects, folders, and organizations.
+
+  ## EXAMPLES
+
+  To create a quota override for a project with project number, run:
+
+    $ {command} --service=example.googleapis.com --consumer=projects/12321
+    --metric=example.googleapis.com/default_requests
+    --unit=1/min/{project} --value=360
+
+  To create a quota override for a project with project ID, run:
+
+    $ {command} --service=example.googleapis.com --consumer=projects/hello
+    --metric=example.googleapis.com/default_requests
+    --unit=1/min/{project} --value=360
+
+  To create a quota override for an organization, run:
+
+    $ {command} --service=example.googleapis.com --consumer=organizations/555
+    --metric=example.googleapis.com/default_requests
+    --unit=1/min/{project} --value=360
+
+  To force the creation of a quota override with dimensions, run:
+
+    $ {command} --service=example.googleapis.com --consumer=projects/12321
+    metric=example.googleapis.com/default_requests
+    --unit=1/min/{project} --dimensions=regions=us-central1
+    --dimensions=zones=us-central1-c --value=360 --force
+  """
+
+  @staticmethod
+  def Args(parser):
+    """Args is called by calliope to gather arguments for this command.
+
+    Args:
+      parser: An argparse parser that you can use to add arguments that go on
+        the command line after this command. Positional arguments are allowed.
+    """
+    parser.add_argument(
+        '--service',
+        required=True,
+        help='The service to create a quota override for.')
+    parser.add_argument(
+        '--consumer',
+        required=True,
+        help='The consumer to create a quota override for.')
+    parser.add_argument(
+        '--metric',
+        required=True,
+        help='The metric to create a quota override for.')
+    parser.add_argument(
+        '--unit',
+        required=True,
+        help='The unit of a metric to create a quota override for.')
+    parser.add_argument(
+        '--dimensions',
+        type=arg_parsers.ArgDict(),
+        metavar='KEY=VALUE',
+        action=arg_parsers.UpdateAction,
+        help='The dimensions of the override, e.g. for specific locations.')
+    parser.add_argument(
+        '--value', type=int, required=True, help='The value of the override.')
+    parser.add_argument(
+        '--force',
+        action='store_true',
+        default=False,
+        help='Force override creation even if the change results in a '
+        'substantial decrease in available quota.')
+
+  def Run(self, args):
+    """Run 'endpoints quota create'.
+
+    Args:
+      args: argparse.Namespace, The arguments that this command was invoked
+        with.
+
+    Returns:
+      Nothing.
+    """
+    op = scm.UpdateQuotaOverrideCall(args.service, args.consumer, args.metric,
+                                     args.unit, args.dimensions, args.value,
+                                     args.force)
+    if op.done:
+      return
+    op = services_util.WaitOperation(op.name, scm.GetOperation)
+    services_util.PrintOperation(op)

gcloud auth application-default login/google-cloud-sdk/lib/surface/endpoints/quota/delete.py

@@ -0,0 +1,110 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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 command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.services import scm
+from googlecloudsdk.api_lib.services import services_util
+from googlecloudsdk.calliope import base
+
+
+class Delete(base.SilentCommand):
+  """Delete a quota override for a consumer.
+
+  This command deletes a quota override for a consumer. The supported consumers
+  are projects, folders, and organizations. The override ID can be found from
+  list command output.
+
+  ## EXAMPLES
+
+  To delete a quota override for a project with project number, run:
+
+    $ {command} --service=example.googleapis.com --consumer=projects/12321
+      --metric=example.googleapis.com/default_requests
+      --unit=1/min/{project}
+
+  To delete a quota override for a project with project ID, run:
+
+    $ {command} --service=example.googleapis.com --consumer=projects/hello
+      --metric=example.googleapis.com/default_requests
+      --unit=1/min/{project}
+
+  To delete a quota override for an organization, run:
+
+    $ {command} --service=example.googleapis.com --consumer=organizations/555
+      --metric=example.googleapis.com/default_requests
+      --unit=1/min/{project}
+
+  To force the deletion of a quota override, run:
+
+    $ {command} --service=example.googleapis.com --consumer=projects/12321
+      --metric=example.googleapis.com/default_requests
+      --unit=1/min/{project} --force
+  """
+
+  @staticmethod
+  def Args(parser):
+    """Args is called by calliope to gather arguments for this command.
+
+    Args:
+      parser: An argparse parser that you can use to add arguments that go on
+        the command line after this command. Positional arguments are allowed.
+    """
+    parser.add_argument(
+        '--service',
+        required=True,
+        help='The service to delete a quota override for.')
+    parser.add_argument(
+        '--consumer',
+        required=True,
+        help='The consumer to delete a quota override for.')
+    parser.add_argument(
+        '--metric',
+        required=True,
+        help='The metric to delete a quota override for.')
+    parser.add_argument(
+        '--unit',
+        required=True,
+        help='The unit of a metric to delete a quota override for.')
+    parser.add_argument(
+        '--override-id',
+        required=True,
+        help='The override ID of the override previous created.')
+    parser.add_argument(
+        '--force',
+        action='store_true',
+        default=False,
+        help='Force override deletion even if the change results in a '
+        'substantial decrease in available quota.')
+
+  def Run(self, args):
+    """Run 'endpoints quota delete'.
+
+    Args:
+      args: argparse.Namespace, The arguments that this command was invoked
+        with.
+
+    Returns:
+      Nothing.
+    """
+    op = scm.DeleteQuotaOverrideCall(args.service, args.consumer, args.metric,
+                                     args.unit, args.override_id, args.force)
+    if op.done:
+      return
+    op = services_util.WaitOperation(op.name, scm.GetOperation)
+    services_util.PrintOperation(op)

gcloud auth application-default login/google-cloud-sdk/lib/surface/endpoints/quota/list.py

@@ -0,0 +1,101 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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.
+"""services list command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.services import scm
+from googlecloudsdk.calliope import base
+
+
+class List(base.ListCommand):
+  """List service quota metrics for a consumer.
+
+  This command lists the service quota metrics for a consumer. The supported
+  consumers can be projects, folders, or organizations.
+
+  ## EXAMPLES
+
+  To list the quota metrics for service 'example.googleapis.com' and consumer
+  'projects/12321', run:
+
+    $ {command} --service=example.googleapis.com --consumer=projects/12321
+
+  To list the quota metrics for service 'example.googleapis.com' and consumer
+  'projects/hello-world', run:
+
+    $ {command} --service=example.googleapis.com --consumer=projects/helloworld
+
+  To list the quota metrics for service 'example.googleapis.com' and consumer
+  'folders/12345', run:
+
+    $ {command} --service=example.googleapis.com --consumer=folders/12345
+
+  To list the quota metrics for service 'example.googleapis.com' and consumer
+  'organizations/54321', run:
+
+    $ {command} --service=example.googleapis.com --consumer=folders/54321
+  """
+
+  @staticmethod
+  def Args(parser):
+    """Args is called by calliope to gather arguments for this command.
+
+    Args:
+      parser: An argparse parser that you can use to add arguments that go on
+        the command line after this command. Positional arguments are allowed.
+    """
+    parser.add_argument(
+        '--service',
+        required=True,
+        metavar='SERVICE',
+        help='The service to list metrics for.')
+
+    parser.add_argument(
+        '--consumer',
+        required=True,
+        metavar='CONSUMER',
+        help='The consumer to list metrics for.')
+
+  def Run(self, args):
+    """Run command.
+
+    Args:
+      args: argparse.Namespace, The arguments that this command was invoked
+        with.
+
+    Returns:
+      The list of quota metrics for the service and consumer.
+    """
+    metrics = scm.ListQuotaMetrics(args.service, args.consumer, args.page_size,
+                                   args.limit)
+    return [self.delete_resource_name(m) for m in metrics]
+
+  @staticmethod
+  def delete_resource_name(metric):
+    """Delete the name fields from metric message.
+
+    Args:
+      metric: The quota metric message.
+
+    Returns:
+      The updated metric message.
+    """
+    metric.reset('name')
+    for l in metric.consumerQuotaLimits:
+      l.reset('name')
+    return metric

gcloud auth application-default login/google-cloud-sdk/lib/surface/endpoints/quota/update.py

@@ -0,0 +1,118 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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.
+"""update command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.services import scm
+from googlecloudsdk.api_lib.services import services_util
+from googlecloudsdk.calliope import arg_parsers
+from googlecloudsdk.calliope import base
+
+
+class Update(base.SilentCommand):
+  """Update a quota override for a consumer.
+
+  This command updates a quota override for a consumer. The supported consumers
+  are projects, folders, and organizations. The override ID can be
+  found from list command output.
+
+  ## EXAMPLES
+
+  To update a quota override for project with project number, run:
+
+    $ {command} --service=example.googleapis.com --consumer=projects/12321
+      --metric=example.googleapis.com/default_requests
+      --unit=1/min/{project} --override-id=hello123 --value=360
+
+  To update a quota override for project with project ID, run:
+
+    $ {command} --service=example.googleapis.com --consumer=projects/hello
+      --metric=example.googleapis.com/default_requests
+      --unit=1/min/{project} --override-id=hello123 --value=360
+
+  To update a quota override for an organization, run:
+
+    $ {command} --service=example.googleapis.com --consumer=organizations/555
+      --metric=example.googleapis.com/default_requests
+      --unit=1/min/{project} --override-id=hello123 --value=360
+
+  To force the update of a quota override, run:
+
+    $ {command} --service=example.googleapis.com --consumer=projects/12321
+      --metric=example.googleapis.com/default_requests
+      --unit=1/min/{project}  --override-id=hello123
+      --dimensions=regions=us-central1
+      --dimensions=zones=us-central1-c --value=360 --force
+  """
+
+  @staticmethod
+  def Args(parser):
+    """Args is called by calliope to gather arguments for this command.
+
+    Args:
+      parser: An argparse parser that you can use to add arguments that go on
+        the command line after this command. Positional arguments are allowed.
+    """
+    parser.add_argument(
+        '--service',
+        required=True,
+        help='The service to update a quota override for.')
+    parser.add_argument(
+        '--consumer',
+        required=True,
+        help='The consumer to update override for.')
+    parser.add_argument(
+        '--metric',
+        required=True,
+        help='The metric to update a quota override for.')
+    parser.add_argument(
+        '--unit',
+        required=True,
+        help='The unit of a metric to update a quota override for.')
+    parser.add_argument(
+        '--dimensions',
+        type=arg_parsers.ArgDict(),
+        metavar='KEY=VALUE',
+        action=arg_parsers.UpdateAction,
+        help='The dimensions of the override, e.g. for specific locations.')
+    parser.add_argument(
+        '--value', type=int, required=True, help='The value of the override.')
+    parser.add_argument(
+        '--force',
+        action='store_true',
+        default=False,
+        help='Force override update even if the change results in a '
+        'substantial decrease in available quota.')
+
+  def Run(self, args):
+    """Run 'endpoints quota update'.
+
+    Args:
+      args: argparse.Namespace, The arguments that this command was invoked
+        with.
+
+    Returns:
+      Nothing.
+    """
+    op = scm.UpdateQuotaOverrideCall(args.service, args.consumer, args.metric,
+                                     args.unit, args.dimensions, args.value,
+                                     args.force)
+    if op.done:
+      return
+    op = services_util.WaitOperation(op.name, scm.GetOperation)
+    services_util.PrintOperation(op)