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

使用说明 #

重置系统时，请您注意以下事项：

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

更换镜像，请您注意以下事项：

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

请求说明 #

• 请求方式：POST
• 请求地址：https://veenedge.volcengineapi.com/?Action=BatchResetSystem&Version=2021-04-30

请求参数 #

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

Query #

Body #

返回参数 #

下表仅列出本接口特有的返回参数。更多信息请参见返回结果。

请求示例 #

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

返回示例 #

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

错误码 #

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