# 弹性云服务器
#### 解锁云服务器
弹性云服务器被解锁定后，将允许普通用户对云服务器执行管理操作。
- 输入参数 用户配置解锁云服务器执行动作，相关参数说明如[表1]所示。
   表1解锁云服务器输入参数说明 
  | 参数       | 必填 | 说明               |
  | 项目id     | 是  | 路径参数，project_id。 |
  |:---|:---|:---|
  | 解锁弹性云服务器 | 是  | 解锁弹性云服务器。        |
  | 云服务id    | 是  | 路径参数，server_id。  |
     
  - 输出参数 该执行动作无输出参数。
    
   
#### 锁定云服务器
租户可以锁定自己的弹性云服务器，不能锁定其他租户的云服务器。弹性云服务器被锁定后，租户将不能再对云服务器执行管理操作，包括生命周期管理，状态管理，网卡管理，磁盘管理，密码管理等。
- 输入参数 用户配置锁定云服务器执行动作，相关参数说明如[表2]所示。
   表2锁定云服务器输入参数说明 
  | 参数       | 必填 | 说明        |
  |:---|:---|:---|
  | 锁定弹性云服务器 | 是  | 锁定弹性云服务器。 |
     
  - 输出参数 该执行动作无输出参数。
    
   
#### 重启云服务器
重启单台云服务器。
- 输入参数 用户配置重启云服务器执行动作，相关参数说明如[表3]所示。
   表3重启云服务器输入参数说明 
  | 参数    | 必填 | 说明               |
  |:---|:---|:---|
  | 项目id  | 是  | 路径参数，project_id。 |
  | 云服务id | 是  | 路径参数，server_id。  |
  | 重启类型  | 否  | 重启类型。            |
     
  - 输出参数 该执行动作无输出参数。
    
   
#### 启动云服务器
启动单台云服务器。
- 输入参数 用户配置启动云服务器执行动作，相关参数说明如[表4]所示。
   表4启动云服务器输入参数说明 
  | 参数          | 必填 | 说明               |
  |:---|:---|:---|
  | 项目id        | 是  | 路径参数，project_id。 |
  | 云服务id       | 是  | 路径参数，server_id。  |
  | 标记为启动云服务器操作 | 是  | 标记为启动云服务器操作。     |
     
  - 输出参数 该执行动作无输出参数。
    
   
#### 关闭云服务器
关闭单台云服务器。
- 输入参数 用户配置启动云服务器执行动作，相关参数说明如[表5]所示。
   表5关闭云服务器输入参数说明 
  | 参数    | 必填 | 说明               |
  |:---|:---|:---|
  | 项目id  | 是  | 路径参数，project_id。 |
  | 云服务id | 是  | 路径参数，server_id。  |
  | 关机类型  | 否  | 关机类型，默认为SOFT。    |
     
  - 输出参数 该执行动作无输出参数。
    
   
#### 一键重置弹性云服务器密码(企业项目)
重置弹性云服务器管理账号（root用户或Administrator用户）的密码。默认无符合安全要求的密码复杂度检查，非安全密码输入后，无错误提示。使用此API，需预先安装重置密码插件。不能判断弹性云服务器是否支持重置密码。弹性云服务器的密码重置失败后，该API不会报错。弹性云服务器开机或重启后，新密码生效。
- 输入参数 用户配置一键重置弹性云服务器密码(企业项目)执行动作，相关参数说明如[表6]所示。
   表6一键重置弹性云服务器密码(企业项目)输入参数说明 
  | 参数         | 必填 | 说明                                                                                                                                                                                            |
  |:---|:---|:---|
  | 是否检查密码的复杂度 | 否  | 是否检查密码的复杂度，默认值为false。                                                                                                                                                                         |
  | 弹性云服务器新密码  | 是  | 该接口默认不做密码安全性校验；如需校验，请指定字段"is_check_password"为true。 新密码的校验规则： 长度为8-26位。 密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%\^-_=+\[{}\]:,./?）中的三种。 密码不能包含用户名或用户名的逆序。 Windows系统密码不能包含用户名或用户名的逆序，不能包含用户名中超过两个连续字符的部分。 |
  | 项目id       | 是  | 路径参数，project_id。                                                                                                                                                                              |
  | 云服务id      | 是  | 路径参数，server_id。                                                                                                                                                                               |
     
  - 输出参数 该执行动作无输出参数。
    
   
