ResetInstances
更新时间:2024-12-20 09:01:21
PDF
将一台或多台云服务器的系统盘重置到初始状态。 被重置的云服务器必须处于运行( running )或关闭( stopped )状态。
重置只涉及系统盘数据,不包含云服务器所加载的硬盘。
请求参数
Parameter name | Type | Description | Required |
---|---|---|---|
instances.n |
String |
一个或多个云服务器ID |
Yes |
login_mode |
String |
指定登录方式。当为 linux 云服务器时,有效值为 keypair 和 passwd; 当为 windows 云服务器时,只能选用 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 |
除上述请求参数外,还包含公共参数。
返回数据
Name | Type | Description |
---|---|---|
action |
String |
响应动作 |
job_id |
String |
执行任务的 Job ID |
ret_code |
Integer |
执行成功与否,0 表示成功,其他值则为错误代码 |
请求示例
https://api.qingcloud.com/iaas/?action=ResetInstances
&instances.1=i-rtyv0968
&zone=pek3a
&COMMON_PARAMS
返回示例
{
"action":"ResetInstancesResponse",
"job_id":"j-ybnoeitr",
"ret_code":0
}