跳转到主要内容
POST
/
gpus
/
v2
/
jobs
/
save-image
保存镜像
curl --request POST \
  --url https://api.ppio.com/gpus/v2/jobs/save-image \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "instance_id": "instance-id",
  "image": "registry.example.com/team/image:tag",
  "registry_auth_id": "registry-auth-id"
}
'
{
  "job_id": "job-id"
}

请求头

Content-Type
string
必填

枚举值:application/json。

Authorization
string
必填

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

请求体

application/json
instance_id
string
必填

实例 ID。字符串,长度限制:1-255 字符。

示例:

"instance-id"

image
string
必填

目标镜像名称或地址。字符串,长度限制:1-4095 字符。

示例:

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

registry_auth_id
string

已保存的镜像仓库认证 ID。字符串,长度限制:0-255 字符。

示例:

"registry-auth-id"

响应

200 - application/json

OK

job_id
string

保存镜像任务 ID。可调用查询 Job 详情接口轮询状态

示例:

"job-id"

最后修改于 2026年6月22日