跳转到主要内容
GET
/
gpus
/
v2
/
prewarm-tasks
查询镜像预热任务列表
curl --request GET \
  --url https://api.ppio.com/gpus/v2/prewarm-tasks \
  --header 'Authorization: <authorization>'
{
  "data": [
    {
      "task_id": "prewarm-task-id",
      "name": "image:tag",
      "image": "registry.example.com/team/image:tag",
      "region_id": "region-a",
      "product_ids": [
        "product-a"
      ],
      "image_size": 10737418240,
      "created_at": 1714982400,
      "completed_at": 0,
      "status": {
        "status": "running",
        "error": "",
        "message": ""
      },
      "registry_auth_id": "registry-auth-id",
      "note": "",
      "reason": [
        ""
      ]
    }
  ],
  "next_cursor": "eyJpZCI6Im5leHQtcGFnZSJ9",
  "has_more": true
}

请求头

Authorization
string
必填

Bearer 身份验证格式,例如:Bearer {{API 密钥}}

查询参数

limit
integer

本次返回数量上限。整数,取值 >= 0。

cursor
string

上一页响应返回的游标,首次请求留空。字符串,长度限制:0-1024 字符。

status
string

任务状态过滤。可选值:pendingrunningsucceededfailed。留空字符串时不过滤。

region_id
string

区域 ID 过滤。字符串,长度限制:0-255 字符。

name
string

镜像名称或备注模糊搜索。字符串,长度限制:0-255 字符。

响应

200 - application/json

查询成功

data
object[]

镜像预热任务列表

next_cursor
string

下一页游标。为空字符串表示无后续数据

示例:

"eyJpZCI6Im5leHQtcGFnZSJ9"

has_more
boolean

是否还有后续数据

示例:

true

最后修改于 2026年6月22日