跳转到主要内容
GET
/
gpus
/
v2
/
prewarm-tasks
/
{task_id}
查询镜像预热任务详情
curl --request GET \
  --url https://api.ppio.com/gpus/v2/prewarm-tasks/{task_id} \
  --header 'Authorization: <authorization>'
{
  "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": [
    ""
  ]
}

请求头

Authorization
string
必填

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

路径参数

task_id
string
必填

镜像预热任务 ID。字符串,长度限制:1-255 字符。

响应

200 - application/json

查询成功

task_id
string

镜像预热任务 ID

示例:

"prewarm-task-id"

name
string

镜像名称

示例:

"image:tag"

image
string

镜像地址

示例:

"registry.example.com/team/image:tag"

region_id
string

区域 ID

示例:

"region-a"

product_ids
string[]

预热覆盖的产品 ID 列表

示例:
["product-a"]
image_size
integer

镜像大小。单位为 byte

示例:

10737418240

created_at
integer

创建时间。Unix 时间戳

示例:

1714982400

completed_at
integer

完成时间。Unix 时间戳;未完成时为 0

示例:

0

status
object

任务状态

registry_auth_id
string

镜像仓库认证 ID

示例:

"registry-auth-id"

note
string

镜像预热任务备注

示例:

""

reason
string[]

镜像预热错误原因

示例:
[""]
最后修改于 2026年6月22日