- 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
