ResetInstances
      更新时间:2025-11-03 11:03:08
    
    
    
    
    
    
    
    
      
        
        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
}