
# 变更云服务器规格（废弃）
#### 功能介绍
变更单台云服务器规格。
对于运行中的弹性云服务器，系统会自动关机，并将弹性云服务器中的数据拷贝到目标节点（目标节点可与源节点相同）后重新启动弹性云服务器。
底层资源不足时，该接口会自动回滚。
该接口不单独使用**，** 需要轮询判断虚拟机状态，当虚拟机同时满足"status"为"VERIFY_RESIZE"、"OS-EXT-STS:task_state"为""、"OS-EXT-STS:vm_state"为"RESIZED"时，配合"[确认变更云服务器云主机规格](https://support.huaweicloud.com/api-ecs/ecs_03_0309.html)（POST /v2.1/{project_id}/servers/{server_id}/action）"或"[回退变更云服务器云主机规格](https://support.huaweicloud.com/api-ecs/ecs_03_0310.html)（POST /v2.1/{project_id}/servers/{server_id}/action）"两个接口一起使用。
当前API已废弃，请使用[变更云服务器规格（按需） - ResizePostPaidServer](https://support.huaweicloud.com/api-ecs/ecs_02_0210.html)。
#### URI
POST /v2.1/{project_id}/servers/{server_id}/action
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 是否必选 | 描述                                                                                                                      |
|:---|:---|:---|
| project_id | 是    | 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ecs/ecs_01_0016.html)。 |
| server_id  | 是    | 云服务器ID。                                                                                                                 |
   
#### 请求消息
请求参数如[表2]所示。
 表2请求参数 
| 参数     | 是否必选 | 参数类型   | 描述                                                               |
|:---|:---|:---|:---|
| resize | 是    | Object | 云服务器规格变更，参考[表3]。 |
   
 表3resize参数信息 
| 参数        | 是否必选 | 参数类型   | 描述         |
|:---|:---|:---|:---|
| flavorRef | 是    | String | 新规格ID或URI。 |
   
#### 响应消息
无
#### 请求示例
变更指定云服务器的规格为"s3.medium.2"。
```
POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/action
{
    "resize" : {
        "flavorRef" : "s3.medium.2"
    }
}
```
#### 响应示例
无
#### 返回值
请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。
