重置系统或更换镜像

本接口用于重置指定边缘实例的操作系统或更换边缘实例的镜像。

接口说明

重置系统：

• 重置系统的实例需处于已停止（stop）状态。
• 重置系统后，所选实例的系统盘会恢复到创建时的状态。
• 如果您在创建实例时设置了自定义数据，重置系统过程中该数据会作为脚本再次执行。
• 重置系统后，系统盘现存的数据会丢失且无法找回。如需保留系统盘数据，您可以先创建镜像后再重置系统。

更换镜像：

• 需要更换镜像的实例需处于已停止（stop）状态。
• 您可以将一个 Linux 镜像更换为其他 Linux 镜像，或者将一个 Windows 镜像更换为其他 Windows 镜像。不允许一个 Linux 镜像与一个 Windows 镜像之间的更换。
• 如果您在创建实例时设置了自定义数据，该数据会在您更换镜像后作为脚本再次执行。如果新的镜像的类型或版本与原来的镜像不同，该脚本可能会执行失败。如有问题，请提交工单或联系客服人员。
• 更换镜像后，系统盘现存的数据会丢失且无法找回。如需保留系统盘数据，您可以先创建镜像后再更换镜像。
  

请求方法

POST

请求参数

下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。 其他公共参数，请参见公共参数。

返回数据

无

请求示例

POST https://veenedge.volcengineapi.com/?Action=BatchResetSystem&Version=2021-04-30
&<其他公共参数>
{
  "instance_identities": ["veen2011039290250111****"],
  "image_identity": "imagepnjk4y****"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2023053019313995C4E329528586DB****",
        "Action": "BatchResetSystem",
        "Version": "2021-04-30",
        "Service": "veenedge",
        "Region": "cn-north-1"
    }
}

错误码

如果响应正文中包含 Error 字段，则表示 API 请求失败。关于错误码的更多信息，参见错误码。