> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 保存镜像

## 请求头

<ParamField header="Content-Type" type="string" required={true}>
  枚举值：application/json。
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式，例如：Bearer \{\{API 密钥}}。
</ParamField>

## 请求体

<ParamField body="instanceId" type="string" required={true}>
  实例 ID。长度范围：1-255。
</ParamField>

<ParamField body="image" type="string" required={true}>
  镜像地址。长度范围：1-4095。
</ParamField>

<ParamField body="registryAuthId" type="string" required={true}>
  镜像仓库认证 ID。长度范围：0-255。

  <Expandable title="说明" defaultOpen={false}>
    * 镜像仓库认证信息可在「控制台 → 安全凭证管理 → 镜像仓库认证信息」中管理和查询。
    * 上传到公共镜像仓库或平台提供的镜像仓库时无需填写。
    * 上传到第三方私有镜像仓库时需填写。
  </Expandable>
</ParamField>

## 示例

```bash theme={null}
curl --location --request POST 'https://api.ppio.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"
}'
```

## 响应参数

<ResponseField name="jobId" type="string" required={true}>
  异步任务 ID，可在控制台 → 任务管理中查询镜像保存任务状态与日志。
</ResponseField>

## 响应示例

```json theme={null}
{
  "jobId": "0uplnmmbd1ggdaxu"
}
```