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

gcloud auth application-default login/google-cloud-sdk/lib/surface/scc/sources/__init__.py

@@ -0,0 +1,27 @@
+# -*- 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.
+"""Command group for Cloud SCC Sources."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+class Sources(base.Group):
+  """Manage Cloud SCC (Security Command Center) finding sources."""
+
+  category = base.SECURITY_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/scc/sources/describe.yaml

@@ -0,0 +1,54 @@
+- release_tracks: [ALPHA, BETA, GA]
+
+  # This command calls a list operation behind the scenes but we can't make command_type as list
+  # since it doesn't support any of the list-flags.
+  command_type: GENERIC
+  generic:
+    disable_paging_flags: true
+
+
+  help_text:
+    brief: Describe a source given its display name or source id.
+    description: Describe a source given its display name or source id.
+    examples: |
+      Describe source with display name `Security Scanner`:
+
+        $ {command} 123456 --source-display-name="Security Scanner"
+
+      Describe source with source id '5678':
+
+        $ {command} 123456 --source=5678
+
+  request:
+    collection: securitycenter.organizations.sources
+    api_version: v2
+    method: list
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.scc.sources.request_hooks:DescribeSourceReqHook
+
+  arguments:
+    additional_arguments_hook: googlecloudsdk.command_lib.scc.hooks:AppendParentArg
+
+    params:
+    - group:
+        mutex: true
+        required: true
+        params:
+        - arg_name: source
+          help_text: |
+            Cloud SCC specific source. It's derived from the the source's relative resource name.
+            See: https://cloud.google.com/apis/design/resource_names#relative_resource_name.
+            For Example: For the given source name: "organizations/123/sources/456", 456 represents
+            source id.
+        - arg_name: source-display-name
+          help_text: |
+            Source's display name must be unique amongst its siblings, for example, two sources
+            with the same parent can't share the same display name.
+            Display name must start and end with a letter or digit, may contain letters, digits,
+            spaces, hyphens, and underscores, and can be no longer than 32 characters. This is
+            captured by the regular expression: [\p{L}\p{N}]({\p{L}\p{N}_- ]{0,30}[\p{L}\p{N}])?.
+            For example: 'Cloud Security Scanner' is the source display name.
+
+  response:
+    modify_response_hooks:
+    - googlecloudsdk.command_lib.scc.sources.response_hooks:ExtractMatchingSourceFromResponse