将一台或多台云服务器的系统盘重置到初始状态。 被重置的云服务器必须处于运行( 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
}