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/posture_templates/__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 Cloud Security Command Center (SCC) posture templates."""
+
+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 PostureTemplates(base.Group):
+  """Manage Cloud Security Command Center (SCC) posture templates."""
+
+  category = base.SECURITY_CATEGORY

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

@@ -0,0 +1,38 @@
+- release_tracks: [ALPHA, GA]
+  help_text:
+    brief: Describe a Cloud Security Command Center (SCC) posture template.
+    description: |
+      Describe a Cloud Security Command Center (SCC) posture template.
+
+      By default, the latest created revision of the posture template is described. Users must provide revision ID to describe a specific revision.
+    examples: |
+      Describe a posture template named `organizations/123/locations/global/postureTemplates/secure_by_default` (i.e. a posture in organization `123`, location `global`, with id `secure_by_default`):
+
+        $ {command} organizations/123/locations/global/postureTemplates/secure_by_default
+
+      Describe a specific revision `v1.0.0` of posture template named `organizations/123/locations/global/postureTemplates/secure_by_default`:
+
+        $ {command} organizations/123/locations/global/postureTemplates/secure_by_default --revision-id=v1.0.0
+
+  request:
+    collection: securityposture.organizations.locations.postureTemplates
+    api_version: v1alpha
+    method: get
+    GA:
+      api_version: v1
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.scc.resources:posture_template
+      help_text: |
+          Posture template to be described. For example organizations/<organizationID>/locations/<location>/postureTemplates/<postureTemplateID>.
+
+    params:
+    - arg_name: revision-id
+      api_field: revisionId
+      required: false
+      help_text: |
+        ID of the specific posture template revision to be described. If not specified, latest revision is described.
+
+  output:
+    format: yaml

gcloud auth application-default login/google-cloud-sdk/lib/surface/scc/posture_templates/list.py

@@ -0,0 +1,177 @@
+# -*- 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 for listing an organization posture templates."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import print_function
+from __future__ import unicode_literals
+
+from apitools.base.py import list_pager
+from googlecloudsdk.api_lib.scc.postures import util as securityposture_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.scc import errors
+from googlecloudsdk.command_lib.scc import util as scc_util
+from googlecloudsdk.command_lib.scc.posture_templates import flags
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+@base.DefaultUniverseOnly
+class List(base.ListCommand):
+  """List the details of the Cloud Security Command Center (SCC) posture templates."""
+
+  detailed_help = {
+      "DESCRIPTION": """
+          List the details of the Cloud Security Command Center (SCC) posture
+          templates for the specified organization.""",
+      "EXAMPLES": """
+          To list Cloud Security Command Center posture templates for organization `123` and in the `global` location, run:
+
+            $ {command} organizations/123/locations/global
+
+            $ {command} --organization=123 --location=global
+
+            """,
+      "API REFERENCE": (
+          """
+      This command uses the securityposture/v1 API. The full documentation for
+    this API can be found at: https://cloud.google.com/security-command-center"""
+      ),
+  }
+
+  @staticmethod
+  def Args(parser):
+    # Remove URI flag.
+    base.URI_FLAG.RemoveFromParser(parser)
+
+    # Add shared flags and parent positional argument.
+    flags.AddParentOrFlagsGroup(parser)
+
+  def Run(self, args):
+    version = scc_util.GetVersionFromArguments(
+        args, version_specific_existing_resource=True
+    )
+
+    messages = securityposture_client.GetMessagesModule(base.ReleaseTrack.GA)
+    client = securityposture_client.GetClientInstance(base.ReleaseTrack.GA)
+
+    location = scc_util.ValidateAndGetLocation(args, version)
+
+    if (args.IsKnownAndSpecified("PARENT")) and (
+        args.IsSpecified("organization") and args.IsSpecified("location")
+    ):
+      raise errors.InvalidSCCInputError(
+          "Cannot provide both a positional `PARENT` and argument "
+          "(`--organization`, `--location`) flags."
+      )
+
+    if (args.IsKnownAndSpecified("PARENT")):
+      parent = args.PARENT
+    elif (args.IsSpecified("organization") and args.IsSpecified("location")):
+      parent = f"{scc_util.GetParentFromPositionalArguments(args)}/locations/{location}"
+    else:
+      raise errors.InvalidSCCInputError(
+          "Must provide either positional `PARENT` or both `--organization` "
+          "and `--location` flags."
+      )
+
+    # Build request.
+    request = messages.SecuritypostureOrganizationsLocationsPostureTemplatesListRequest(
+        parent=parent,
+        filter=getattr(args, "filter", None),
+        pageSize=getattr(args, "page_size", None),
+    )
+
+    return list_pager.YieldFromList(
+        client.organizations_locations_postureTemplates,
+        request,
+        batch_size_attribute="pageSize",
+        batch_size=args.page_size,
+        field="postureTemplates",
+    )
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+@base.DefaultUniverseOnly
+class ListAlpha(base.ListCommand):
+  """List the details of the Cloud Security Command Center (SCC) posture templates."""
+
+  detailed_help = {
+      "DESCRIPTION": """
+          List the details of the Cloud Security Command Center (SCC) posture
+          templates for the specified organization.""",
+      "EXAMPLES": """
+          To list Cloud Security Command Center posture templates for organization `123` and in the `global` location, run:
+
+            $ {command} organizations/123/locations/global
+
+            $ {command} --organization=123 --location=global
+
+            """,
+      "API REFERENCE": """
+      This command uses the securityposture/v1alpha API. The full documentation for this API can be found at:
+      https://cloud.google.com/security-command-center""",
+  }
+
+  @staticmethod
+  def Args(parser):
+    # Remove URI flag.
+    base.URI_FLAG.RemoveFromParser(parser)
+
+    # Add shared flags and parent positional argument.
+    flags.AddParentOrFlagsGroup(parser)
+
+  def Run(self, args):
+    version = scc_util.GetVersionFromArguments(
+        args, version_specific_existing_resource=True
+    )
+
+    messages = securityposture_client.GetMessagesModule(base.ReleaseTrack.ALPHA)
+    client = securityposture_client.GetClientInstance(base.ReleaseTrack.ALPHA)
+
+    location = scc_util.ValidateAndGetLocation(args, version)
+
+    if (args.IsKnownAndSpecified("PARENT")) and (
+        args.IsSpecified("organization") and args.IsSpecified("location")
+    ):
+      raise errors.InvalidSCCInputError(
+          "Cannot provide both a positional `PARENT` and argument "
+          "(`--organization`, `--location`) flags."
+      )
+
+    if (args.IsKnownAndSpecified("PARENT")):
+      parent = args.PARENT
+    elif (args.IsSpecified("organization") and args.IsSpecified("location")):
+      parent = f"{scc_util.GetParentFromPositionalArguments(args)}/locations/{location}"
+    else:
+      raise errors.InvalidSCCInputError(
+          "Must provide either positional `PARENT` or both `--organization` "
+          "and `--location` flags."
+      )
+
+    # Build request.
+    request = messages.SecuritypostureOrganizationsLocationsPostureTemplatesListRequest(
+        parent=parent,
+        filter=getattr(args, "filter", None),
+        pageSize=getattr(args, "page_size", None),
+    )
+
+    return list_pager.YieldFromList(
+        client.organizations_locations_postureTemplates,
+        request,
+        batch_size_attribute="pageSize",
+        batch_size=args.page_size,
+        field="postureTemplates",
+    )