响应参数
4.2.2 切换弹性云服务器操作系统（安装 Cloud-init）
}
● 请求示例2（使用密钥方式远程登录重装后的系统）
{ "os-reinstall": {
"keyname": "KeyPair-350b",
"userid": "7e25b1da389f4697a79df3a0e5bd494e"
} }
响应示例
请参考响应（任务类）。
返回值
请参考通用请求返回值。
错误码
请参考错误码。
4.2.2 切换弹性云服务器操作系统（安装 Cloud-init）
功能介绍
切换弹性云服务器操作系统。支持弹性云服务器数据盘不变的情况下，使用新镜像重 装系统盘。
调用该接口后，系统将卸载系统盘，然后使用新镜像重新创建系统盘，并挂载至弹性 云服务器，实现切换操作系统功能。
接口约束
● 该接口仅支持安装了Cloud-init或Cloudbase-init的镜像。如果镜像未安装Cloud-init或者Cloudbase-init，请使用 切换弹性云服务器操作系统（未安装Cloud-init）接口。
● 不包含系统盘的弹性云服务器不能切换操作系统。
● 执行切换操作系统任务时，请勿并行执行其他任务，否则可能会引起切换操作系 统失败。
URI
POST /v2/{project_id}/cloudservers/{server_id}/changeos 参数说明请参见表4-36。
表4-36 参数说明
参数 是否必选 描述
project_id 是 项目ID。
获取方法请参见获取项目ID。
server_id 是 弹性云服务器ID。
请求消息
请求参数如表4-37所示。
表4-37 请求参数
参数 是否必选 参数类型 描述
os-change 是 Object 切换弹性云服务器操作系统，详情参见 表4-38。
表4-38 os-change 字段数据结构说明
参数 是否必选 参数类型 描述
adminpass 否 String 云服务器管理员帐户的初始登录密码。
其中，Windows管理员帐户的用户名
keyname 否 String 密钥名称。
密钥可以通过密钥创建接口进行创建 创建和导入SSH密钥（请参见），或使 用SSH密钥查询接口查询已有的密钥
（请参见查询SSH密钥列表 ）。
userid 否 String 用户ID。当传入keyname参数时，优先 使用本参数设置的userid，若userid为
imageid 是 String 切换系统所使用的新镜像的ID，格式为 UUID。
镜像的ID可以从控制台或者参考《镜像 服务API参考》的“查询镜像列表”的 章节获取。
参数 是否必选 参数类型 描述
metadata 否 Object 切换云服务器的元数据。
更多信息，请参见表4-39。
mode 否 String 取值为withStopServer ，支持开机状 态下切换弹性云服务器操作系统。
mode取值为withStopServer时，对开 机状态的弹性云服务器执行切换操作系 统操作，系统自动对云服务器先执行关 机，再切换操作系统。
表4-39 metadata 字段数据结构说明
参数 是否必选 参数类型 描述
user_data 否 String 创建云服务器过程中待注入实例自定义 数据。支持注入文本、文本文件。
说明
● user_data的值为base64编码之后的内 容。
● 注入内容（编码之前的内容）最大长度 为32K。
了解更多实例自定义数据注入请参考用 户数据注入。
示例：
base64编码前：
● Linux服务器：
#! /bin/bash
echo user_test >> /home/user.txt
● Windows服务器：
rem cmd
echo 111 > c:\aaa.txt
base64编码后：
● Linux服务器：
IyEgL2Jpbi9iYXNoDQplY2hvIHVzZXJfdGVzdC AmZ3Q7Jmd0OyAvaG9tZS91c2VyLnR4dA==
● Windows服务器：
cmVtIGNtZA0KZWNobyAxMTEgJmd0OyBjOl xhYWEudHh0
响应消息
请参考响应（任务类）。
请求示例
● 请求URL示例
POST https://{endpoint}/v2/{project_id}/cloudservers/{server_id}/changeos
● 请求示例1（使用密码方式远程登录重装后的系统）
{ "os-change": {
"adminpass": "1qazXSW@",
"userid": "7e25b1da389f4697a79df3a0e5bd494e", "imageid": "e215580f-73ad-429d-b6f2-5433947433b0", "mode": "withStopServer"
} }
● 请求示例2（使用密钥方式远程登录重装后的系统）
{ "os-change": {
"keyname": "KeyPair-350b",
"userid": "7e25b1da389f4697a79df3a0e5bd494e", "imageid": "e215580f-73ad-429d-b6f2-5433947433b0"
} }
响应示例
请参考响应（任务类）。
返回值
请参考通用请求返回值。
错误码
请参考错误码。