project_id

是

项目ID。

获取方法请参见获取项目ID。

server_id

是

弹性云服务器ID。

os-change

是

Object

切换弹性云服务器操作系统，详情参见表3。

adminpass

否

String

云服务器管理员帐户的初始登录密码。

其中，Windows管理员帐户的用户名为Administrator，Linux管理员账户的用户名为root。

建议密码复杂度如下：

长度为8-26位。
密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%^-_=+[{}]:,./?~#*）中的三种。

说明：

Windows云服务器的密码，不能包含用户名或用户名的逆序，不能包含用户名中超过两个连续字符的部分。
对于Linux弹性云服务器也可使用user_data字段实现密码注入，此时adminpass字段无效。
adminpass和keyname不能同时有值。
adminpass和keyname如果同时为空，此时，linux可使用metadata中的user_data。
仅在使用私有镜像密码或切换后设置密码的场景，adminpass、keyname和metadata中的user_data属性值可以同时为空，且有以下约束条件：

Windows操作系统不支持使用私有镜像密码。

如需在切换后设置密码，需确保镜像__os_feature_list字段必须含有{“onekey_resetpasswd”: “true”}，请在切换后重置云服务器密码。

对于已安装Cloud-init的云服务器，使用adminpass字段切换操作系统时，系统如果提示您使用keypair方式切换操作系统，表示当前区域暂不支持使用密码方式。

keyname

否

String

密钥名称。

密钥可以通过密钥创建接口进行创建 创建和导入SSH密钥（请参见），或使用SSH密钥查询接口查询已有的密钥（请参见查询SSH密钥列表 ）。

userid

否

String

用户ID。当传入keyname参数时，优先使用本参数设置的userid，若userid为空，默认使用当前token中的userid。

查看用户ID方法：

登录管理控制台。
单击用户名，在下拉列表中单击“我的凭证”。在该页面查看IAM用户ID。

imageid

是

String

切换系统所使用的新镜像的ID，格式为UUID。

镜像的ID可以从控制台或者参考《镜像服务API参考》的“查询镜像列表”的章节获取。

metadata

否

Object

切换云服务器的元数据。

更多信息，请参见表4。

mode

否

String

取值为withStopServer ，支持开机状态下切换弹性云服务器操作系统。

mode取值为withStopServer时，对开机状态的弹性云服务器执行切换操作系统操作，系统自动对云服务器先执行关机，再切换操作系统。

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服务器：

IyEvYmluL2Jhc2gKZWNobyB1c2VyX3Rlc3QgPiAvaG9tZS91c2VyLnR4dA==

Windows服务器：

cmVtIGNtZAplY2hvIDExMSA+IGM6XGFhYS50eHQ=

__system__encrypted

否

String

metadata中的表示加密功能的字段，0代表不加密，1代表加密。

该字段不存在时，系统盘默认为不加密。

__system__cmkid

否

String

用户主密钥ID，是metadata中的表示加密功能的字段，与__system__encrypted配合使用。

说明：

请参考查询密钥列表，通过HTTPS请求获取密钥ID。