#### 查询云服务器详情列表
根据用户请求条件从数据库筛选，查询所有的弹性云服务器，并关联相关表获取到弹性云服务器的详细信息。支持查询弹性云服务器计费方式，以及是否被冻结。
- 输入参数 用户配置查询云服务器详情列表执行动作，相关参数说明如[表7]所示。
   表7查询云服务器详情列表输入参数说明 
  | 参数                  | 必填 | 说明                                                              |
  |:---|:---|:---|
  | 项目id                | 是  | 路径参数，project_id。                                                |
  | 企业项目id              | 否  | 查询绑定某个企业项目的弹性云服务器。 如果需要查询当前用户所有企业项目绑定的弹性云服务，请传参all_granted_eps。 |
  | 云服务器规格ID            | 否  | 已上线的规格请参见《弹性云服务器用户指南》的"实例和应用场景"章节。                              |
  | IPv4地址(模糊匹配)        | 否  | IPv4地址过滤结果，匹配规则为模糊匹配。                                           |
  | 查询返回云服务器当前页面的大小     | 否  | 查询返回云服务器当前页面的大小。每页默认值是25，最多返回1000台云服务器的信息。                      |
  | 云服务器名称              | 否  | 云服务器名称，匹配规则为模糊匹配。                                               |
  | 查询tag字段中不包含该值的云服务器  | 否  | 查询tag字段中不包含该值的云服务器。                                             |
  | 页码                  | 否  | 当前页面数，默认为1。取值大于等于0，取值为0时返回第1页。                                  |
  | 批量创建弹性云服务器时，指定返回的ID | 否  | 批量创建弹性云服务器时，指定返回的ID，用于查询本次批量创建的弹性云服务器。                          |
  | 云服务器状态              | 否  | 只有管理员可以使用"deleted"状态过滤查询已经删除的弹性云服务器。                            |
  | 查询tag字段中包含该值的云服务器   | 否  | 查询tag字段中包含该值的云服务器。                                              |
  | IPv4地址(精确匹配)        | 否  | IPv4地址过滤结果，匹配规则为精确匹配。                                           |
     
  
- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表8]。
   表8查询云服务器详情列表输出参数说明 
  | 参数         | 说明                         |
  |:---|:---|
  | 列表总数       | 弹性云服务器的列表总数。               |
  | 弹性云服务器详情列表 | 弹性云服务器详情列表，查询级别不同，返回的详情不同。 |
     
  
 
#### 获取VNC远程登录地址
获取弹性云服务器VNC远程登录地址。
- 输入参数 用户配置获取VNC远程登录地址执行动作，相关参数说明如[表9]所示。
   表9获取VNC远程登录地址输入参数说明 
  | 参数      | 必填 | 说明                         |
  |:---|:---|:---|
  | 项目id    | 是  | 路径参数，project_id。           |
  | 云服务id   | 是  | 路径参数，server_id。            |
  | 远程登录的类型 | 是  | 远程登录的类型，请将type配置为"novnc"。  |
  | 远程登录协议  | 是  | 远程登录协议，请将protocol配置为"vnc"。 |
     
  
- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表10]。
   表10获取VNC远程登录地址输出参数说明 
  | 参数             | 说明              |
  |:---|:---|
  | 弹性云服务器获取远程登录地址 | 弹性云服务器获取远程登录地址。 |
  | 远程登录的类型        | 远程登录的类型。        |
  | 远程登录的协议        | 远程登录的协议。        |
  | 远程登录的url       | 远程登录的url。       |