跳转到主要内容
GET
/
gpu-instance
/
openapi
/
v1
/
image
/
prewarm
获取镜像预热任务列表
curl --request GET \
  --url https://api.ppio.com/gpu-instance/openapi/v1/image/prewarm \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>'
{
  "data": [
    {
      "id": "<string>",
      "imageName": "<string>",
      "imageUrl": "<string>",
      "repositoryAuth": "<string>",
      "clusterId": "<string>",
      "clusterName": "<string>",
      "products": [
        {
          "productId": "<string>",
          "productName": "<string>"
        }
      ],
      "imageSize": "<string>",
      "createTime": "<string>",
      "state": "<string>",
      "completeTime": "<string>",
      "note": "<string>",
      "reason": {}
    }
  ],
  "total": 123
}

​
请求头

​
Content-Type
string
必填
枚举值：application/json。
​
Authorization
string
必填
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。

​
查询参数

​
page
integer
页码，默认 1。
​
pageSize
integer
每页数量，默认 10。
​
state
string
预热任务状态。可选值：
  • Pending：待处理
  • Running：进行中
  • Succeeded：成功
  • Failed：失败
​
clusterId
string
集群 ID。
​
name
string
镜像名或任务备注。

​
示例

curl --location --request GET 'https://api.ppio.com/gpu-instance/openapi/v1/image/prewarm' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{API_KEY}}'

​
响应参数

​
data
object[]
必填
任务列表。
​
total
integer
必填
任务总数。

​
响应示例

{
  "data": [
    {
      "id": "nzd5nyi4keefsv2d",
      "imageName": "nginx",
      "imageUrl": "nginx",
      "clusterId": "cn-dev-1",
      "clusterName": "v2测试(cn-dev-1)",
      "products": [],
      "imageSize": "72298048",
      "createTime": "1757656178",
      "state": "Succeeded",
      "completeTime": "1757656207",
      "note": "",
      "reason": [],
      "repositoryAuth": ""
    },
    {
      "id": "fexahnwdp4l1ajva",
      "imageName": "pytorch",
      "imageUrl": "test-image.ppinfra.com/test-public/pytorch:v2",
      "clusterId": "cn-dev-1",
      "clusterName": "v2测试(cn-dev-1)",
      "products": [
        {
          "productId": "4090.18c.60g.18c60g",
          "productName": "RTX 4090 24GB 18c"
        }
      ],
      "imageSize": "6762128493",
      "createTime": "1756361365",
      "state": "Succeeded",
      "completeTime": "1756361371",
      "note": "",
      "reason": [
        "image pulled successfully"
      ],
      "repositoryAuth": ""
    }
  ],
  "total": 2
}
最后修改于 2026年6月10日