ResetInstances
将一台或多台云服务器的系统盘重置到初始状态。 被重置的云服务器必须处于运行( running )或关闭( stopped )状态。
重置只涉及系统盘数据,不包含云服务器所加载的硬盘。
Request Parameters
Parameter name | Type | Description | Required |
---|---|---|---|
instances.n | String | 一个或多个云服务器ID | Yes |
login_mode | String | 指定登录方式。当为 linux 云服务器时,有效值为 keypair 和 passwd; 当为 windows 云服务器时,只能选用 passwd 登录方式。 当登录方式为 keypair 时,需要指定 login_keypair 参数; 当登录方式为 passwd 时,需要指定 login_passwd 参数。 |
Yes |
login_keypair | String | 登录密钥ID。 | No |
login_passwd | String | 登录密码。 | No |
need_newsid | Integer | 1: 生成新的SID,0: 不生成新的SID, 默认为0;只对Windows类型云服务器有效。 | No |
zone | String | 区域 ID,注意要小写 | Yes |
Response Elements
Name | Type | Description |
---|---|---|
action | String | 响应动作 |
job_id | String | 执行任务的 Job ID |
ret_code | Integer | 执行成功与否,0 表示成功,其他值则为错误代码 |
Example
Example Request:
https://api.shanhe.com/iaas/?action=ResetInstances
&instances.1=i-rtyv0968
&zone=jn1a
&COMMON_PARAMS
Example Response:
{
"action":"ResetInstancesResponse",
"job_id":"j-ybnoeitr",
"ret_code":0
}