- release_tracks: [GA, BETA, ALPHA]
  help_text:
    brief: |
      List VPC Access connectors.
    description: |
      List all VPC Access connectors under the specified project and region.

      You can specify the maximum number of connectors to list using the
      `--limit` flag.
    examples: |
      The following command lists a maximum of five instances in us-central1:

          $ {command} --region=us-central1 --limit=5

  request:
    collection: vpcaccess.projects.locations.connectors
    api_version: v1
    BETA:
      api_version: v1beta1
    ALPHA:
      api_version: v1alpha1

  response:
    id_field: name

  arguments:
    resource:
      help_text: The region of the connectors to list.
      spec: !REF googlecloudsdk.command_lib.compute.networks.vpc_access.resources:region

  ALPHA:
    output:
      format: |
        table(
           name.basename():label=CONNECTOR_ID:sort=1,
           name.segment(3):label=REGION,
           network,
           ipCidrRange,
           subnet.name:label=SUBNET,
           subnet.projectId:label=SUBNET_PROJECT,
           machineType,
           minInstances,
           maxInstances,
           status
         )
  BETA:
    output:
      format: |
        table(
           name.basename():label=CONNECTOR_ID:sort=1,
           name.segment(3):label=REGION,
           network,
           ipCidrRange,
           subnet.name:label=SUBNET,
           subnet.projectId:label=SUBNET_PROJECT,
           machineType,
           minInstances,
           maxInstances,
           state
         )
  GA:
    output:
      format: |
        table(
           name.basename():label=CONNECTOR_ID:sort=1,
           name.segment(3):label=REGION,
           network,
           ipCidrRange,
           subnet.name:label=SUBNET,
           subnet.projectId:label=SUBNET_PROJECT,
           machineType,
           minInstances,
           maxInstances,
           minThroughput,
           maxThroughput,
           state
         )
