> ## 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/get-image-prewarm.json GET /gpus/v2/prewarm-tasks/{task_id}
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/{task_id}:
    get:
      summary: 查询镜像预热任务详情
      parameters:
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
          description: Bearer 身份验证格式，例如：Bearer `{{API 密钥}}`。
        - name: task_id
          in: path
          required: true
          schema:
            type: string
          description: 镜像预热任务 ID。字符串,长度限制:1-255 字符。
      responses:
        '200':
          description: 查询成功
          content:
            application/json:
              schema:
                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
                        enum:
                          - pending
                          - running
                          - succeeded
                          - failed
                        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:
                      - ''

````