跳转到主要内容
POST
https://api.ppinfra.com
/
gpu-instance
/
openapi
/
v1
/
job
/
save
/
image
保存镜像
curl --request POST \
  --url https://api.ppinfra.com/gpu-instance/openapi/v1/job/save/image \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "instanceId": "<string>",
  "image": "<string>",
  "registryAuthId": "<string>"
}
'
{
  "jobId": "<string>"
}

​
请求头

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

​
请求体

​
instanceId
string
必填
实例 ID。长度范围：1-255。
​
image
string
必填
镜像地址。长度范围：1-4095。
​
registryAuthId
string
镜像仓库认证 ID。长度范围：0-255。

​
示例

curl --location --request POST 'https://api.ppinfra.com/gpu-instance/openapi/v1/job/save/image' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{API_KEY}}' \
--data-raw '{
    "instanceId": "079ac83991562f00",
    "image": "image.ppinfra.com/pukcnedkqkioyhnxrawo/20250909:v1",
    "registryAuthId": "8ba75437-0b83-4966-a775-0fb862081c4d"
}'

​
响应参数

​
jobId
string
必填
异步任务 ID，可在控制台 → 任务管理中查询镜像保存任务状态与日志。

​
响应示例

{
  "jobId": "0uplnmmbd1ggdaxu"
}