You need to enable JavaScript to run this app.
最新活动
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们
导航

重置系统或更换镜像

最近更新时间2023.07.11 14:31:16

首次发布时间2023.03.24 15:51:06

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

接口说明

重置系统:

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

更换镜像:

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

请求方法

POST

请求参数

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

名称

类型

是否必选

示例值

描述

Action

String

BatchResetSystem

公共参数。该参数表示接口名称。取值:BatchResetSystem。

Version

String

2021-04-30

公共参数。该参数表示接口版本。取值:2021-04-30。

instance_identities

[]String

["veen1020125208252511****"]

边缘实例 ID 列表。您可以通过 ListInstances 接口查询边缘实例 ID。

image_identity

String

image****

新镜像的 ID。您可以通过 ListImages 接口查询镜像 ID。
该参数用于为边缘实例更换镜像。如果您不指定该参数的值,代表不更换边缘实例的镜像。

返回数据


请求示例

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 请求失败。关于错误码的更多信息,参见错误码