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

gcloud auth application-default login/google-cloud-sdk/lib/surface/dataplex/datascans/jobs/__init__.py

@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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 Dataplex Datascan Jobs services."""
+
+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.GA)
+class Jobs(base.Group):
+  """Manage Dataplex Datascan Jobs service."""
+
+  category = base.DATA_ANALYTICS_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/dataplex/datascans/jobs/describe.yaml

@@ -0,0 +1,42 @@
+- release_tracks: [ALPHA, GA]
+  help_text:
+    brief: |
+      Describe a Dataplex datascan job.
+    description: |
+      Describe a Dataplex datascan job.
+
+      Displays all details of a Dataplex job given a valid job ID.
+    examples: |
+      To describe a Dataplex job `test-job` running a datascan `test-datascan` in
+      location `us-central1`, run:
+
+      $ {command} test-job --location=us-central1 --datascan=test-datascan
+
+      To describe the details of Dataplex job `test-job` running a datascan `test-datascan` in
+      location `us-central1`, run:
+
+      $ {command} test-job --location=us-central1 --datascan=test-datascan --view=FULL
+  request:
+    ALPHA:
+      api_version: v1
+    collection: dataplex.projects.locations.dataScans.jobs
+    method: get
+  arguments:
+    resource:
+      help_text: |
+        Arguments and flags that define the Dataplex Job running a particular Datascan you want to retrieve.
+      spec: !REF googlecloudsdk.command_lib.dataplex.resources:datascanjob
+    params:
+    - arg_name: view
+      api_field: view
+      help_text: |
+        Displays spec and result data based on the argument value. The default view is 'basic'.
+      choices:
+      - enum_value: BASIC
+        arg_value: basic
+        help_text: |
+          Does not include spec and result data in response.
+      - enum_value: FULL
+        arg_value: full
+        help_text: |
+          Includes spec and result data in response.

gcloud auth application-default login/google-cloud-sdk/lib/surface/dataplex/datascans/jobs/list.yaml

@@ -0,0 +1,33 @@
+- release_tracks: [ALPHA, GA]
+  help_text:
+    brief: |
+      List job runs of a Dataplex datascan resource.
+    description: |
+      List Jobs runs of a Datascan under a specific project, location and task.
+
+    examples: |
+      To list all the Dataplex job runs for a datascan `test-datascan` in location
+      `us-central1`, run:
+
+        {command} --location=us-central1 --datascan=test-datascan
+
+  request:
+    ALPHA:
+      api_version: v1
+    collection: dataplex.projects.locations.dataScans.jobs
+  arguments:
+    resource:
+      help_text: |
+        Arguments and flags that define the Dataplex Datascan to list the Jobs running the Datascan.
+      spec: !REF googlecloudsdk.command_lib.dataplex.resources:datascan
+
+  response:
+    id_field: name
+  output:
+    format: |
+      table(
+        name.basename():label=JOB_ID,
+        state:label=JOB_STATUS,
+        startTime:label=START_TIME,
+        endTime:label=END_TIME
+      )