- release_tracks: [ALPHA, GA]
  help_text:
    brief: Describe a Cloud Security Command Center (SCC) posture.
    description: |
      Describe a Cloud Security Command Center (SCC) posture.

      By default, the latest updated revision of the posture is described. Users must provide revision ID to describe a specific revision.
    examples: |
      Describe the latest updated revision of a posture named `organizations/123/locations/global/postures/posture-foo-1` (i.e. a posture in organization `123`, location `global`, with id `posture-foo-1`):

        $ {command} organizations/123/locations/global/postures/posture-foo-1

      Describe a specific revision `abcdefg` of posture named `organizations/123/locations/global/postures/posture-foo-1`:

        $ {command} organizations/123/locations/global/postures/posture-foo-1 --revision-id=abcdefg

  request:
    collection: securityposture.organizations.locations.postures
    api_version: v1alpha
    method: get
    GA:
      api_version: v1

  arguments:
    resource:
      spec: !REF googlecloudsdk.command_lib.scc.resources:posture
      help_text: |
          The posture to be described. For example organizations/<organizationID>/locations/<location>/postures/<postureID>.

    params:
    - arg_name: revision-id
      api_field: revisionId
      required: false
      help_text: |
        ID of the specific posture revision to described. If not specified, latest revision is described.

  output:
    format: yaml