- release_tracks: [ALPHA, BETA, GA]
  help_text:
    brief: Describe a fleet scope.
    description: Describe a Fleet Scope.
    examples: |
      First retrieve the ID of the scope using the command below. The output of this command
      lists all the fleet's members, with their unique IDs in the Names column:

        $ {parent_command} list

      Then describe it:

        $ {command} SCOPE_NAME

  request:
    collection: gkehub.projects.locations.scopes
    ALPHA:
      api_version: v1alpha
    BETA:
      api_version: v1beta
    GA:
      api_version: v1

  response:
    modify_response_hooks:
    - googlecloudsdk.command_lib.container.fleet.scopes.rollout_sequencing.util:DescribeClusterUpgrade

  arguments:
    resource:
      help_text: The scope to describe.
      spec: !REF googlecloudsdk.command_lib.container.fleet.resources:scope

    params:
    - group:
        release_tracks: [ALPHA]
        mutex: true
        help_text: Rollout Sequencing
        params:
        - arg_name: show-cluster-upgrade
          type: bool
          help_text: |
            Shows the cluster upgrade feature information for the current scope.

            To view the cluster upgrade feature information for ``SCOPE_NAME'', run:

              $ {command} SCOPE_NAME --show-cluster-upgrade
        - arg_name: show-linked-cluster-upgrade
          type: bool
          help_text: |
            Shows the cluster upgrade feature information for the current scope as well as
            information for all other scopes linked in the same rollout sequence (provided that the
            caller has permission to view the upstream and downstream scopes that exist in other
            fleets). This displays cluster upgrade information for scopes in the current scope's
            rollout sequence in order of furthest upstream to downstream.

            To view the cluster upgrade feature information for the rollout sequence containing
            ``SCOPE_NAME'', run:

              $ {command} SCOPE_NAME --show-linked-cluster-upgrade