> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询 Network 列表



## OpenAPI

````yaml gpus/v2-spec/list-vpc.json GET /gpus/v2/networks
openapi: 3.0.0
info:
  title: PPIO GPU API v2
  version: 2.0.0
servers:
  - url: https://api.ppio.com
security: []
paths:
  /gpus/v2/networks:
    get:
      summary: 查询 Network 列表
      parameters:
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
          description: Bearer 身份验证格式,例如:Bearer `{{API 密钥}}`。
        - name: limit
          in: query
          required: false
          schema:
            type: integer
          description: 单页大小。整数,取值 >= 0。
          example: 10
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: 游标。字符串,长度限制:0-1024 字符。
          example: eyJpZCI6Im5ldHdvcmstMDAxIn0
        - name: name
          in: query
          required: false
          schema:
            type: string
          description: Network 名称过滤。字符串,长度限制:0-255 字符。
          example: dev-vpc
        - name: member_ids
          in: query
          required: false
          schema:
            type: string
          description: 成员 ID 过滤,多个用英文逗号分隔。字符串,长度限制:0-255 字符。
      responses:
        '200':
          description: 查询成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: Network 列表
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Network ID
                          example: network-abc123
                        owner_id:
                          type: string
                          description: 所有者 ID
                          example: user-abc123
                        name:
                          type: string
                          description: Network 名称
                          example: dev-vpc
                        status:
                          type: object
                          description: Network 状态
                          properties:
                            status:
                              type: string
                              description: 状态
                              example: running
                            error:
                              type: string
                              description: 错误码或错误类型
                              example: ''
                            message:
                              type: string
                              description: 错误信息
                              example: ''
                        cidr:
                          type: string
                          description: CIDR 网段
                          example: 10.0.0.0/24
                        region_id:
                          type: string
                          description: Region ID
                          example: cluster-abc123
                        instances:
                          type: array
                          description: 已分配实例列表
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                description: 实例 ID
                                example: instance-abc123
                              ip:
                                type: string
                                description: 实例 IP
                                example: 10.0.0.10
                        created_at:
                          type: integer
                          description: 创建时间。Unix 时间戳
                          example: 1710000000
                        member_id:
                          type: string
                          description: 成员 ID
                          example: 550e8400-e29b-41d4-a716-446655440000
                  next_cursor:
                    type: string
                    description: 下一页游标。无下一页时为空字符串
                    example: eyJpZCI6Im5ldHdvcmstYWJjMTIzIn0
                  has_more:
                    type: boolean
                    description: 是否还有下一页
                    example: true

````