跳转到主要内容
POST
/
gpus
/
v2
/
prewarm-tasks
创建镜像预热任务
curl --request POST \
  --url https://api.ppio.com/gpus/v2/prewarm-tasks \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "image": "registry.example.com/team/image:tag",
  "region_id": "region-a",
  "registry_auth_id": "registry-auth-id",
  "product_ids": [
    "product-a",
    "product-b"
  ],
  "note": ""
}
'
{
  "task_id": "prewarm-task-id"
}

请求头

Content-Type
string
必填

枚举值:application/json。

Authorization
string
必填

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

请求体

application/json
image
string
必填

需要预热的完整镜像地址。字符串,长度限制:1-4095 字符。

示例:

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

region_id
string
必填

预热目标区域 ID。字符串,长度限制:1-255 字符。

示例:

"region-a"

registry_auth_id
string

镜像仓库认证 ID。预热私有镜像时需要。字符串,长度限制:0-255 字符。

示例:

"registry-auth-id"

product_ids
string[]

需要预热覆盖的产品 ID 列表。

示例:
["product-a", "product-b"]
note
string

镜像预热任务备注。

示例:

""

响应

200 - application/json

创建成功

task_id
string

镜像预热任务 ID

示例:

"prewarm-task-id"

最后修改于 2026年6月22日