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

gcloud auth application-default login/google-cloud-sdk/lib/surface/monitoring/metrics_scopes/__init__.py

@@ -0,0 +1,32 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 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.
+"""The command group for Cloud Monitoring Metrics Scopes."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class Web(base.Group):
+  """Manage Cloud Monitoring Metrics Scopes.
+
+  The {command} group lets you manage Monitoring metrics scopes.
+
+  More information on managing metrics scopes can be found here:
+  https://cloud.google.com/monitoring/settings/manage-api
+  """

gcloud auth application-default login/google-cloud-sdk/lib/surface/monitoring/metrics_scopes/create.py

@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 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 create a monitored project in a metrics scope."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.monitoring import metrics_scopes
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.monitoring import flags
+from googlecloudsdk.command_lib.monitoring import util as monitoring_util
+from googlecloudsdk.core import log
+
+
+class Create(base.CreateCommand):
+  """Create a monitored project in a metrics scope.
+
+  This command can fail for the following reasons:
+  * The projects specified do not exist.
+  * The active account does not have permission to access one of the given
+  project.
+  * The monitored project already exists in the metrics scope.
+
+  More details can be found at
+  https://cloud.google.com/monitoring/api/ref_v3/rest/v1/locations.global.metricsScopes.projects/create
+
+  ## EXAMPLES
+
+  The following command adds a monitored project with the ID
+  `monitored-project-1` to a metrics scope with project id `metrics-scope-1`
+  assuming the `metrics-scope-1` is the default project:
+
+    $ {command} projects/monitored-project-1
+
+  The following command adds a monitored project with the ID
+  `monitored-project-1` to a metrics scope with project id `metrics-scope-1`:
+
+    $ {command} projects/monitored-project-1 --project=metrics-scope-1
+    $ {command}
+    locations/global/metricsScopes/metrics-scope-1/projects/monitored-project-1
+  """
+
+  @staticmethod
+  def Args(parser):
+    flags.GetMonitoredResourceContainerNameFlag('create').AddToParser(parser)
+
+  def Run(self, args):
+    client = metrics_scopes.MetricsScopeClient()
+    metrics_scope_def, monitored_project_ref = (
+        monitoring_util.ParseMonitoredProject(
+            args.monitored_resource_container_name, True
+        )
+    )
+    result = client.Create(metrics_scope_def, monitored_project_ref)
+    log.CreatedResource(
+        client.MonitoredProjectName(metrics_scope_def, monitored_project_ref),
+        'monitored project')
+    return result

gcloud auth application-default login/google-cloud-sdk/lib/surface/monitoring/metrics_scopes/delete.py

@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 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 create a monitored project in a metrics scope."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.monitoring import metrics_scopes
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.monitoring import flags
+from googlecloudsdk.command_lib.monitoring import util as monitoring_util
+from googlecloudsdk.core import log
+
+
+class Delete(base.DeleteCommand):
+  """Delete a monitored project in a metrics scope.
+
+  This command can fail for the following reasons:
+  * The projects specified do not exist.
+  * The active account does not have permission to access one of the given
+  project.
+
+  More details can be found at
+  https://cloud.google.com/monitoring/api/ref_v3/rest/v1/locations.global.metricsScopes.projects/delete
+
+  ## EXAMPLES
+
+  The following command adds a monitored project with the ID
+  `monitored-project-1` to a metrics scope with project id `metrics-scope-1`
+  assuming the `metrics-scope-1` is the default project:
+
+    $ {command} projects/monitored-project-1
+
+  The following command adds a monitored project with the ID
+  `monitored-project-1` to a metrics scope with project id `metrics-scope-1`:
+
+    $ {command} projects/monitored-project-1 --project=metrics-scope-1
+    $ {command}
+    locations/global/metricsScopes/metrics-scope-1/projects/monitored-project-1
+  """
+
+  @staticmethod
+  def Args(parser):
+    flags.GetMonitoredResourceContainerNameFlag('delete').AddToParser(parser)
+
+  def Run(self, args):
+    client = metrics_scopes.MetricsScopeClient()
+    metrics_scope_ref, monitored_project_ref = (
+        monitoring_util.ParseMonitoredProject(
+            args.monitored_resource_container_name, True
+        )
+    )
+    result = client.Delete(metrics_scope_ref, monitored_project_ref)
+    log.DeletedResource(
+        client.MonitoredProjectName(metrics_scope_ref, monitored_project_ref),
+        'monitored project')
+    return result

gcloud auth application-default login/google-cloud-sdk/lib/surface/monitoring/metrics_scopes/describe.yaml

@@ -0,0 +1,28 @@
+- release_tracks: [ALPHA, BETA]
+  help_text:
+    brief: Describe a Cloud Monitoring metrics scope.
+    description: |
+      Describe a Cloud Monitoring metrics scope along with the list of projects it is monitoring.
+
+      More details can be found at https://cloud.google.com/monitoring/api/ref_v3/rest/v1/locations.global.metricsScopes/get
+    examples: |
+      To describe a metrics scope contained within a specific project, run:
+
+        $ {command} MY-METRICS-SCOPE-PROJECT-ID
+
+      To describe a metrics scope in JSON, run:
+
+        $ {command} MY-METRICS-SCOPE-PROJECT-ID --format=json
+
+      To describe a metrics scope with a fully qualified metrics scope ID, run:
+
+        $ {command} locations/global/metricsScopes/MY-METRICS-SCOPE-PROJECT-ID
+  arguments:
+    resource:
+      help_text: |
+        The metrics scope to describe.
+      is_positional: true
+      spec: !REF googlecloudsdk.command_lib.monitoring.resources:metrics_scope
+  request:
+    collection: monitoring.locations.global.metricsScopes
+    api_version: v1

gcloud auth application-default login/google-cloud-sdk/lib/surface/monitoring/metrics_scopes/list.py

@@ -0,0 +1,56 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 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 create a monitored project in a metrics scope."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.monitoring import metrics_scopes
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.monitoring import flags
+from googlecloudsdk.command_lib.monitoring import util as monitoring_util
+from googlecloudsdk.command_lib.projects import util as command_lib_util
+
+
+class List(base.ListCommand):
+  """List the metrics scopes monitoring the specified monitored resource container.
+
+  This command can fail for the following reasons:
+  * The projects specified do not exist.
+  * The active account does not have permission to access one of the given
+  project.
+
+  More details can be found at
+  https://cloud.google.com/monitoring/api/ref_v3/rest/v1/locations.global.metricsScopes/listMetricsScopesByMonitoredProject
+
+  ## EXAMPLES
+  To list the metrics scopes monitoring MY-PROJECT-ID
+
+  $ {command} projects/MY-PROJECT-ID
+  """
+
+  @staticmethod
+  def Args(parser):
+    flags.GetMonitoredResourceContainerNameFlag('list').AddToParser(parser)
+
+  def Run(self, args):
+    client = metrics_scopes.MetricsScopeClient()
+    _, resource_id = monitoring_util.ParseMonitoredResourceContainer(
+        args.monitored_resource_container_name, True
+    )
+    project_ref = command_lib_util.ParseProject(resource_id)
+    result = client.List(project_ref)
+    return result