> ## 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.

# 查询镜像预热任务列表



## OpenAPI

````yaml gpus/v2-spec/list-image-prewarm.json GET /gpus/v2/prewarm-tasks
openapi: 3.0.0
info:
  title: PPIO GPU API v2
  version: 2.0.0
servers:
  - url: https://api.ppio.com
security: []
paths:
  /gpus/v2/prewarm-tasks:
    get:
      summary: 查询镜像预热任务列表
      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: eyJpZCI6InByZXdhcm0tdGFzay1pZCJ9
        - name: status
          in: query
          required: false
          schema:
            type: string
          description: 任务状态过滤。可选值:`pending`、`running`、`succeeded`、`failed`。留空字符串时不过滤。
          example: running
        - name: region_id
          in: query
          required: false
          schema:
            type: string
          description: 区域 ID 过滤。字符串,长度限制:0-255 字符。
          example: region-a
        - name: name
          in: query
          required: false
          schema:
            type: string
          description: 镜像名称或备注模糊搜索。字符串,长度限制:0-255 字符。
          example: image
      responses:
        '200':
          description: 查询成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: 镜像预热任务列表
                    items:
                      type: object
                      properties:
                        task_id:
                          type: string
                          description: 镜像预热任务 ID
                          example: prewarm-task-id
                        name:
                          type: string
                          description: 镜像名称
                          example: image:tag
                        image:
                          type: string
                          description: 镜像地址
                          example: registry.example.com/team/image:tag
                        region_id:
                          type: string
                          description: 区域 ID
                          example: region-a
                        product_ids:
                          type: array
                          items:
                            type: string
                          description: 预热覆盖的产品 ID 列表
                          example:
                            - product-a
                        image_size:
                          type: integer
                          description: 镜像大小。单位为 byte
                          example: 10737418240
                        created_at:
                          type: integer
                          description: 创建时间。Unix 时间戳
                          example: 1714982400
                        completed_at:
                          type: integer
                          description: 完成时间。Unix 时间戳;未完成时为 0
                          example: 0
                        status:
                          type: object
                          description: 任务状态
                          properties:
                            status:
                              type: string
                              description: 状态值。可选值:`pending`、`running`、`succeeded`、`failed`
                              example: running
                            error:
                              type: string
                              description: 错误码或错误类型
                              example: ''
                            message:
                              type: string
                              description: 状态说明或错误信息
                              example: ''
                        registry_auth_id:
                          type: string
                          description: 镜像仓库认证 ID
                          example: registry-auth-id
                        note:
                          type: string
                          description: 镜像预热任务备注
                          example: ''
                        reason:
                          type: array
                          items:
                            type: string
                          description: 镜像预热错误原因
                          example:
                            - ''
                  next_cursor:
                    type: string
                    description: 下一页游标。为空字符串表示无后续数据
                    example: eyJpZCI6Im5leHQtcGFnZSJ9
                  has_more:
                    type: boolean
                    description: 是否还有后续数据
                    example: true

````